@zhouhao4221/devflow-skills 0.2.0 → 0.3.1

package/plugins/req/skills/prd/SKILL.md

@@ -0,0 +1,187 @@
+---
+name: prd
+description: |
+  查看 PRD 状态 - 产品需求文档概览和章节填充分析
+---
+
+# 查看 PRD 状态
+
+查看产品需求文档（PRD）的填充情况、各章节完成度、需求追踪统计。
+
+> **Audience:** Product Manager
+> 存储路径规则见 [_storage.md](./_storage.md)
+
+## 命令格式
+
+```
+/req:prd [--section=章节名]
+```
+
+**示例：**
+- `/req:prd` — 查看 PRD 整体状态概览
+- `/req:prd --section=概述` — 查看指定章节详情
+- `/req:prd --section=功能需求` — 查看功能需求章节
+
+---
+
+## 执行流程
+
+### 1. 解析存储路径（按角色）
+
+读取 `.claude/settings.local.json` 的 `requirementProject` 和 `requirementRole`，按角色确定 PRD 路径：
+- `readonly`：`~/.claude-requirements/projects/$PROJECT/PRD.md`
+- `primary`：`docs/requirements/PRD.md`，本地不存在时回退到缓存
+- 未绑定：`docs/requirements/PRD.md`
+
+### 2. 检查 PRD 存在性
+
+如果 PRD.md 不存在：
+
+```
+❌ 未找到 PRD 文档
+
+可用操作：
+- /req:init <project-name>  初始化项目（自动生成 PRD）
+```
+
+### 3. 读取 PRD 模板（作为基准）
+
+```
+优先级：
+1. 本地模板：docs/requirements/templates/prd-template.md
+2. 插件模板：<plugin-path>/templates/prd-template.md
+```
+
+**两个路径都不存在时，终止操作**：
+```
+❌ 未找到 PRD 模板文件，无法进行章节比对
+
+请执行 /req:update-template prd 恢复模板
+```
+
+将模板中各章节的占位文本作为「未填写」的判断基准。
+
+### 4. 分析各章节填充状态
+
+逐章节比对 PRD 内容与模板占位文本：
+
+**判断逻辑**：
+- 章节内容与模板完全一致（仅变量替换差异） → 未填写
+- 章节内容有实质性修改（非变量替换差异） → 已填写
+- 第 9 章「需求追踪」单独处理 → 解析表格统计
+
+**需要比对的章节**：
+
+| 编号 | 章节名 | 子章节 |
+|------|--------|--------|
+| 1 | 概述 | 背景与问题、产品愿景、目标与成功指标、范围定义 |
+| 2 | 用户研究 | 目标用户、用户旅程、竞品分析 |
+| 3 | 功能需求 | 功能概览、功能详情 |
+| 4 | 非功能需求 | 性能、可用性、安全、兼容性 |
+| 5 | 数据需求 | 数据模型、数据采集、数据报表 |
+| 6 | 技术方案 | 系统架构、第三方依赖、接口设计 |
+| 7 | 发布计划 | 版本规划、里程碑、灰度策略 |
+| 8 | 风险管理 | 风险识别、依赖项、假设与约束 |
+| 9 | 需求追踪 | （自动维护，统计需求数量和状态） |
+| 10 | 附录 | 术语表、参考资料、相关文档 |
+
+### 5. 统计需求追踪（第 9 章）
+
+解析「需求追踪」表格，按状态（草稿/待评审/评审通过/开发中/测试中/已完成）逐行统计数量并求总计。
+
+### 6. 输出概览报告
+
+```
+
+PRD 状态：<project-name>
+
+
+基本信息
+产品名称：<product-name>
+文档版本：v1.0
+最后更新：2026-01-08
+数据来源：本地 (primary)
+状态：草稿
+
+章节填充情况（N/10 已填写）
+
+| 章节 | 状态 | 说明 |
+|------|------|------|
+| 1. 概述 | ✅ 已填写 | 背景、愿景、目标已完善 |
+| 2. 用户研究 | ❌ 未填写 | 保持模板占位 |
+| 3. 功能需求 | ✅ 已填写 | N 个功能模块 |
+| 4. 非功能需求 | ❌ 未填写 | 保持模板占位 |
+| 5. 数据需求 | ❌ 未填写 | 保持模板占位 |
+| 6. 技术方案 | ✅ 已填写 | 架构已确定 |
+| 7. 发布计划 | ❌ 未填写 | 保持模板占位 |
+| 8. 风险管理 | ❌ 未填写 | 保持模板占位 |
+| 9. 需求追踪 | 自动维护 | N 个需求 |
+| 10. 附录 | ❌ 未填写 | 保持模板占位 |
+
+需求追踪统计
+总计：N 个需求
+草稿：X
+待评审：X
+✅ 评审通过：X
+开发中：X
+测试中：X
+已完成：X
+
+建议优先填写：
+- <优先级最高的未填写章节及理由>
+
+可用操作：
+- /req:prd-edit             编辑 PRD
+- /req:prd --section=概述    查看指定章节详情
+```
+
+**建议优先填写的逻辑**：
+- 有需求但「功能需求」未填写 → 优先建议
+- 「概述」未填写 → 优先建议（基础信息）
+- 「技术方案」未填写 → 其次建议
+- 其他章节按编号顺序建议
+
+---
+
+## --section 模式
+
+指定章节名时，输出该章节的完整内容：
+
+```
+/req:prd --section=功能需求
+```
+
+输出：
+```
+
+PRD 章节详情：3. 功能需求
+
+
+状态：✅ 已填写
+
+--- 章节内容 ---
+
+### 3.1 功能概览
+
+| 优先级 | 功能模块 | 功能描述 | 用户价值 | MVP |
+|-------|---------|---------|---------|-----|
+| P0 | 用户积分 | 积分规则管理 | 激励用户活跃 | 是 |
+| P1 | 积分兑换 | 积分兑换商品 | 提升用户粘性 | 否 |
+
+### 3.2 功能详情
+...
+
+--- 章节内容结束 ---
+
+可用操作：
+- /req:prd-edit 功能需求   编辑此章节
+- /req:prd                返回概览
+```
+
+章节名支持模糊匹配：`概述`、`用户`、`功能`、`非功能`、`数据`、`技术`、`发布`、`风险`、`追踪`、`附录`。
+
+---
+
+## 用户输入
+
+$ARGUMENTS

