@zhouhao4221/devflow-skills 0.2.0 → 0.3.1

package/plugins/pm/skills/pm/SKILL.md

@@ -0,0 +1,174 @@
+---
+name: pm
+description: |
+  项目管理助手 - 项目概况仪表盘和子命令入口
+---
+
+# 项目管理助手
+
+> **Audience:** Product Manager
+
+项目管理主入口，展示项目概况仪表盘，或路由到子命令。
+
+## 命令格式
+
+```
+/pm [子命令] [参数]
+```
+
+## 子命令
+
+| 子命令 | 说明 | 示例 |
+|-------|------|------|
+| (空) | 项目概况仪表盘 | `/pm` |
+| `weekly` | 周报 | `/pm:weekly` |
+| `monthly` | 月报 | `/pm:monthly` |
+| `milestone` | 里程碑总结 | `/pm:milestone v1.6.0` |
+| `stats` | 项目数据统计 | `/pm:stats` |
+| `progress` | 项目总进度 | `/pm:progress` |
+| `plan` | 生成方案文档 | `/pm:plan 排期方案` |
+| `risk` | 风险扫描 | `/pm:risk` |
+| `brief` | 项目简介 | `/pm:brief --lang=en` |
+| `standup` | 站会摘要 | `/pm:standup` |
+| `ask` | 自由提问 | `/pm:ask 还有几个需求没完成？` |
+| `export` | 导出上次内容 | `/pm:export --format=md` |
+| `help` | 使用帮助 | `/pm:help` |
+
+---
+
+## 执行流程（仪表盘模式）
+
+当不带子命令执行 `/pm` 时，展示项目概况仪表盘。
+
+### 1. 解析需求数据路径
+
+参考 `_common.md` 的路径解析规则。
+
+### 2. 采集数据
+
+并行采集以下数据：
+
+```python
+# 需求数据
+reqs = collect_requirements()
+
+# PRD 数据
+prd = collect_prd()
+
+# Git 数据（最近 30 天）
+git = collect_git_stats(from_date=thirty_days_ago)
+
+# 模块数据
+modules = collect_modules()
+
+# 插件版本
+version = read_plugin_json("version")  # <plugin-path>/.claude-plugin/plugin.json
+```
+
+### 3. 计算统计指标
+
+```python
+# 需求统计
+active_reqs = [r for r in reqs if not r["is_completed"]]
+completed_reqs = [r for r in reqs if r["is_completed"]]
+
+# 按状态分组
+status_groups = group_by(active_reqs, "status")
+
+# 完成率
+total = len(reqs)
+done = len(completed_reqs)
+completion_rate = f"{done}/{total}" if total > 0 else "暂无需求"
+
+# 本周完成
+this_week_done = [r for r in completed_reqs
+                  if r["updated"] >= this_monday()]
+
+# 风险项：超过 7 天未更新的活跃需求
+stale_reqs = [r for r in active_reqs
+              if days_since(r["updated"]) > 7]
+```
+
+### 4. 展示仪表盘
+
+```
+
+项目管理助手 v<version>
+
+项目：<project> (<role>) | 日期：YYYY-MM-DD
+
+
+**项目概览**
+需求总数：XX 个（活跃 XX / 已完成 XX）
+完成率：XX%
+本周完成：X 个
+PRD 完善度：X/X 章节
+
+**需求状态分布**
+草稿：X 个
+待评审：X 个
+评审通过：X 个
+开发中：X 个
+测试中：X 个
+已完成：X 个（总计）
+
+**近 30 天代码活动**
+提交次数：XX
+代码变更：+XXX / -XXX 行
+活跃分支：XX 个
+贡献者：XX 人
+
+关注项
+**严重** 超过 7 天未更新：REQ-XXX <标题>
+**警告** 阻塞中：REQ-XXX <标题>（原因）
+**提示** 即将完成：REQ-XXX <标题>（测试中）
+
+**模块概览**
+用户模块：X 个需求（X 活跃）
+订单模块：X 个需求（X 活跃）
+支付模块：X 个需求（X 活跃）
+
+
+
+**可用命令：**
+- /pm:weekly          生成本周周报
+- /pm:stats           查看详细统计
+- /pm:risk            风险扫描
+- /pm:progress        项目总进度
+- /pm:ask <问题>      自由提问
+- /pm:help            查看所有命令
+```
+
+### 5. 无数据时的提示
+
+```
+
+项目管理助手 v<version>
+
+
+未检测到需求数据
+
+可能原因：
+1. 尚未初始化需求项目 → /req:init <project-name>
+2. 尚未创建任何需求 → /req:new <标题>
+3. 未绑定需求项目 → /req:use <project-name>
+
+Git 仓库数据仍可使用：
+- /pm:stats   查看 Git 统计
+- /pm:ask     自由提问
+```
+
+---
+
+## 边界情况处理
+
+| 场景 | 处理方式 |
+|------|---------|
+| 无需求数据但有 Git 记录 | 仅展示 Git 相关指标，需求部分提示未初始化 |
+| 无 PRD | PRD 完善度显示「未创建」 |
+| readonly 仓库 | 从缓存读取数据，标注数据来源 |
+| 无 Git 仓库 | 跳过 Git 相关指标 |
+
+## 用户输入
+
+$ARGUMENTS

