@zhouhao4221/devflow-skills 0.2.0 → 0.3.0

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

@@ -0,0 +1,257 @@
+---
+name: help
+description: |
+  使用帮助 - 查看项目管理助手所有命令
+---
+
+# 项目管理助手 - 使用帮助
+
+## 命令格式
+
+```
+/pm:help [--lang=zh|en|ko]
+```
+
+## 执行流程
+
+### 1. 决定语言
+
+按以下优先级：
+
+1. 命令参数 `--lang=zh|en|ko`（显式覆盖）
+2. `.claude/settings.local.json` 的 `language` 字段
+3. 默认 `zh`
+
+### 2. 读取版本
+
+```python
+version = read_plugin_json("version")  # <plugin-path>/.claude-plugin/plugin.json
+```
+
+### 3. 按语言输出对应帮助内容
+
+---
+
+## 中文（zh，默认）
+
+```
+
+项目管理助手 v<version> - 使用帮助
+
+
+从 PRD、需求文档和 Git 记录中提取项目数据，
+按不同场景和受众生成汇报、统计、方案等内容。
+
+
+
+**概览**
+  /pm                            项目概况仪表盘
+
+**汇报类**
+  /pm:weekly [--from] [--to]     周报（本周完成/进行中/下周计划）
+  /pm:monthly [--month=YYYY-MM]  月报（月度总结与统计）
+  /pm:milestone <版本号>          里程碑/版本总结
+
+**统计类**
+  /pm:stats [--from] [--to]      多维度数据统计（需求/代码/贡献者）
+  /pm:progress                   项目总进度（甘特视图）
+
+**方案类**
+  /pm:plan <主题>                 生成方案文档（排期/技术/资源）
+  /pm:brief [--lang=zh|en]       项目简介（适合给新人或客户）
+
+**风险类**
+  /pm:risk                       风险扫描（延期/阻塞/异常检测）
+
+**会议类**
+  /pm:standup                    站会摘要（昨天/今天/阻塞）
+
+**通用**
+  /pm:ask <任何问题>              基于项目数据自由提问
+  /pm:export [--format=md]       导出内容到 docs/reports/
+
+
+
+**数据来源**
+  PRD.md           产品需求文档
+  active/*.md      进行中需求
+  completed/*.md   已完成需求
+  modules/*.md     模块文档
+  git log          提交记录
+  git diff         代码变更
+
+**保存位置**
+  所有输出均可选择保存到 docs/reports/ 目录
+
+
+
+**快速开始：**
+  1. /pm              查看项目概况
+  2. /pm:stats        查看统计数据
+  3. /pm:weekly       生成本周周报
+  4. /pm:risk         扫描风险项
+
+**前置条件：**
+  - 建议先使用 /req 插件管理需求（非必须）
+  - Git 仓库存在即可使用代码统计功能
+  - 无需求数据时仍可使用 stats/ask 命令
+
+
+```
+
+---
+
+## English (en)
+
+```
+
+Project Management Assistant v<version> — Help
+
+
+Extracts project data from PRD, requirement docs, and Git
+history to generate reports, stats, and plans for different
+audiences.
+
+
+
+**Overview**
+  /pm                            Project dashboard
+
+**Reports**
+  /pm:weekly [--from] [--to]     Weekly report (done/in-progress/next week)
+  /pm:monthly [--month=YYYY-MM]  Monthly report (summary + stats)
+  /pm:milestone <version>        Milestone / release summary
+
+**Stats**
+  /pm:stats [--from] [--to]      Multi-dimensional stats (reqs/code/contributors)
+  /pm:progress                   Project progress (Gantt view)
+
+**Plans**
+  /pm:plan <topic>               Plan doc (schedule / technical / resource)
+  /pm:brief [--lang=zh|en]       Project brief (for onboarding / clients)
+
+**Risks**
+  /pm:risk                       Risk scan (delays / blockers / anomalies)
+
+**Meetings**
+  /pm:standup                    Standup summary (yesterday / today / blockers)
+
+**General**
+  /pm:ask <any question>         Free-form Q&A over project data
+  /pm:export [--format=md]       Export output to docs/reports/
+
+
+
+**Data sources**
+  PRD.md           Product requirement doc
+  active/*.md      Active requirements
+  completed/*.md   Completed requirements
+  modules/*.md     Module docs
+  git log          Commit history
+  git diff         Code changes
+
+**Persistence**
+  Every output can optionally be saved to docs/reports/
+
+
+
+**Quick start:**
+  1. /pm              View project dashboard
+  2. /pm:stats        View stats
+  3. /pm:weekly       Generate this week's report
+  4. /pm:risk         Scan for risks
+
+**Prerequisites:**
+  - Recommended: manage requirements via the /req plugin (optional)
+  - A Git repository is enough for code statistics
+  - stats/ask work even without requirement data
+
+
+```
+
+---
+
+## 한국어 (ko)
+
+```
+
+프로젝트 관리 도우미 v<version> - 도움말
+
+
+PRD, 요구사항 문서, Git 기록에서 프로젝트 데이터를 추출하여
+다양한 대상자에 맞춘 리포트, 통계, 기획안을 생성합니다.
+
+
+
+**개요**
+  /pm                            프로젝트 대시보드
+
+**리포트**
+  /pm:weekly [--from] [--to]     주간 리포트 (완료/진행 중/다음 주 계획)
+  /pm:monthly [--month=YYYY-MM]  월간 리포트 (요약 + 통계)
+  /pm:milestone <버전>            마일스톤/릴리즈 요약
+
+**통계**
+  /pm:stats [--from] [--to]      다차원 통계 (요구사항/코드/기여자)
+  /pm:progress                   프로젝트 진척도 (간트 뷰)
+
+**기획안**
+  /pm:plan <주제>                 기획안 문서 (일정/기술/리소스)
+  /pm:brief [--lang=zh|en]       프로젝트 브리프 (온보딩/고객용)
+
+**리스크**
+  /pm:risk                       리스크 스캔 (지연/블로커/이상)
+
+**미팅**
+  /pm:standup                    스탠드업 요약 (어제/오늘/블로커)
+
+**공통**
+  /pm:ask <질문>                  프로젝트 데이터 기반 자유 질의응답
+  /pm:export [--format=md]       docs/reports/ 에 내보내기
+
+
+
+**데이터 소스**
+  PRD.md           제품 요구사항 문서
+  active/*.md      진행 중 요구사항
+  completed/*.md   완료된 요구사항
+  modules/*.md     모듈 문서
+  git log          커밋 기록
+  git diff         코드 변경
+
+**저장 위치**
+  모든 출력은 docs/reports/ 에 선택적으로 저장 가능
+
+
+
+**빠른 시작:**
+  1. /pm              프로젝트 대시보드 조회
+  2. /pm:stats        통계 조회
+  3. /pm:weekly       이번 주 리포트 생성
+  4. /pm:risk         리스크 스캔
+
+**전제 조건:**
+  - /req 플러그인으로 요구사항 관리 권장 (필수 아님)
+  - Git 레포가 있으면 코드 통계 사용 가능
+  - 요구사항 데이터가 없어도 stats/ask 사용 가능
+
+
+```
+
+---
+
+## 持久化语言偏好
+
+在 `.claude/settings.local.json` 中设置一次：
+
+```json
+{
+  "language": "en"
+}
+```
+
+后续 `/req:help`、`/api:help`、`/pm:help` 都会默认用该语言。
+
+## 用户输入
+
+$ARGUMENTS

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

