@zhouhao4221/devflow-skills 0.2.0 → 0.3.1

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

@@ -0,0 +1,158 @@
+---
+name: stats
+description: |
+  项目数据统计 - 需求、代码、贡献者等多维度统计分析
+---
+
+# 项目数据统计
+
+> **Audience:** Product Manager
+
+生成项目多维度统计数据，包括需求进度、代码活动、贡献者分布等。
+
+## 命令格式
+
+```
+/pm:stats [--from=YYYY-MM-DD] [--to=YYYY-MM-DD] [--save]
+```
+
+**参数说明：**
+- `--from`：可选，统计起始日期，默认项目首次提交
+- `--to`：可选，统计截止日期，默认今天
+- `--save`：可选，直接保存不询问
+
+**示例：**
+- `/pm:stats` — 全量统计
+- `/pm:stats --from=2026-03-01` — 本月统计
+- `/pm:stats --from=2026-03-01 --to=2026-03-26` — 指定范围
+
+---
+
+## 执行流程
+
+### 1. 解析参数和路径
+
+```python
+from_date, to_date = parse_date_range(args.from, args.to, default_range="all")
+# 解析需求数据路径（参考 _common.md）
+```
+
+### 2. 采集数据
+
+#### 2.1 需求数据
+
+读取所有需求文档，统计：总数、进行中/已完成分布、按状态/类型/模块/优先级分布、按月完成吞吐量、平均生命周期（创建到完成的天数）。
+
+#### 2.2 Git 数据
+
+从 git log（时间范围内，不含 merge commit）提取：提交总数、按作者分布、按日期趋势、按 conventional commit 类型分布、代码增删行数、变更频率最高的文件 TOP 10、活跃分支数、tag 数量。
+
+#### 2.3 代码规模（可选，当前快照）
+
+统计主要源码文件（`.go`、`.ts`、`.vue`、`.py`、`.java` 等）的文件数和总行数，排除 `node_modules`、`vendor`、`dist` 等目录。
+
+### 3. 输出统计报告
+
+```
+
+项目数据统计
+
+项目：<project> (<role>)
+统计范围：<from> ~ <to>
+
+
+**需求统计**
+总数：XX 个
+活跃：XX 个 | 已完成：XX 个
+完成率：XX%
+平均生命周期：XX 天
+
+  按状态分布：
+  草稿       XX XX% 
+  待评审     XX XX% 
+  评审通过   XX XX% 
+  开发中     XX XX% 
+  测试中     XX XX% 
+  已完成     XX XX% 
+
+  按类型分布：
+  后端 XX XX% 
+  前端 XX XX% 
+  全栈 XX XX% 
+
+  按模块分布：
+  用户模块 XX XX% 
+  订单模块 XX XX% 
+  支付模块 XX XX% 
+
+  月度吞吐量（已完成需求数）：
+  2026-01 X 
+  2026-02 X 
+  2026-03 X 
+
+
+
+**代码活动统计**
+提交总数：XX
+代码变更：+XX,XXX / -X,XXX 行
+变更文件：XX 个
+活跃分支：XX 个
+版本标签：XX 个
+
+  按贡献者：
+  张三 XX XX% 
+  李四 XX XX% 
+  王五 XX XX% 
+
+  按提交类型：
+  feat     XX XX% 新功能
+  fix      XX XX% 修复
+  refactor XX XX% 重构
+  docs     XX XX% 文档
+  other    XX XX% 其他
+
+  变更最多的文件 TOP 5：
+  1. path/to/file.go     XX 次 
+  2. path/to/file2.go    XX 次 
+  3. path/to/file3.ts    XX 次 
+  4. path/to/file4.go    XX 次 
+  5. path/to/file5.vue   XX 次 
+
+  每周提交趋势：
+  第 1 周 (03/01-03/07) XX 
+  第 2 周 (03/08-03/14) XX 
+  第 3 周 (03/15-03/21) XX 
+  第 4 周 (03/22-03/26) XX 
+
+
+
+**代码规模（当前）**
+源代码文件：XX 个
+代码行数：~XX,XXX 行
+
+
+
+**相关命令：**
+- /pm:weekly            生成周报
+- /pm:risk              风险扫描
+- /pm:stats --from=<日期>  指定起始时间
+```
+
+### 4. 提供保存选项
+
+询问是否保存到 `docs/reports/stats/<today>.md`。
+
+---
+
+## 无数据处理
+
+| 场景 | 处理方式 |
+|------|---------|
+| 无需求数据 | 跳过需求统计章节，仅展示 Git 和代码数据 |
+| 无 Git 记录 | 跳过代码活动章节 |
+| 指定范围内无数据 | 提示范围内无活动，建议调整范围 |
+| 无代码文件 | 跳过代码规模章节 |
+
+## 用户输入
+
+$ARGUMENTS

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