package/plugins/pm/skills/progress/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: progress
+description: |
+  项目总进度 - 全局视角展示需求进度和里程碑
+---
+
+# 项目总进度
+
+> **Audience:** Product Manager
+
+从全局视角展示所有需求的进度、里程碑节点和交付时间线。适合给上级看项目全貌。
+
+## 命令格式
+
+```
+/pm:progress [--save]
+```
+
+---
+
+## 执行流程
+
+### 1. 采集数据
+
+```python
+reqs = collect_requirements()
+prd = collect_prd()
+modules = collect_modules()
+git_tags = git_tags()  # 版本里程碑
+```
+
+### 2. 生成进度视图
+
+按以下维度组织：
+
+**2.1 总体进度**
+- 需求完成率（已完成/总数）
+- PRD 完善度
+- 版本发布历史（Tag 列表）
+
+**2.2 按模块进度**
+- 每个模块下的需求及其状态
+- 模块完成度百分比
+
+**2.3 需求时间线**
+- 按创建时间排列所有需求
+- 标注每个需求的当前状态和关键日期
+- 标注里程碑 Tag 的位置
+
+**2.4 甘特视图（文字版）**
+
+```
+需求时间线
+
+REQ-001 用户积分    80%  开发中
+REQ-002 积分前端    50%  开发中
+REQ-003 订单导出   100%  已完成
+REQ-004 消息通知    30%  测试中
+REQ-005 支付对账     0%  草稿
+
+整体进度：3/5 完成（60%）
+```
+
+### 3. 输出格式
+
+```
+
+项目总进度
+
+项目：<project> (<role>) | 日期：YYYY-MM-DD
+
+
+**总体进度**
+需求完成率：X/X（XX%）
+PRD 完善度：X/X 章节
+最新版本：vX.X.X（YYYY-MM-DD）
+版本数量：X 个
+
+**按模块进度**
+用户模块（X/X 完成，70%）
+  [完成] REQ-001 用户积分-后端
+  [开发中] REQ-002 用户积分-前端（60%）
+  [草稿] REQ-005 用户等级
+订单模块（X/X 完成，100%）
+  [完成] REQ-003 订单导出
+支付模块（X/X 完成，10%）
+    [草稿] REQ-006 支付对账
+
+**需求时间线**
+（甘特视图，见上方格式）
+
+**版本里程碑**
+v1.0.0（2026-01-15）- 首个版本
+v1.2.0（2026-02-20）- 订单模块
+v1.6.0（2026-03-18）- 积分系统
+
+
+
+**相关命令：**
+- /pm:risk             风险扫描
+- /pm:milestone <版本>  版本总结
+- /pm:stats            详细统计
+```
+
+### 4. 提供保存选项
+
+```python
+offer_save(content, f"docs/reports/progress/{today}.md")
+```
+
+## 用户输入
+
+$ARGUMENTS