@@ -0,0 +1,102 @@
+---
+name: milestone
+description: |
+  里程碑总结 - 版本发布总结报告
+---
+
+# 里程碑总结
+
+> **Audience:** Product Manager
+
+基于 Git Tag 和需求完成记录，生成版本发布总结报告。
+
+## 命令格式
+
+```
+/pm:milestone <版本号> [--from=<tag|commit>] [--save]
+```
+
+**参数说明：**
+- `<版本号>`：**必填**，版本号（如 v1.6.0）
+- `--from`：可选，起始点，默认上一个 Tag
+- `--save`：可选，直接保存不询问
+
+**示例：**
+- `/pm:milestone v1.6.0` — 从上个 Tag 到当前
+- `/pm:milestone v1.6.0 --from=v1.5.0` — 指定起始版本
+
+---
+
+## 执行流程
+
+### 1. 确定版本范围
+
+```bash
+TO_REF=${version}  # 如果 tag 存在则用 tag，否则用 HEAD
+FROM_REF=${from:-$(git describe --tags --abbrev=0 $TO_REF^ 2>/dev/null)}
+```
+
+### 2. 采集数据
+
+- 范围内的 Git 提交和变更统计
+- 从提交消息中提取关联需求编号
+- 读取对应需求文档获取详细信息
+- 计算版本开发周期（起止时间）
+
+### 3. 输出里程碑报告
+
+```
+
+里程碑总结：<version>
+
+项目：<project>
+版本范围：<from-ref> → <to-ref>
+开发周期：YYYY-MM-DD ~ YYYY-MM-DD（X 天）
+
+
+## 版本概览
+
+本版本聚焦于 XX 功能，包含 X 个需求交付、XX 个提交。
+核心亮点：...（AI 从需求标题和提交类型推导）
+
+## 交付需求
+
+| 编号 | 标题 | 类型 | 交付功能点 |
+|------|------|------|----------|
+| REQ-005 | 用户积分兑换 | 后端 | 兑换规则、记录查询、限额校验 |
+| QUICK-003 | 修复登录超时 | 全栈 | token 刷新竞态修复 |
+
+## 代码统计
+
+| 指标 | 数值 |
+|------|------|
+| 总提交 | XX |
+| 代码变更 | +X,XXX / -XXX 行 |
+| 变更文件 | XX 个 |
+| 贡献者 | X 人 |
+
+  提交类型：
+  feat  XX 
+  fix   XX 
+  other XX 
+
+## 贡献者
+
+| 贡献者 | 提交数 | 占比 |
+|--------|--------|------|
+| 张三 | XX | XX% |
+| 李四 | XX | XX% |
+
+
+*由 /pm:milestone 自动生成 · YYYY-MM-DD*
+```
+
+### 4. 提供保存选项
+
+```python
+offer_save(content, f"docs/reports/milestone/{version}.md")
+```
+
+## 用户输入
+
+$ARGUMENTS

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