package/plugins/req/skills/prd-analyzer/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: prd-analyzer
+description: |
+  PRD 分析助手。仅在执行 /req:prd-edit 命令时触发。帮助完善产品需求文档。
+---
+
+# PRD 分析助手
+
+仅在编辑 PRD 时激活，辅助用户填写和完善各章节内容。
+
+## 分析框架
+
+按章节提供不同的 AI 辅助方式。
+
+### 1. 概述（第 1 章）
+
+引导填写：
+- **背景与问题**：当前痛点、市场机会
+- **产品愿景**：一句话核心价值主张
+- **目标与成功指标**：可衡量的业务/用户/技术目标
+- **范围定义**：明确 In Scope 和 Out of Scope
+
+### 2. 用户研究（第 2 章）
+
+引导填写：
+- **目标用户**：用户角色、特征、核心痛点
+- **用户旅程**：完成核心任务的完整流程
+- **竞品分析**：竞品优劣势和差异化
+
+**AI 反推**：从已有 REQ 的「使用场景」中提取用户角色和痛点。
+
+### 3. 功能需求（第 3 章）
+
+引导填写：
+- **功能概览**：按优先级列出功能模块
+- **功能详情**：用户故事、流程、规则、验收标准
+
+**AI 反推**：从已有 REQ 的「功能清单」中归纳功能模块，按模块分组，推导优先级。
+
+### 4. 非功能需求（第 4 章）
+
+引导填写：
+- **性能需求**：响应时间、并发、数据量
+- **可用性需求**：SLA、RTO、RPO
+- **安全需求**：认证、授权、数据安全
+- **兼容性需求**：浏览器、设备、分辨率
+
+**AI 建议**：根据技术选型和业务场景建议合理指标。
+
+### 5. 数据需求（第 5 章）
+
+引导填写：
+- **数据模型**：核心实体及关系
+- **数据采集**：埋点、日志
+- **数据报表**：维度、指标、频率
+
+**AI 反推**：从已有 REQ 的「数据模型」章节汇总核心实体。
+
+### 6. 技术方案（第 6 章）
+
+引导填写：
+- **系统架构**：前后端技术栈、基础设施
+- **第三方依赖**：外部服务和备选方案
+- **接口设计**：关键 API 列表
+
+**AI 反推**：从已有 REQ 的「实现方案」中提取技术栈、框架、数据库信息。
+
+### 7. 发布计划（第 7 章）
+
+引导填写：
+- **版本规划**：MVP / v1.0 / 迭代计划
+- **里程碑**：关键时间节点
+- **灰度策略**：发布计划
+
+**AI 反推**：根据已有需求的状态和时间线，建议里程碑规划。
+
+### 8. 风险管理（第 8 章）
+
+引导填写：
+- **风险识别**：技术/业务/资源风险
+- **依赖项**：内外部依赖及状态
+- **假设与约束**：前提条件
+
+**AI 反推**：从已有 REQ 的「关联信息」中识别依赖关系和潜在风险。
+
+### 9. 附录（第 10 章）
+
+引导填写：
+- **术语表**：领域术语定义
+- **参考资料**：文档链接
+- **相关文档**：原型、技术方案、测试用例
+
+## AI 智能补充模式
+
+当用户选择「AI 智能补充」时，执行全量分析：
+
+### 数据采集
+
+1. 扫描 `docs/requirements/active/` 下所有 REQ 和 QUICK 文档
+2. 扫描 `docs/requirements/completed/` 下所有已完成文档
+3. 扫描 `docs/requirements/modules/` 下所有模块文档
+4. 读取当前 PRD 内容，识别已填写和未填写章节
+
+### 分析策略
+
+- **未填写章节**：生成完整建议内容
+- **已填写章节**：对比需求文档，识别缺漏，生成补充建议
+- **无数据来源的章节**：标注为「需要用户手动填写」，不猜测
+
+### 输出要求
+
+- 建议内容必须有明确的数据来源（标注来自哪些 REQ）
+- 区分「确定性内容」（可从需求直接提取）和「建议性内容」（AI 推断）
+- 用户可逐章节确认或跳过
+
+## 输出要求
+
+### 格式约束（强制）
+
+编辑 PRD 内容时，**必须严格遵循模板格式**：
+
+1. **先读取模板**：优先 `docs/requirements/templates/prd-template.md`，其次 `<plugin-path>/templates/prd-template.md`
+   - **两个路径都不存在时，终止操作**，提示用户执行 `/req:update-template prd` 恢复模板
+2. **章节结构不可变**：不得新增、删除、合并或重命名模板中的章节
+3. **层级标题不可变**：章节标题、编号必须与模板完全一致
+4. **表格格式不可变**：表格的列名、列数必须与模板一致
+5. **保留空章节**：未涉及的章节保留模板占位文本，不得删除
+6. **仅填充内容**：在模板对应章节的占位文本处填充实际内容
+7. **第 9 章禁止修改**：「需求追踪」由命令自动维护
+
+内容完整可执行。

