Menu
将 PRD 文档转换为 prd.json 格式，用于故事循环执行器逐故事执行。触发词：转换 prd、转 json、create prd.json、prd 转 json。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
PRD 规范性校验器。用于检查 PRD 文档是否符合规范要求。触发词：检查prd、校验prd、prd规范检查。
生成产品需求文档（PRD）。用于规划功能、启动新项目。触发词：创建prd、写prd、规划功能、产品需求文档。
PRD 生成与校验流水线。自动执行 生成→校验→修正→复检 的循环流程，输出符合规范的 PRD。触发词：生成prd流水线、prd pipeline、创建高质量prd。
故事执行器（子代理指令）。每次执行一个用户故事，通过文件系统传递上下文。触发词：执行故事、实施PRD、开始开发。
故事循环执行器。读取prd-[功能名称].json，按依赖顺序循环调度子代理逐个执行用户故事，直到全部完成。触发词：执行故事循环、开始执行故事、自动执行故事。
| name | koi-prd-convert-to-json |
| description | 将 PRD 文档转换为 prd.json 格式，用于故事循环执行器逐故事执行。触发词：转换 prd、转 json、create prd.json、prd 转 json。 |
| user-invocable | true |
将已有的 PRD（Markdown 格式）转换为 prd.json 格式，供故事循环执行器逐个用户故事执行。
prd-context/prd-files/prd-[功能名称].md）prd-context/prd-files/prd-[功能名称].json 文件重要：
branchName 不同，先归档旧文件。{
"project": "[项目名称]",
"branchName": "prd/[feature-name-kebab-case]",
"description": "[功能描述，取自PRD标题/概述]",
"techStack": {
"appType": "[应用类型]",
"frontend": "[前端技术栈]",
"backend": "[后端技术栈]",
"database": "[数据库]",
"buildTool": "[构建工具]",
"stateManagement": "[状态管理]",
"other": "[其他技术栈]"
},
"userStories": [
{
"id": "US-001",
"title": "[故事标题]",
"description": "As a [用户角色], I want [功能] so that [收益]",
"acceptanceCriteria": [
"验收标准1",
"验收标准2",
"代码通过编译/类型检查/lint检查无错误"
],
"priority": 1,
"dependencies": [],
"type": "scaffold",
"passes": false,
"notes": ""
}
]
}
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
project | string | 是 | 项目名称，取自 PRD 标题 |
branchName | string | 是 | Git 分支名，格式 prd/[feature-kebab-case] |
description | string | 是 | 功能描述，取自 PRD 概述的第一段 |
techStack | object | 否 | 技术栈信息，从 PRD 的技术栈章节提取 |
techStack.appType | string | 否 | 应用类型（Web/移动/桌面/嵌入式/其他） |
techStack.frontend | string | 否 | 前端技术栈 |
techStack.backend | string | 否 | 后端技术栈 |
techStack.database | string | 否 | 数据库 |
techStack.buildTool | string | 否 | 构建工具 |
techStack.stateManagement | string | 否 | 状态管理 |
techStack.other | string | 否 | 其他技术栈信息 |
userStories | array | 是 | 用户故事数组 |
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | 故事编号，格式 US-XXX（三位数字） |
title | string | 是 | 故事标题 |
description | string | 是 | 用户故事描述 |
acceptanceCriteria | string[] | 是 | 验收标准数组 |
priority | number | 是 | 优先级数字（1, 2, 3...） |
dependencies | string[] | 是 | 依赖的故事 ID 数组 |
type | string | 是 | scaffold / backend / frontend / fullstack |
passes | boolean | 是 | 初始值 false |
notes | string | 是 | 初始值空字符串 |
| 类型 | 适用场景 |
|---|---|
scaffold | 项目初始化、数据库表设计、框架搭建 |
backend | 后端接口实现、服务层逻辑 |
frontend | 前端页面、UI 组件 |
fullstack | 同时涉及前后端变更的故事 |
每个故事必须能在一次 AI 会话内完成。不能用 2-3 句话描述完的变更，说明故事太大需要拆分。
按依赖顺序：scaffold → backend → frontend → fullstack。前面的故事不能依赖后面的故事。
写入新 prd-[功能名称].json 前，检查已有同名文件的 branchName 是否不同，不同则归档到 archive/ 目录。