关于 cadre
cadre 通过逐项提问并检查项目资料,帮助团队撰写或扩展 `docs/PRD.md`。它依照固定模板整理问题、解决方案、目标用户、用户故事和验收标准,并支持逐节确认。
主要功能
- 01检查现有 PRD 与项目资料
- 02逐个提出需求澄清问题
- 03按模板组织 PRD 内容
- 04支持逐节审阅和修订
- 05写入 `docs/PRD.md`
适用场景
- 01从产品简报起草 PRD
- 02更新已有 PRD 中的需求变更
- 03明确用户故事与成功标准
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ naiersaidane/ claude-mastery --skill cadre安装后在 Claude Code 中输入/cadre确认已加载。
详细介绍
通过提问,引导用户根据下方模板编写或扩展 docs/PRD.md。
流程
-
如有必要,探索仓库以了解现有背景(
CLAUDE.md、ADR、业务术语表、相关代码)。在 PRD 中沿用项目词汇,并遵循已确定的架构决策。如果仓库中已有问题答案,应先探索,而不是提问。 -
如果存在
docs/PRD.md,请先阅读。结合收到的 brief,只针对差异提问。指出矛盾:« 你之前确定了 X,而 brief 暗示 Y,我们保留哪一个? »。既没有 PRD 也没有 brief 时,第一个问题应是 « 你想明确什么? »。 -
每次只问一个问题,并给出有理由的建议。按依赖关系推进:问题 → 目标用户 → 解决方案 → 标准 → 范围外。用户故事和实现决策贯穿各部分逐步形成。转到下一部分前,询问 « 补充备注中有什么内容:风险、依赖项、假设? »。
-
每个部分都能完整撰写后,用一句话宣布,并在聊天中根据模板写出完整 PRD。此时根据其他回答归纳用户故事,并请用户确认。
-
用户逐部分确认或修改。收到修改后,只重新发布受影响的部分。全部确认后,写入
docs/PRD.md(必要时创建docs/),并确认 « ✓ 已写入docs/PRD.md»。
问题
用户所经历的情况:挫折、背景、“为何现在”。使用第三人称行文,不要用 我。
解决方案
从用户角度阐述产品方向:产品让用户能够做什么,而不是如何构建。
目标用户
用户画像与使用背景应足够具体,以便想象出一个真实的人。
用户故事
按编号列出全部用户故事,格式为 « 作为 <角色>,我想要 <功能>,以便 <收益> »。涵盖主要交互、空状态、错误、替代流程和边界情况。
成功标准
可直接验证的标准:可观察事件(点击、生成文件、收到邮件)或客观指标(时长、数量、阈值)。不要采用关于内在行为的判断(如“理解了 X”“识别出 Y”)。
范围外
明确拒绝纳入的内容。应列举完整,以避免过度设计。
实现决策
用户可见的产品行为(数值限制、空状态、显示格式、UX 选择、外形规格、错误)。不要涉及内部技术细节(算法、公式、环境变量、库名称、技术类别)。思考标准:如果用户无法在使用中观察到差异,则应排除。
补充备注
兜底部分:风险、外部依赖、假设、参考资料、未来事项。保持简短;如果没有内容,写 « 无需补充。 »。
规则
- 词汇 = 用户原话,逐字沿用。
- PRD 中不得出现技术名称、遗漏项、文件路径或代码片段。
- 用户故事必须编号:US-1、US-2……