package/plugins/req/skills/prd-edit/SKILL.md

@@ -0,0 +1,201 @@
+---
+name: prd-edit
+description: |
+  编辑 PRD - 修改和完善产品需求文档
+---
+
+# 编辑 PRD
+
+AI 辅助分析和修改产品需求文档（PRD），支持按章节编辑和从现有需求反推内容。
+
+> **Audience:** Product Manager
+> 存储路径和缓存同步规则见 [_storage.md](./_storage.md)
+
+## 命令格式
+
+```
+/req:prd-edit [章节名或编号]
+```
+
+**示例：**
+- `/req:prd-edit` — 交互选择章节
+- `/req:prd-edit 功能需求` — 直接编辑指定章节
+- `/req:prd-edit 3` — 按编号编辑
+- `/req:prd-edit 1,3,6` — 编辑多个章节
+
+---
+
+## 执行流程
+
+### 1. 权限检查
+
+读取 `settings.local.json` 的 `requirementRole`；若为 `readonly` 则报错退出，提示在主仓库执行。
+
+### 2. 读取 PRD 文档和模板
+
+检查 `docs/requirements/PRD.md` 是否存在，不存在则提示先执行 `/req:init`。
+
+**必须先读取模板**作为格式基准：
+```
+优先级：
+1. 本地模板：docs/requirements/templates/prd-template.md
+2. 插件模板：<plugin-path>/templates/prd-template.md
+```
+
+**两个路径都不存在时，终止操作**：
+```
+❌ 未找到 PRD 模板文件
+
+请执行 /req:update-template prd 恢复模板
+```
+
+### 3. 选择编辑章节
+
+如果未通过参数指定章节，交互选择：
+
+```
+请选择要编辑的章节：
+
+ 1. 概述（背景、愿景、目标、范围）
+ 2. 用户研究（目标用户、用户旅程、竞品）
+ 3. 功能需求（功能概览、功能详情）
+ 4. 非功能需求（性能、可用性、安全、兼容）
+ 5. 数据需求（数据模型、采集、报表）
+ 6. 技术方案（架构、依赖、接口）
+ 7. 发布计划（版本、里程碑、灰度）
+ 8. 风险管理（风险、依赖、假设）
+10. 附录（术语、参考、文档）
+
+ a. AI 智能补充（基于现有需求反推）
+
+请输入编号（可多选，如 1,3,6）：
+```
+
+**注意**：
+- 第 9 章「需求追踪」不可手动编辑，由 `/req:new` 和 `/req:done` 自动维护
+- 「修订历史」和「审批记录」不在选择列表中，修订历史由命令自动更新
+- 章节名支持模糊匹配：`概述`、`用户`、`功能`、`非功能`、`数据`、`技术`、`发布`、`风险`、`附录`
+
+### 4. 交互式编辑
+
+对于用户选择的每个章节：
+
+1. **展示当前内容**：
+   - 已填写 → 展示实际内容
+   - 未填写 → 标注「当前为模板占位文本」
+2. **接收用户输入**：用户描述修改意图或直接提供内容
+3. **AI 辅助补充**：基于用户输入，AI 补充和优化内容（触发 `prd-analyzer` 技能）
+
+**格式约束（强制）：**
+- 仅修改用户选择的章节内容，不得改变章节结构
+- 章节标题、编号、层级必须与模板完全一致
+- 不得新增、删除、合并或重命名模板中的章节
+- 表格结构（列名、列数）必须与模板一致
+- 即使某章节内容为空或占位文本，也不得删除该章节
+- 第 9 章「需求追踪」禁止修改
+
+### 5. AI 智能补充模式
+
+当用户选择 `a`（AI 智能补充）时：
+
+**数据采集**：
+
+扫描 `docs/requirements/active/` 和 `completed/` 下的所有 REQ-*.md、QUICK-*.md，以及 `modules/*.md`。
+
+**反推逻辑**：
+
+| PRD 章节 | 数据来源 | 反推方式 |
+|---------|---------|---------|
+| 功能需求 | REQ 的「功能清单」 | 按模块归纳功能点，推导优先级 |
+| 技术方案 | REQ 的「实现方案」 | 提取技术栈、架构模式、数据库 |
+| 数据需求 | REQ 的「数据模型」 | 汇总核心实体和关系 |
+| 用户研究 | REQ 的「使用场景」 | 提取用户角色和核心痛点 |
+| 发布计划 | REQ 的状态和时间线 | 根据已完成/进行中需求推断里程碑 |
+| 风险管理 | REQ 的「关联信息」 | 从依赖关系识别风险点 |
+
+**输出格式**：
+```
+AI 智能分析完成
+
+基于 X 个需求文档和 Y 个模块文档，建议更新以下章节：
+
+【3. 功能需求】（当前未填写 → 建议填写）
+  从 5 个 REQ 中归纳出 3 个功能模块...
+
+【6. 技术方案】（当前已填写 → 建议补充）
+  从实现方案中发现新增的技术依赖...
+
+【5. 数据需求】（当前未填写 → 建议填写）
+  从 3 个 REQ 的数据模型中汇总出 5 个核心实体...
+
+```
+
+展示具体建议后写入。
+
+### 6. 变更预览
+
+修改内容写入文档前，向用户展示变更摘要：
+
+```
+变更预览
+
+【将修改的章节】：
+- 3. 功能需求：新增 3 个功能模块概览
+- 6. 技术方案：补充后端框架和数据库选型
+
+【未修改的章节】：
+- 1. 概述、2. 用户研究、4. 非功能需求...（保持不变）
+
+【自动更新】：
+- 修订历史：追加 v1.1 记录
+- 最后更新日期：更新为今日
+```
+
+> 只修改用户明确要求的章节，严禁擅自修改其他章节内容。
+
+### 7. 更新修订历史
+
+自动在修订历史表追加记录：
+
+```markdown
+| v1.X | YYYY-MM-DD | | 更新章节：功能需求、技术方案 |
+```
+
+版本号规则：读取当前最大版本号，小版本 +1。
+
+### 8. 更新元信息
+
+更新元信息表中的「最后更新」字段为当前日期。
+
+### 9. 保存并同步缓存
+
+- 写入本地文件 `docs/requirements/PRD.md`
+- **同步到全局缓存**（通过 PostToolUse Hook 自动触发）
+
+### 10. 输出结果
+
+```
+✅ PRD 已更新
+路径：docs/requirements/PRD.md
+修改章节：功能需求、技术方案
+版本：v1.0 → v1.1
+缓存：已同步
+
+下一步：
+- /req:prd            查看 PRD 状态
+- /req:prd-edit       继续编辑其他章节
+- /req:new <标题>     从 PRD 派生具体需求
+```
+
+---
+
+## 注意事项
+
+- 编辑不会影响已有需求文档
+- 第 9 章「需求追踪」由命令自动维护，不可手动编辑
+- 所有变更都会记录到修订历史
+- readonly 仓库不可编辑 PRD
+
+## 用户输入
+
+$ARGUMENTS

