prd-feature

编写、检查和验收细则分别见 references/compose.md、references/inspect.md、references/validate.md。

目的

为 artifact-graph 项目的 PRD 功能特性制品提供编写、审阅和修复的统一入口。根据用户意图路由到对应的子流程，确保 PRD 制品从起草到终态的完整闭环。

路由决策树

根据用户意图选择进入点：

路由到 author

• 用户要求"编写""起草""新建""创建"PRD 功能特性
• 用户提供了业务目标或需求描述，需要从零产出制品
• 项目尚无对应 PRD 制品，需要初始化

路由到 review

• 用户要求"审阅""检查""审查""评估"已有 PRD 制品
• 用户提供了现有 PRD 文件路径或 ID
• author 流程完成后的质量验收

路由到 repair

• review 产生了 findings 需要修复
• 用户明确要求"修复""修正""改进"某个 PRD 制品
• 前一轮 review 输出了 repair_entry 建议

流程闭环规则

一旦进入子流程，该流程必须自行完成闭环。上层规划器不得另拆 review/repair 步骤：

1. author 流程：inspect → compose → validate → review。若 review 产生 findings，进入 repair → re-review 循环，直至终态 verdict（pass/warning/BLOCKED/NEEDS_INPUT）。
2. review 流程：inspect → review。若存在可修 findings 且非只读模式，进入 repair → re-review 循环直至终态；若只读审阅或用户明确禁止修改，输出 findings 与 repair_entry 后终止，并明确受用户约束。
3. repair 流程：基于 review 的 findings 修复 → re-review 确认终态（或 BLOCKED/NEEDS_INPUT）。

输出契约

默认入口输出

路由结果必须包含：

• target_flow：author | review | repair
• reason：路由理由（一句话）
• artifact_id：目标制品 ID（若已知）
• artifact_path：目标制品路径（若已知）

子流程输出

各子流程遵循各自的输出契约，详见：

• author/SKILL.md：author 输出契约
• review/SKILL.md：review 输出契约（含 machine-readable verdict/findings）
• repair/SKILL.md：repair 输出契约（含 re-review 终态）

制品规范来源

先从目标项目的 artifact-graph.config.yaml、项目模板、artifacts/README.md、AGENTS.md/CLAUDE.md 和已有同类制品派生路径、ID、frontmatter、状态与章节要求。插件不覆盖项目规范；仅在项目没有明示规则时补充 PRD 的通用质量维度：业务目标清晰、验收标准可验证、关键约束可追溯。

技能协作边界

• 本技能族只处理 PRD 功能特性制品，不处理场景剧本、设计文档或其他类型
• author 闭环包含 review 步骤，不依赖上层规划器拆出 review
• repair 必须基于 review 的 findings 执行，不凭空修改
• 修复后必须 re-review 确认终态，不跳过终态验证