如何用Pilot Shell的/prd把模糊想法变成PRD：完整工作流教程

如何用Pilot Shell的/prd把模糊想法变成PRD完整工作流教程【免费下载链接】pilot-shellHow real engineers run Claude Code and Codex: spec-driven planning, enforced TDD, persistent memory, and quality enforcement on all levels. Make your agents production-ready.项目地址: https://gitcode.com/GitHub_Trending/cl/pilot-shellPilot Shell 是面向 Claude Code 和 Codex 的工程化工作流框架它的/prd 命令能把你脑子里一句模糊的想做点什么通过 8 步对话式流程变成一份结构完整、可直接交付实现的产品需求文档PRD。本教程带你完整走一遍这个工作流理解想法、可选调研、头脑风暴、结构化澄清、方案对比、范围收敛、撰写 PRD最后平滑交接给 /spec 进入实现。无需写代码全程对话即可完成。为什么需要 /prd想法和实现之间缺什么直接用 AI 编码助手写功能最常见的失败不是写不出来而是写错了方向——需求没对齐、范围无限膨胀、关键假设没人挑战。Pilot Shell 的 orchestrator.md 把 /prd 定义为一个战略思考伙伴它不照单全收你的点子而是逐层追问、挑战假设、暴露权衡最终产出一份给 /spec 直接消费的需求契约。它的硬规则是PRD 未获你批准之前禁止进入任何实现动作。/prd在整个工作流中的位置/prd写清 WHAT 和 WHY → /spec规划并实现 HOW → 质量验证 /prd写清 WHAT 和 WHY → /build命名目标自主循环达标工作流总览8 步流程一图看懂完整流程定义在 manifest.json 中共 8 个步骤阶段步骤作用是否可选1Understand复述想法、扫描项目上下文、识别核心问题必选2Research市场与技术调研Quick / Standard / Deep 三档可选3Ideate发散头脑风暴抛出 3-5 个方向供你挑选想法模糊时4Clarify结构化表单提问补齐目标/用户/约束/成功标准必选5Propose给出 2-3 个实现方案 推荐项你来选必选6Converge明确做什么 明确不做什么划定范围边界必选7Write PRD生成标准格式 PRD 文件自检后交你审阅必选8Hand off打印交接命令由你手动执行 /spec 或 /build必选整个流程的交互预算目标是2-4 次用户交互——问得少而准是这套工作流的核心设计。步骤详解从一句话到一份 PRD第 1 步理解想法Understand详见 steps/01-understand.md。Agent 会先用自己的话复述你的想法确认理解无误然后扫描项目上下文代码结构、文档、最近提交。关键动作是范围检查如果你的点子横跨多个独立子系统比如做一个带聊天、存储、计费的平台它会当场叫停帮你拆分成多个子项目先选一个来写 PRD其余排队——避免在注定要拆的项目上浪费整轮流程。第 2 步按需调研Research对应 steps/02-research.md提供三档强度按你的想法多需要外部事实来选择Quick推荐用于简单想法跳过网络调研直接进头脑风暴或澄清Standard会话内轻量调研 5-10 次搜索——竞品、既有方案、最佳实践、UX 模式Deep多智能体深度调研多角度并行搜索 来源交叉验证产出带引用的报告token 成本更高调研结果会作为Research Findings章节嵌入最终 PRD让需求决策有据可依。第 3 步发散头脑风暴Ideate当你的输入是问题陈述而非解决方案比如用户注册后流失严重时steps/03-ideate.md 会进入自由对话模式Agent 抛出3-5 个截然不同的方向不是同一想法的换皮变体你反应它对你选的方向压力测试哪里会崩成本多少隐含了什么假设通常1-3 轮收敛信号是你的回答从不但是…变成对而且…如果你的想法已经足够具体加一个 Google OAuth 登录这一步直接跳过——别在已经做完的决策上假发散。第 4 步结构化澄清Clarify对应 steps/04-clarify.md。问题以结构化表单呈现每题 2-4 个带权衡的选项只问代码回答不了的问题目的、受益用户、时间线约束、成功标准、范围边界。这里有一条代码优先原则凡是代码库里已经写明的事实现有模式、现有架构Agent 自己去读代码不问你。澄清通常 3-6 个问题就停拿到 90% 的规格即止。第 5 步方案对比Proposesteps/05-propose.md 中Agent 给出2-3 个具体实现方案每个包含短名称、2-3 句工作机制、用 X 换 Y式权衡描述并明确标注推荐项及理由。你选定方案后才继续——PRD 不替你做产品决策。第 6 步范围收敛Convergesteps/06-converge.md 是整个流程中防范围蔓延最关键的一步。它不只记录你要什么还会主动提议砍掉什么Agent 会对照检查清单移动端SSO历史版本导入导出计费把实现者很可能默认要做但其实不该做的能力逐条列为 Explicitly Out of Scope每条附一句理由。目标是 2-6 条针对本功能的真实边界而不是No mobile app这种套话。第 7 步写出 PRDWrite PRD对应 steps/07-write-prd.md。PRD 保存到docs/prd/YYYY-MM-DD-slug.md包含五个标准章节Problem Statement什么问题、给谁、为什么是现在北极星Core User Flows用户视角的核心流程逐步展开ScopeIn Scope 的具体交付物 Explicitly Out of Scope 及原因Technical Context既有架构、约束、相关文件——注意它只描述现状不预先规定实现方式那是 /spec 的活Key Decisions对话中每个决策的决定 | 选择 | 为什么表格写完先做 4 点自检占位符残留、内部一致性、范围是否聚焦、歧义然后停下来让你亲自打开文件通读你提的修改直接用编辑改在文件上而不是一遍遍重写。第 8 步交接Hand offsteps/08-handoff.md 是唯一的终点确认。你批准后 Agent 会打印但绝不自动执行交接命令PRD saved to docs/prd/2026-08-30-customization-packs.md To start implementation planning, run: /spec Implement 一句话总结 — PRD: docs/prd/2026-08-30-customization-packs.md — see PRD for full requirementsPRD 重心是待实现的有序需求清单就走/spec重心是要达到的质量标准就走/build。命令必须由你亲手敲这是 Pilot Shell 的全局规则——人永远握有放行权。交接之后PRD 如何驱动实现/spec拿到 PRD 后进入 spec-driven 流程解析需求 → 生成带任务的实施计划 → TDD 实现 → 验证。你可以在 Console 的 Specifications 页面实时跟踪任务进度从 0 到 N 逐条打勾直至 Verified。最佳实践清单从问题陈述开始不急着给方案——用户注册后流失比加个引导页能引出更好的 PRD⚡想法够具体就跳过 Ideate 和 Standard 调研选 Quick 档直奔澄清省时省 token认真回答第 6 步的范围提议你砍掉的每一条都是未来防蔓延的护栏一定亲自通读生成的 PRD 文件第 7 步的阅读环节是设计的兜底比多问一个问题更便宜大型想法主动拆分一个 PRD 对应一个/spec计划这是刻意的边界快速上手安装与首次运行Pilot Shell 支持 macOS、LinuxWindows 通过 WSL2安装通常不超过 2 分钟。克隆仓库git clone https://gitcode.com/GitHub_Trending/cl/pilot-shell按仓库 README.md 中的指引完成安装后在任意项目里启动 Claude Code 或 Codex输入/prd 我想给我们的工具加一个团队协作功能还说不太清楚要哪些能力然后跟着 8 步流程走2-4 次交互后你就有一份存好的 PRD。完整命令清单见 pilot/skills/ 目录其中 pilot/skills/spec/ 是 PRD 之后接手的规划与实现技能。一句话总结/prd 把模糊想法 → 可交接的需求这条最易出错的路变成了有节奏、有护栏、有产出的 8 步流水线——想清楚 WHAT 和 WHY把 HOW 放心地交给 /spec。【免费下载链接】pilot-shellHow real engineers run Claude Code and Codex: spec-driven planning, enforced TDD, persistent memory, and quality enforcement on all levels. Make your agents production-ready.项目地址: https://gitcode.com/GitHub_Trending/cl/pilot-shell创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考