package/plugins/req/skills/projects/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: projects
+description: |
+  列出所有需求项目 - 查看全局缓存中的所有项目
+---
+
+# 列出所有需求项目
+
+显示全局缓存中所有项目的概览。
+
+## 命令格式
+
+```
+/req:projects
+```
+
+---
+
+## 执行流程
+
+### 1. 检查全局缓存
+
+检查 `~/.claude-requirements/projects/` 是否存在且非空。
+
+**如果缓存不存在或为空**：
+```
+暂无需求项目
+
+使用 /req:init <project-name> 创建第一个项目
+```
+
+### 2. 读取全局索引
+
+读取 `~/.claude-requirements/index.json` 获取各项目的元信息和关联仓库列表。
+
+### 3. 扫描每个项目
+
+对每个项目收集：
+- 活跃需求数量
+- 已完成需求数量
+- 关联的仓库列表
+- 创建时间
+
+### 4. 获取当前仓库绑定
+
+读取当前仓库的 `.claude/settings.local.json` 中的 `requirementProject`
+
+### 5. 输出项目列表
+
+```
+需求项目列表
+
+| 项目 | 活跃 | 已完成 | 关联仓库 | 创建时间 |
+|------|------|--------|---------|---------|
+| my-saas-product | 3 | 12 | 2 | 2026-01-01 |
+| internal-tools | 1 | 5 | 1 | 2026-01-05 |
+| client-portal | 0 | 0 | 0 | 2026-01-08 |
+
+= 当前仓库绑定的项目
+
+缓存路径: ~/.claude-requirements/
+
+可用命令:
+   - /req:use <project>   切换到指定项目
+   - /req:init <project>  创建新项目
+```
+
+---
+
+## 详细模式
+
+```
+/req:projects --detail
+```
+
+显示每个项目的详细信息：
+
+```
+需求项目列表
+
+
+my-saas-product (当前项目)
+
+   创建时间: 2026-01-01
+   路径: ~/.claude-requirements/projects/my-saas-product/
+
+   需求统计:
+      - 开发中: 1
+      - 待评审: 1
+      - 草稿: 1
+      - ✅ 已完成: 12
+
+   关联仓库:
+      - /Users/xxx/backend
+      - /Users/xxx/frontend
+
+
+internal-tools
+
+   创建时间: 2026-01-05
+   路径: ~/.claude-requirements/projects/internal-tools/
+
+   需求统计:
+      - 开发中: 1
+      - ✅ 已完成: 5
+
+   关联仓库:
+      - /Users/xxx/tools
+```
+
+---
+
+## 用户输入
+
+$ARGUMENTS