@@ -0,0 +1,111 @@
+---
+name: monthly
+description: |
+  月报 - 月度工作总结与统计分析
+---
+
+# 生成月报
+
+> **Audience:** Product Manager
+
+从需求文档和 Git 记录生成月度工作总结，包含本月成果、数据统计、趋势分析和下月计划。
+
+## 命令格式
+
+```
+/pm:monthly [--month=YYYY-MM] [--save]
+```
+
+**参数说明：**
+- `--month`：可选，指定月份，默认当月
+- `--save`：可选，直接保存不询问
+
+**示例：**
+- `/pm:monthly` — 当月月报
+- `/pm:monthly --month=2026-02` — 2 月月报
+
+---
+
+## 执行流程
+
+### 1. 确定时间范围
+
+```python
+if args.month:
+    year, month = args.month.split('-')
+    from_date = f"{year}-{month}-01"
+    to_date = last_day_of_month(year, month)
+else:
+    from_date = today.replace(day=1).isoformat()
+    to_date = today.isoformat()
+```
+
+### 2. 采集数据
+
+与 weekly 类似，但范围为整月：
+- 本月完成的需求
+- 本月新创建的需求
+- 本月 Git 统计（提交、变更、贡献者）
+- 与上月的对比数据
+
+### 3. 输出月报
+
+```
+
+项目月报
+
+项目：<project> | 月份：YYYY-MM
+
+
+## 月度总结
+
+本月聚焦 XX 模块开发，完成 X 个需求，新建 X 个需求。
+代码提交 XX 次，净增 +X,XXX 行代码。
+
+## 本月完成
+
+| 编号 | 标题 | 类型 | 完成日期 | 提交数 |
+|------|------|------|---------|--------|
+| REQ-005 | 用户积分兑换 | 后端 | 03-22 | 12 |
+| QUICK-003 | 修复登录超时 | 全栈 | 03-20 | 3 |
+
+## 进行中
+
+| 编号 | 标题 | 状态 | 进度 |
+|------|------|------|------|
+| REQ-006 | 订单导出 | 开发中 | 60% |
+| REQ-007 | 消息通知 | 测试中 | 90% |
+
+## 数据统计
+
+| 指标 | 本月 | 上月 | 趋势 |
+|------|------|------|------|
+| 需求完成 | X | X | ↑/↓/→ |
+| 需求新建 | X | X | ↑/↓/→ |
+| 提交次数 | XX | XX | ↑/↓/→ |
+| 代码变更 | +X,XXX/-XXX | +X,XXX/-XXX | ↑/↓/→ |
+| 贡献者 | X | X | → |
+
+## 风险与问题
+
+- 本月遇到的阻塞和解决方案
+- 未解决的遗留问题
+
+## 下月计划
+
+- 基于活跃需求推导的下月重点
+
+
+*由 /pm:monthly 自动生成 · YYYY-MM-DD*
+```
+
+### 4. 提供保存选项
+
+```python
+month_str = args.month or today.strftime("%Y-%m")
+offer_save(content, f"docs/reports/monthly/{month_str}.md")
+```
+
+## 用户输入
+
+$ARGUMENTS

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

