메뉴
PRD 生成与校验流水线。自动执行 生成→校验→修正→复检 的循环流程，输出符合规范的 PRD。触发词：生成prd流水线、prd pipeline、创建高质量prd。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
PRD 规范性校验器。用于检查 PRD 文档是否符合规范要求。触发词：检查prd、校验prd、prd规范检查。
将 PRD 文档转换为 prd.json 格式，用于故事循环执行器逐故事执行。触发词：转换 prd、转 json、create prd.json、prd 转 json。
生成产品需求文档（PRD）。用于规划功能、启动新项目。触发词：创建prd、写prd、规划功能、产品需求文档。
故事执行器（子代理指令）。每次执行一个用户故事，通过文件系统传递上下文。触发词：执行故事、实施PRD、开始开发。
故事循环执行器。读取prd-[功能名称].json，按依赖顺序循环调度子代理逐个执行用户故事，直到全部完成。触发词：执行故事循环、开始执行故事、自动执行故事。
| name | koi-prd-pipeline |
| description | PRD 生成与校验流水线。自动执行 生成→校验→修正→复检 的循环流程，输出符合规范的 PRD。触发词：生成prd流水线、prd pipeline、创建高质量prd。 |
| user-invocable | true |
编排 koi-prd-generator 和 koi-prd-checker 两个技能，通过循环执行实现 PRD 质量的持续改进，直到输出符合规范的最终 PRD。
本技能是编排层（Orchestrator），不直接生成或检查 PRD，而是通过 Task 工具启动独立子代理来调度以下两个执行层技能：
在执行 pipeline 之前，首先询问用户技术栈选择：
请选择后端技术栈：
请选择前端技术栈：
请选择数据库：
请选择缓存：
请选择消息队列：
请选择搜索引擎：
请选择构建工具：
请选择部署方式：
请选择移动平台：
请选择开发框架：
请选择状态管理：
请选择网络请求：
请选择本地存储：
请选择构建工具：
请选择部署方式：
请选择桌面平台：
请选择开发框架：
请选择状态管理：
请选择本地存储：
请选择构建工具：
请选择部署方式：
请选择硬件平台：
请选择操作系统：
请选择开发语言：
请选择通信协议：
请选择构建工具：
请选择部署方式：
请描述应用类型和技术栈：
用户输入（用户故事/功能描述）
↓
技术栈询问
↓
循环（最多 3 轮）
├── ① 启动 generator 子代理
│ ├── 第 1 轮：生成初始 PRD
│ └── 第 2/3 轮：根据 checker 反馈修正 PRD
├── ② 启动 checker 子代理
│ ├── 按 11 项标准逐项校验
│ └── 输出校验报告（通过/不通过 + 不符合项详情）
└── ③ 判断是否终止
├── ✅ checker 返回"通过" → 跳出循环，输出最终结果
├── ❌ checker 返回"不通过" 且未达 3 轮 → 继续循环
└── ❌ checker 返回"不通过" 且已达 3 轮 → 跳出循环
↓
输出最终 PRD + 校验报告
| 轮次 | 阶段 | 说明 |
|---|---|---|
| 第 1 轮 | generator → checker | 生成初稿，首次校验 |
| 第 2 轮 | generator → checker | 针对不符合项修正，复检 |
| 第 3 轮 | generator → checker | 修复残余问题，终检 |
最多 3 轮，不可超过。 3 轮后无论结果如何都必须终止。
每轮循环中，checker 的输出必须作为下一轮 generator 的输入：
checker 输出（不符合项详情） → generator 输入（修正依据）
具体传递方式：
按优先级排列：
| 问题级别 | 定义 | 处理方式 |
|---|---|---|
| P0（必须修复） | 影响实施的关键问题（如缺少章节、用户故事颗粒度严重过大） | 必须在循环内修复 |
| P1（强烈建议） | 影响效率的问题（如技术栈模糊、目标不可衡量） | 必须在循环内修复 |
| P2（可选优化） | 最佳实践建议（如小版本号缺失、措辞优化） | 允许保留，不影响最终通过判定 |
最终判定标准： PRD 无 P0 和 P1 问题即可视为通过。存在 P2 问题不影响输出。
⚠️ 重要：本技能的所有生成和校验工作必须通过 Task 工具启动独立子代理完成，编排者（主对话）不得自己直接生成或校验 PRD。
使用 Task 工具，参数如下：
subagent_type: "general_purpose_task"description: "生成/修正PRD"（第1轮）或 "修正PRD"（第2/3轮）response_language: 与用户输入语言一致query: 按以下模板填写第1轮（生成）query 模板：
先调用 Skill('koi-prd-generator') 加载生成器指令，然后基于以下输入生成PRD并保存到 prd-context/prd-files/ 目录。用户故事：{用户故事内容}。补充说明：{补充说明内容}。如果需要澄清问题，直接根据补充说明中的信息做出合理假设，不要中断等待用户回复。
第2/3轮（修正）query 模板：
先调用 Skill('koi-prd-generator') 加载生成器指令，然后修正已有PRD文件 {PRD文件路径}。以下是校验反馈的不符合项，请逐一修正：{checker不符合项详情}。修正后保存到原文件路径。
使用 Task 工具，参数如下：
subagent_type: "general_purpose_task"description: "校验PRD规范"response_language: 与用户输入语言一致query: 按以下模板填写query 模板：
先调用 Skill('koi-prd-checker') 加载校验器指令，然后校验PRD文件 {PRD文件路径} 的规范性。按11项标准逐项检查，输出完整的校验报告（包含检查结果汇总表、不符合项详情、总结和改进优先级）。最终必须在报告末尾明确给出"校验结果：✅ 通过"或"校验结果：❌ 不通过"的结论。
子代理是独立进程，看不到主对话历史。因此：
本技能接收以下输入：
[as a]...[i want]...[so that]...prd-context/prd-files/prd-[功能名称].md## Pipeline 执行摘要
- **总循环轮数：** X / 3
- **最终状态：** ✅ 通过 / ⚠️ 存在残留问题
### 各轮次记录
| 轮次 | generator 操作 | checker 结果 | 修复的问题 |
|------|---------------|-------------|-----------|
| 1 | 生成初始 PRD | 发现 X 项不符合 | — |
| 2 | 修正 PRD | 发现 X 项不符合 | 修复了 XXX |
| 3 | 修正 PRD | ✅ 通过 | 修复了 XXX |
### 残留问题（如有）
- [P2] XXX（可选优化，不影响使用）
| 异常场景 | 处理方式 |
|---|---|
| generator 生成的 PRD 格式严重错误（无法被 checker 解析） | 终止循环，提示用户检查输入是否清晰 |
| checker 连续 3 轮报告相同问题（修正无效） | 终止循环，输出当前 PRD + 校验报告，提示用户手动介入 |
| 用户在循环过程中提供新需求 | 将新需求追加到 generator 的输入中，继续当前循环 |
| prd-context/ 目录创建失败 | 提示用户手动创建目录后重试 |
| 子代理执行超时或失败 | 重试一次，仍失败则终止循环并提示用户 |
用户：帮我为预审记录管理系统生成 PRD，用户故事是 [as a]预审记录操作服务 [i want]对预审记录进行新增、查询、编辑、删除 [so that]实现预审数据规范化管理
Pipeline 执行：
【第 1 轮】
→ 启动 generator 子代理：生成初始 PRD（22 个用户故事）
→ 启动 checker 子代理：发现 3 项不符合（颗粒度、技术栈、目标量化）
→ 结果：❌ 不通过，继续
【第 2 轮】
→ 启动 generator 子代理：传入 checker 的 3 项不符合详情，修正 PRD
→ 启动 checker 子代理：发现 0 项不符合
→ 结果：✅ 通过，终止
输出：
- PRD 文件：prd-context/prd-files/prd-pre-review-management.md
- 校验报告：11/11 项通过
- 执行摘要：2 轮完成，所有问题已修复
prd-pipeline（本技能，编排层 — 由主对话执行）
├── Task(general_purpose_task) → 执行 koi-prd-generator（独立子代理）
└── Task(general_purpose_task) → 执行 koi-prd-checker（独立子代理）
本技能不替代 koi-prd-generator 或 koi-prd-checker，用户仍可单独调用它们。 本技能的价值在于通过独立子代理实现真正的生成-校验分离，确保 PRD 输出质量。