使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/promptdriven/pdd --skill pdd-product开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
PDD product
Start with the person's product request. Find or make its product issue, for example gh issue create --title "Product: coffee pickup" --body "<the request>", then run pdd workflow run product ISSUE. This workflow makes and tracks the plan. Normal feature runs build the parts.
- map: steps/understand.md, steps/map.md → gate: approve
- plan: steps/parts.md, steps/contracts.md, steps/plan.md → gate: pr
Rules
- Read pdd-prompting before writing Stories or contracts (
1Story per cohesive standalone user loop). Keep one coupled slice in 1 session (0 authoring subagents) and checkpdd files+pdd lint --local; across independent decoupled modules, lock shared contracts first and parallelize independent workers. - The person approves the map, then reviews the plan PR. Never decide their open questions or approve for them. Never merge.
- Size the plan by architecture boundaries rather than fixed Story counts: for a single cohesive part, keep
product/map.mdonly and run one feature run; for multiple decoupled parts, define parts, shared contracts and planned runs; for broad cross-part rollouts, also define vertical slices where slice 1 is one thin end-to-end journey through the parts. The person can change the path. - Keep the plan in repo files. Use the file formats. A product piece is a part; an area is a workflow phase.
- Keep each planned run scoped to one cohesive part or contract boundary; warn without refusing when a planned run mixes unrelated parts.
- Parts share contracts, not code. Feature tests use the other parts as fakes from those contracts. Contract changes go through a plan PR.
- Parallel runs are optional. After the plan PR, show
pdd product nextand let the person start runs in parallel or in order. - In a run, use
pdd workflow done STEP --summary "one line"andpdd workflow ask "question". Write notes in the run folder. Keep receipts and logs outside the repo.