@@ -0,0 +1,96 @@
+---
+name: plan
+description: |
+  生成方案文档 - 排期方案、技术方案、资源评估等
+---
+
+# 生成方案文档
+
+> **Audience:** Product Manager
+
+根据当前项目数据和用户指定的主题，AI 生成方案文档。
+
+## 命令格式
+
+```
+/pm:plan <主题> [--save]
+```
+
+**参数说明：**
+- `<主题>`：**必填**，方案主题（如「Q2 排期方案」「技术架构升级」「人力资源评估」）
+- `--save`：可选，直接保存不询问
+
+**示例：**
+- `/pm:plan Q2排期方案` — 基于待办需求生成排期
+- `/pm:plan 技术债务清理` — 基于代码热点和修复频率
+- `/pm:plan 新人上手指南` — 基于项目结构和模块信息
+
+---
+
+## 执行流程
+
+### 1. 采集相关数据
+
+根据主题关键词自动判断需要哪些数据：
+
+| 主题关键词 | 采集数据 |
+|-----------|---------|
+| 排期、计划、迭代 | 活跃需求 + 历史完成速度 + 贡献者 |
+| 技术、架构、重构 | 代码结构 + 热点文件 + Git 变更 |
+| 资源、人力、团队 | 贡献者统计 + 需求分布 |
+| 风险、复盘、回顾 | 风险检测 + 历史数据 |
+| 上手、培训、介绍 | PRD + 模块 + 项目结构 |
+
+### 2. AI 生成方案
+
+**生成要求：**
+- 方案必须基于实际项目数据，不凭空设想
+- 引用具体的需求编号、文件路径、统计数据
+- 包含可执行的行动项
+- 区分「建议」和「结论」
+
+### 3. 输出格式
+
+```
+
+方案文档：<主题>
+
+项目：<project> | 生成日期：YYYY-MM-DD
+
+
+## 背景
+
+（AI 基于项目数据分析当前状况）
+
+## 目标
+
+（从主题推导出要解决的问题）
+
+## 方案详情
+
+（具体方案内容，引用项目数据）
+
+## 行动项
+
+- [ ] 行动 1（负责人/时间）
+- [ ] 行动 2
+- [ ] 行动 3
+
+## 风险与依赖
+
+（方案执行的前置条件和风险）
+
+
+*由 /pm:plan 自动生成 · YYYY-MM-DD*
+```
+
+### 4. 提供保存选项
+
+```python
+topic_slug = slugify(topic)  # 简短文件名
+offer_save(content, f"docs/reports/plans/{topic_slug}.md")
+```
+
+## 用户输入
+
+$ARGUMENTS