package/plugins/pm/skills/report-generator/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: report-generator
+description: |
+  项目汇报生成助手。在执行 /pm:weekly、/pm:monthly、/pm:milestone、/pm:progress、
+  /pm:brief、/pm:standup 等生成类命令时触发。
+  负责将原始数据整合为结构化、可读性强的汇报文档。
+---
+
+# 项目汇报生成助手
+
+## 触发条件
+
+当执行以下 pm 插件命令时自动激活：
+- `/pm:weekly` - 周报
+- `/pm:monthly` - 月报
+- `/pm:milestone` - 里程碑报告
+- `/pm:progress` - 项目进度
+- `/pm:brief` - 项目简介
+- `/pm:standup` - 站会摘要
+- `/pm:plan` - 方案文档
+- `/pm:risk` - 风险报告
+
+## 核心职责
+
+将数据采集层提供的原始数据（需求列表、Git 统计、模块信息）整合为面向特定受众的结构化文档。
+
+## 工作流程
+
+### 1. 接收原始数据
+
+从命令执行流程中获取已采集的数据：
+- 需求元信息列表（状态、进度、日期）
+- Git 统计（提交数、变更量、贡献者）
+- PRD 信息（愿景、功能规划）
+- 模块信息（模块列表、需求分布）
+
+### 2. 数据整合分析
+
+**智能推导**：
+- 从需求状态变化推导「本周完成」和「进行中」
+- 从 Git 提交频率推导「工作量分布」
+- 从需求更新时间推导「风险项」（超 7 天未更新）
+- 从 completed/ 时间线推导「交付节奏」
+- 从提交消息中的 REQ-XXX 关联需求与代码变更
+
+**受众适配**：
+
+| 受众 | 语言风格 | 侧重点 |
+|------|---------|--------|
+| 上级/PMO | 业务语言，避免技术术语 | 交付成果、进度、风险 |
+| 客户 | 正式商务风格 | 功能交付、价值体现 |
+| 团队内部 | 技术语言，简洁直接 | 技术细节、阻塞点 |
+| 新人/外部 | 通俗易懂，有背景介绍 | 项目全貌、技术栈 |
+
+### 3. 内容生成原则
+
+1. **数据驱动**：每个结论必须有数据支撑，不凭空描述
+2. **突出业务价值**：描述「完成了用户积分兑换功能」而非「修改了 12 个文件」
+3. **风险透明**：不隐藏问题，明确标注阻塞项和延期风险
+4. **简洁有力**：避免冗长叙述，用表格和列表提升可读性
+5. **可操作性**：风险和计划部分给出明确的行动建议
+
+### 4. 格式规范
+
+**禁止使用 emoji**：所有输出不使用任何 emoji 图标，便于导出为 Word、PDF 等文档格式。
+使用加粗文字替代图标来标记重点和分类。
+
+#### 标题栏
+```
+═══════════════════════════════════════════════
+<文档标题>
+═══════════════════════════════════════════════
+项目：<project> | 周期/日期：<range>
+───────────────────────────────────────────────
+```
+
+#### 数据展示
+- 进度：用百分比展示（如 `60%`），不使用进度条字符
+- 状态标记：**完成** / **进行中** / **风险** / **阻塞**（纯文字加粗，不用 emoji）
+- 风险级别：**严重** / **警告** / **提示**（纯文字加粗）
+- 表格：结构化数据用 Markdown 表格
+- 树形：层级关系用 `├──` `└──`
+- 强调：用 `**加粗**` 标记分类标题和重点内容
+
+#### 尾部
+```
+═══════════════════════════════════════════════
+*由 /pm:<command> 自动生成 · YYYY-MM-DD*
+```
+
+### 5. 保存建议
+
+生成内容后，根据命令类型建议保存路径：
+
+| 命令 | 建议路径 |
+|------|---------|
+| weekly | `docs/reports/weekly/YYYY-MM-DD.md` |
+| monthly | `docs/reports/monthly/YYYY-MM.md` |
+| milestone | `docs/reports/milestone/<version>.md` |
+| progress | `docs/reports/progress/YYYY-MM-DD.md` |
+| plan | `docs/reports/plans/<主题>.md` |
+| risk | `docs/reports/risk/YYYY-MM-DD.md` |
+| brief | `docs/reports/brief.md` |
+| standup | 通常不保存（临时内容） |

package/plugins/pm/skills/risk/SKILL.md