package/plugins/req/skills/quick-fix-guide/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: quick-fix-guide
+description: |
+  快速修复引导助手。在执行 /req new-quick 或讨论"小bug"、"简单修复"、
+  "快速改一下"、"小功能"时触发。快速分析问题并生成简洁实现方案。
+---
+
+# 快速修复助手
+
+快速分析问题，生成简洁可执行的实现方案。
+
+## 分析流程
+
+1. **理解问题** - 错误信息、现象 vs 根因、影响范围
+2. **定位代码** - 报错堆栈、功能模块、关键字搜索
+3. **分析实现** - 当前逻辑、问题环节、最小改动
+4. **生成方案** - 文件、改动、验证方式
+
+## 方案评估
+
+| 检查项 | 快速修复标准 | 超出时 |
+|-------|------------|-------|
+| 文件数量 | ≤5 个 | 升级为正式需求 |
+| 代码行数 | ≤100 行 | 考虑拆分 |
+| 数据库变更 | 无 | 升级为正式需求 |
+| 新增API | 无 | 升级为正式需求 |
+| 影响范围 | 单一功能 | 评估风险 |
+
+## 输出格式
+
+```
+🔍 问题分析
+[1-2句话说明问题根因]
+
+💡 实现方案
+1. 文件：path/to/file.go
+   改动：[具体改动内容]
+
+📏 改动量：小/中（约 XX 行）
+
+✅ 验证方式
+[如何验证修复成功]
+```
+
+## 完成标准
+
+- [ ] 问题已解决/功能已实现
+- [ ] 代码符合项目规范
+- [ ] 简单自测通过
+
+**原则：快速、简洁、聚焦**