| name | koi-prd-convert-to-json |
| description | 将 PRD 文档转换为 prd.json 格式，用于故事循环执行器逐故事执行。触发词：转换 prd、转 json、create prd.json、prd 转 json。 |
| user-invocable | true |
Koi PRD 转 JSON 技能
将已有的 PRD（Markdown 格式）转换为 prd.json 格式，供故事循环执行器逐个用户故事执行。
工作内容
- 读取已有的 PRD Markdown 文件（从
prd-context/prd-files/prd-[功能名称].md）
- 解析其中的用户故事、验收标准、依赖关系等信息
- 按照标准 prd.json 格式规范进行转换
- 保存为
prd-context/prd-files/prd-[功能名称].json 文件
重要：
- 不要开始实施代码，只做格式转换。
- 转换前先检查是否已存在 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 | 是 | 用户故事数组 |
userStories 数组元素
| 字段 | 类型 | 必填 | 说明 |
|---|
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 | 是 | 初始值空字符串 |
type 字段取值规则
| 类型 | 适用场景 |
|---|
scaffold | 项目初始化、数据库表设计、框架搭建 |
backend | 后端接口实现、服务层逻辑 |
frontend | 前端页面、UI 组件 |
fullstack | 同时涉及前后端变更的故事 |
故事大小规则
每个故事必须能在一次 AI 会话内完成。不能用 2-3 句话描述完的变更，说明故事太大需要拆分。
故事排序
按依赖顺序：scaffold → backend → frontend → fullstack。前面的故事不能依赖后面的故事。
验收标准规则
- 所有故事必须包含"代码通过编译/类型检查/lint检查无错误"
- 前端故事还应包含"在浏览器中验证页面功能和样式"
- 每条标准必须可验证，不能模糊
转换规则
- PRD 中的 US-XXX 编号直接保留，priority 按编号顺序
- 描述从 PRD 提取，移除（技术故事）标注，格式化为 As a [角色], I want [功能] so that [收益]
- 验收标准从 - [ ] 列表提取，移除复选框标记
- 依赖从 PRD 提取，解析为字符串数组
- 类型根据标题/描述推断
- branchName 保持 prd/ 前缀不变
- 技术栈信息从 PRD 的技术栈章节提取，包括应用类型、前端、后端、数据库、构建工具、状态管理等
归档机制
写入新 prd-[功能名称].json 前，检查已有同名文件的 branchName 是否不同，不同则归档到 archive/ 目录。
转换前检查清单