@@ -0,0 +1,157 @@
+---
+name: weekly
+description: |
+  周报 - 基于项目数据自动生成本周工作汇报
+---
+
+# 生成周报
+
+> **Audience:** Product Manager
+
+从需求文档和 Git 记录自动提取本周工作内容，生成结构化周报。
+
+## 命令格式
+
+```
+/pm:weekly [--from=YYYY-MM-DD] [--to=YYYY-MM-DD] [--save]
+```
+
+**参数说明：**
+- `--from`：可选，周报起始日期，默认本周一
+- `--to`：可选，周报截止日期，默认今天
+- `--save`：可选，直接保存不询问
+
+**示例：**
+- `/pm:weekly` — 本周周报
+- `/pm:weekly --from=2026-03-17 --to=2026-03-21` — 上周周报
+
+---
+
+## 执行流程
+
+### 1. 确定时间范围
+
+```python
+from_date, to_date = parse_date_range(args.from, args.to, default_range="week")
+# 默认：本周一 ~ 今天
+```
+
+### 2. 采集本周数据
+
+#### 2.1 需求变动
+
+读取所有需求文档，按更新日期筛选出：本周完成的需求、本周新创建的需求、本周有进展（状态变化）的需求、当前进行中的需求（开发中 / 测试中）。
+
+#### 2.2 Git 提交
+
+从 git log（时间范围内，不含 merge commit）提取：提交列表、代码增删行数、贡献者分布、按 conventional commit 类型分布、本周合并的分支。
+
+#### 2.3 从提交消息提取关联需求
+
+扫描本周提交消息，提取其中出现的 `REQ-XXX` / `QUICK-XXX` 编号，关联到对应需求文档。
+
+### 3. AI 整合分析
+
+将采集到的原始数据交给 AI 整合，生成以下内容：
+
+**分析要求：**
+1. **本周完成**：列出实际完成的需求和关键提交，突出业务价值
+2. **进行中工作**：描述当前进展，标注完成进度百分比
+3. **关键数据**：从 Git 统计中提取有意义的指标
+4. **风险与阻塞**：识别超期需求、长期未更新分支、频繁修复的文件
+5. **下周计划**：根据当前活跃需求的状态推导下周重点
+
+### 4. 输出周报
+
+```
+
+项目周报
+
+项目：<project> | 周期：<from> ~ <to>
+
+
+## 本周完成
+
+- **REQ-005 用户积分兑换**
+  - 完成全部开发和测试，已合并到主分支（3/22）
+  - 包含 12 个提交，涉及 8 个文件
+  - 关键功能：积分兑换规则引擎、兑换记录查询、兑换限额校验
+
+- **QUICK-003 修复登录超时问题**
+  - 修复 token 刷新逻辑中的竞态条件（3/20）
+  - 影响文件：auth/token_refresh.go
+
+## 进行中
+
+- **REQ-006 订单导出功能** — 开发中（60%）
+  - 本周完成：导出模板引擎、CSV/Excel 格式支持
+  - 待完成：异步导出队列、大文件分片下载
+  - 分支：feat/REQ-006-order-export
+
+- **REQ-007 消息通知系统** — 测试中
+  - 本周完成测试用例编写，正在跑回归测试
+  - 分支：feat/REQ-007-notification
+
+## 关键数据
+
+| 指标 | 数值 |
+|------|------|
+| 提交次数 | 47 |
+| 代码变更 | +1,832 / -456 行 |
+| 变更文件 | 23 个 |
+| 需求完成 | 2 个 |
+| 需求新建 | 1 个 |
+| 贡献者 | 3 人 |
+
+  提交类型分布：
+  feat  18 38% 
+  fix   12 26% 
+  test   8 17% 
+  docs   5 11% 
+  other  4  8% 
+
+## 风险与阻塞
+
+- **严重** REQ-006 依赖第三方导出 SDK，版本兼容性待确认
+- **警告** REQ-008 已草稿 5 天未进入评审
+- **提示** REQ-007 测试中，预计本周可完成
+
+## 下周计划
+
+- [ ] REQ-006 完成剩余开发，进入测试
+- [ ] REQ-008 提交评审
+- [ ] 启动 REQ-009 技术方案设计
+- [ ] REQ-007 完成测试，提交 PR
+
+
+*由 /pm:weekly 自动生成 · <today>*
+```
+
+### 5. 提供保存选项
+
+```python
+offer_save(content, f"docs/reports/weekly/{to_date}.md")
+```
+
+---
+
+## 边界情况处理
+
+| 场景 | 处理方式 |
+|------|---------|
+| 本周无提交 | 提示本周无代码活动，仅展示需求状态变化 |
+| 无需求数据 | 仅从 Git 记录生成周报，需求部分标注「未使用需求管理」|
+| 周末执行 | 自动覆盖本周一到今天 |
+| 跨月/跨年 | 正常处理，日期范围不受月/年边界影响 |
+| 无活跃需求 | 下周计划部分标注「暂无待处理需求」|
+
+## 输出风格
+
+- **面向上级/PMO**：使用业务语言描述完成了什么，而非技术细节
+- **数据驱动**：每个结论都有数据支撑（提交数、文件数、进度百分比）
+- **突出价值**：强调业务功能的交付，而非代码层面的改动
+- **风险前置**：明确标注阻塞项和风险，不隐藏问题
+
+## 用户输入
+
+$ARGUMENTS