@@ -0,0 +1,223 @@
+---
+name: risk
+description: |
+  风险扫描 - 自动检测项目中的延期、阻塞和异常情况
+---
+
+# 风险扫描
+
+> **Audience:** Product Manager
+
+自动扫描项目数据，识别延期需求、长期未更新分支、异常提交模式等风险信号。
+
+## 命令格式
+
+```
+/pm:risk [--save]
+```
+
+---
+
+## 执行流程
+
+### 1. 采集数据
+
+```python
+reqs = collect_requirements()
+git = collect_git_stats(from_date=thirty_days_ago)
+```
+
+### 2. 风险检测规则
+
+#### 2.1 需求层面
+
+```python
+risks = []
+
+for req in active_reqs:
+    days_inactive = days_since(req["updated"])
+
+    # 严重：超过 14 天未更新
+    if days_inactive > 14:
+        risks.append({
+            "level": "critical",
+            "type": "stale",
+            "req": req["id"],
+            "title": req["title"],
+            "detail": f"已 {days_inactive} 天未更新，状态停留在 {req['status']}",
+        })
+
+    # 警告：超过 7 天未更新
+    elif days_inactive > 7:
+        risks.append({
+            "level": "warning",
+            "type": "slow",
+            "req": req["id"],
+            "title": req["title"],
+            "detail": f"已 {days_inactive} 天未更新",
+        })
+
+    # 警告：草稿超过 5 天未进入评审
+    if req["status"] == "草稿" and days_since(req["created"]) > 5:
+        risks.append({
+            "level": "warning",
+            "type": "draft_stuck",
+            "req": req["id"],
+            "title": req["title"],
+            "detail": f"草稿已创建 {days_since(req['created'])} 天，建议尽快评审",
+        })
+
+    # 严重：开发中但功能进度为 0
+    if req["status"] == "开发中" and req["progress"] == "0/X":
+        risks.append({
+            "level": "critical",
+            "type": "no_progress",
+            "req": req["id"],
+            "title": req["title"],
+            "detail": "状态为开发中但功能进度为 0，可能被阻塞",
+        })
+```
+
+#### 2.2 代码层面
+
+```python
+# 警告：长期未合并的分支（超过 14 天）
+for branch in git["active_branches"]:
+    if branch.last_commit_days > 14 and not branch.is_merged:
+        risks.append({
+            "level": "warning",
+            "type": "stale_branch",
+            "detail": f"分支 {branch.name} 已 {branch.last_commit_days} 天无提交",
+        })
+
+# 警告：频繁修复同一文件（7 天内修复超过 3 次）
+hot_fix_files = find_frequently_fixed_files(days=7, threshold=3)
+for file in hot_fix_files:
+    risks.append({
+        "level": "warning",
+        "type": "hot_file",
+        "detail": f"{file.path} 近 7 天有 {file.fix_count} 次修复提交",
+    })
+
+# 提示：提交频率异常下降
+if git["this_week_commits"] < git["avg_weekly_commits"] * 0.3:
+    risks.append({
+        "level": "info",
+        "type": "low_activity",
+        "detail": f"本周提交 {git['this_week_commits']} 次，低于平均 {git['avg_weekly_commits']} 次",
+    })
+```
+
+#### 2.3 流程层面
+
+```python
+# 警告：有需求跳过评审直接开发
+for req in reqs:
+    if req["type"].startswith("REQ") and req["status"] == "开发中":
+        if not has_review_record(req):
+            risks.append({
+                "level": "warning",
+                "type": "skip_review",
+                "req": req["id"],
+                "detail": "未找到评审记录，可能跳过了评审环节",
+            })
+```
+
+### 3. 输出风险报告
+
+```
+
+项目风险扫描
+
+项目：<project> | 扫描日期：YYYY-MM-DD
+
+
+**风险概览**
+**严重**：X 项
+**警告**：X 项
+**提示**：X 项
+总计：X 项风险
+
+
+
+**严重**
+
+  1. REQ-003 订单导出 — 停滞 18 天
+     状态：开发中（功能进度 2/6）
+     最后更新：2026-03-08
+     建议：确认是否被阻塞，考虑拆分或重新排期
+
+  2. REQ-007 消息通知 — 开发中无进度
+     状态：开发中（功能进度 0/5）
+     进入开发：2026-03-20
+     建议：确认是否遇到技术障碍
+
+
+
+**警告**
+
+  3. REQ-008 支付对账 — 草稿滞留 8 天
+     创建日期：2026-03-18
+     建议：尽快安排评审或调整优先级
+
+  4. 分支 feat/REQ-003-order-export — 16 天无提交
+     最后提交：2026-03-10
+     建议：确认分支状态，考虑是否需要关闭
+
+  5. internal/oms/biz/order_biz.go — 频繁修复
+     近 7 天有 4 次 fix 提交
+     建议：检查该模块是否需要重构
+
+
+
+**提示**
+
+  6. 本周提交活动偏低
+     本周提交 5 次，周均 23 次
+     可能原因：节假日、会议集中、需求评审阶段
+
+
+
+**建议操作：**
+- /pm:stats --from=2026-03-01  查看本月详细统计
+- /req:status REQ-003          查看停滞需求详情
+- /pm:weekly                   生成周报梳理进展
+```
+
+### 4. 提供保存选项
+
+```python
+offer_save(content, f"docs/reports/risk/{today}.md")
+```
+
+---
+
+## 风险级别定义
+
+| 级别 | 含义 | 典型场景 |
+|------|------|---------|
+| **严重** | 需要立即关注 | 需求停滞 14+ 天、开发中无进度 |
+| **警告** | 需要近期处理 | 7+ 天未更新、草稿滞留、分支过期 |
+| **提示** | 值得留意 | 活动量下降、代码热点 |
+
+## 无风险时
+
+```
+
+项目风险扫描 -- 一切正常
+
+项目：<project> | 扫描日期：YYYY-MM-DD
+
+未检测到风险项。项目运行健康。
+
+**健康指标：**
+活跃需求均有近期更新
+无过期分支
+提交频率正常
+无频繁修复热点
+
+```
+
+## 用户输入
+
+$ARGUMENTS

package/plugins/pm/skills/standup/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: standup
+description: |
+  站会摘要 - 昨天完成、今天计划、阻塞项
+---
+
+# 站会摘要
+
+> **Audience:** Product Manager
+
+生成简洁的每日站会汇报内容：昨天做了什么、今天要做什么、有什么阻塞。
+
+## 命令格式
+
+```
+/pm:standup
+```
+
+---
+
+## 执行流程
+
+### 1. 采集数据
+
+```python
+yesterday = today - timedelta(days=1)
+# 如果昨天是周末，回溯到上周五
+if yesterday.weekday() >= 5:
+    yesterday = yesterday - timedelta(days=yesterday.weekday() - 4)
+```
+
+```bash
+# 昨天的提交
+git log --oneline --no-merges --since='$YESTERDAY' --until='$TODAY'
+
+# 昨天变更的需求（通过文件修改时间或 git 记录）
+git log --name-only --no-merges --since='$YESTERDAY' --until='$TODAY' --pretty=format: | \
+  grep -E 'requirements/(active|completed)/' | sort -u
+```
+
+```python
+# 当前进行中的需求
+in_progress = [r for r in reqs if r["status"] in ["开发中", "测试中"]]
+
+# 阻塞项
+blocked = [r for r in in_progress if days_since(r["updated"]) > 3]
+```
+
+### 2. 输出站会摘要
+
+```
+
+站会摘要 · YYYY-MM-DD
+
+
+**昨日完成：**
+- feat: 完成订单导出模板引擎 (REQ-006)
+- fix: 修复分页查询参数丢失
+- test: 补充积分兑换单元测试
+
+**今日计划：**
+- REQ-006 订单导出：实现异步导出队列
+- REQ-007 消息通知：跑回归测试
+
+**阻塞/风险：**
+- REQ-006 依赖第三方 SDK 版本确认（等待中）
+
+
+```
+
+**特点：**
+- 极简风格，不展示统计数据
+- 聚焦行动：做了什么、要做什么、卡在哪
+- 通常不保存（临时内容）
+
+### 3. 无昨日活动时
+
+```
+
+站会摘要 · YYYY-MM-DD
+
+
+**昨日完成：**
+  （无提交记录）
+
+**今日计划：**
+- REQ-006 订单导出：继续开发（进度 60%）
+
+**阻塞/风险：**
+  （无）
+
+```
+
+## 用户输入
+
+$ARGUMENTS