ccgx-workflow 1.0.0

package/templates/skills/tools/extract-learnings/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: extract-learnings
+description: 从近期开发会话中萃取可复用的模式 / 决策 / 教训。当用户提到提取教训 / 复盘 / lessons learned / 知识沉淀 / 经验萃取 / 提炼模式时使用。会扫 .context/ 决策日志 + git log 提交语义。
+license: MIT
+user-invocable: true
+disable-model-invocation: false
+allowed-tools: Read, Bash, Grep, Glob, Write
+argument-hint: "[--since=30d]"
+---
+
+# 📚 复盘关卡 · 经验萃取
+
+> v4.1-p18：作为 skill 暴露（v3.0 曾有 `/ccg:extract-learnings` 命令规划，v4.0/v4.1 收敛到 skill 化触发）。
+
+从最近的开发活动中萃取**可复用知识**，写入 `.context/learnings/<日期>-extract.md`，避免反复踩同坑。
+
+## 使用方法
+
+```bash
+/ccg:extract-learnings              # 默认萃取最近 30 天
+/ccg:extract-learnings --since=14d  # 自定义时间窗口
+```
+
+## 工作流程
+
+### Step 1：收集原料
+
+```bash
+# 决策日志
+ls .context/sessions/ 2>/dev/null
+# git 提交（含 commit message）
+git log --since='30.days.ago' --pretty='%h %s' --no-merges
+# 已归档的 phase 报告
+ls .claude/team-plan/*-report.md 2>/dev/null
+```
+
+### Step 2：分类萃取
+
+按以下五个桶过滤：
+
+1. **模式（Pattern）** — 反复出现的好做法（"phase 都用 fresh-context subagent 隔离"）
+2. **反模式（Anti-pattern）** — 反复犯的错（"沙箱里跑 git commit 总被拒"）
+3. **决策记录（ADR-like）** — 重要架构决定 + 为什么这么决定
+4. **工具陷阱（Tooling pitfall）** — 工具实际行为 != 文档（"Claude Code subagent 不能嵌套 spawn"）
+5. **痛点 / 改进点（Pain point）** — 还没解决的待办 / 流程瓶颈
+
+### Step 3：写报告
+
+```markdown
+# Learnings Extract — <日期范围>
+
+**会话数**: N · **commits**: M · **完成 phase**: K
+
+## 模式（建议固化）
+1. ...
+
+## 反模式（建议警告）
+1. ...
+
+## 决策记录
+- **D1: 用 SessionStart hook 注入 roadmap** — 原因：v4.0 主线零项目记忆痛点
+
+## 工具陷阱
+- **subagent 不能 spawn 子 agent**（commit a7cdffd 实测）
+
+## 痛点
+- ...
+```
+
+### Step 4：（可选）建议 PR
+
+每条"模式"标记 `→ promote to rules?`，让用户决定是否上升为 `~/.claude/rules/*.md`。
+
+## 输出契约
+
+- 主输出：`.context/learnings/<YYYY-MM-DD>-extract.md`
+- 终端：每桶 1-3 条精选摘要

package/templates/skills/tools/forensics/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: forensics
+description: 代码事件取证 / 提交考古。给定一个文件 / 函数 / bug 现场，反向溯源 git 历史 + 关联 PR / issue / 改动者，重建事故 timeline。当用户提到 git blame / 谁改的 / 为什么这样写 / 提交考古 / 代码取证 / forensics 时使用。
+license: MIT
+user-invocable: true
+disable-model-invocation: false
+allowed-tools: Bash, Read, Grep, Glob, Write
+argument-hint: "<file:line> 或 <function-name>"
+---
+
+# 🔬 取证关卡 · 代码考古
+
+> v4.1-p18：作为 skill 暴露（v3.0 曾有 `/ccg:forensics` 规划）。
+
+给定一段"问题代码"或"已知 bug 现场"，反向重建事故时间线：
+
+- 这一段最早什么时候引入？哪个 PR？
+- 之后被谁改过？每次改的动机？
+- 周边 commit 是否有相关 hint？
+- 当前形态是否已偏离原始设计意图？
+
+## 使用方法
+
+```bash
+/ccg:forensics src/foo.ts:42        # 锁定具体行
+/ccg:forensics handleAuth           # 锁定函数名
+/ccg:forensics "TODO: fix race"     # 锁定特征字符串
+```
+
+## 工作流程
+
+### Step 1：定位现场
+
+如参数是 `file:line` → `git blame -L line,line file`。
+如是函数名 → `grep -rn "<name>" --include="*.{ts,js,py,go,rs}"` 定位首次出现。
+如是特征字符串 → `git log -S "<string>" --pretty='%h %ai %an %s'`（pickaxe）
+
+### Step 2：完整 commit 链
+
+```bash
+git log --follow --pretty='%h %ai %an %s' -- <file>
+git log -L <line>,+1:<file>      # 行级 history
+```
+
+### Step 3：关联 PR / issue（如有 GitHub）
+
+```bash
+# 从 commit message 提取 (#123) PR 引用
+git log --grep '(#[0-9]\+)' --pretty='%h %s'
+# 如装了 gh CLI:
+gh pr view <num> --json title,body,author,mergedAt
+```
+
+### Step 4：周边语义聚类
+
+对每个相关 commit `git show --stat <sha>`，看是否同 commit 改了相邻文件 → 有助于推断"当时的工作上下文"。
+
+### Step 5：重建 timeline 报告
+
+```markdown
+# Forensics Report — <现场标识>
+
+**调查时间**: <ISO>
+**当前现场**: src/foo.ts:42 (HEAD)
+
+## Timeline
+
+| 日期 | commit | author | 动作 | PR | 备注 |
+|------|--------|--------|------|----|------|
+| 2026-01-15 | abc1234 | Alice | 引入 | #45 | 原始设计，handle null |
+| 2026-02-03 | def5678 | Bob | 修改 | #67 | 加 retry 逻辑 |
+| 2026-03-12 | ghi9abc | Carol | 修改 | #88 | 改成异步，**疑似引入 race**|
+
+## 当前与原意偏离度
+- 原始：同步 + null check
+- 现在：异步 + 无 mutex → race condition 高风险
+
+## 推断 root cause
+**ghi9abc** 把同步改异步时未补 mutex。**修复建议**：加 `pLimit(1)` 或 `Mutex`。
+```
+
+### Step 6（可选）：写到 .context
+
+报告写到 `.context/forensics/<YYYY-MM-DD>-<slug>.md` 持久化，方便后续 `/ccg:debug` 快速复用。
+
+## 输出契约
+
+- 主输出：`.context/forensics/<YYYY-MM-DD>-<slug>.md`（如 dest 已存在则 append）
+- 终端：timeline 表 + root cause 推断

package/templates/skills/tools/gen-docs/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: gen-docs
+description: 文档生成器。自动分析模块结构，生成 README.md 和 DESIGN.md 骨架。当用户提到生成文档、创建README、创建DESIGN、文档骨架、文档模板时使用。在新建模块开始时自动触发。
+license: MIT
+compatibility: node>=18
+user-invocable: true
+disable-model-invocation: false
+allowed-tools: Bash, Read, Write, Glob
+argument-hint: <模块路径> [--force]
+---
+
+# 📝 造典关卡 · 文档生成器
+
+
+## 核心原则
+
+```
+无文档不成模块
+文档是模块的身份证
+没有身份证的模块不允许上线
+```
+
+## 自动生成
+
+运行文档生成脚本（跨平台）：
+
+```bash
+# 在 skill 目录下运行
+node scripts/doc_generator.js <模块路径>
+node scripts/doc_generator.js <模块路径> --force  # 强制覆盖已存在的文档
+node scripts/doc_generator.js <模块路径> --json   # JSON 输出
+```
+
+## 生成内容
+
+### README.md 骨架
+
+自动生成的 README.md 包含：
+
+- **模块名称** — 从目录名提取
+- **描述** — 从代码文档字符串提取（如有）
+- **特性列表** — 待填充
+- **依赖** — 从 requirements.txt/pyproject.toml 提取
+- **使用方法** — 基础模板
+- **API 概览** — 从代码提取类和函数列表
+- **目录结构** — 自动扫描生成
+
+### DESIGN.md 骨架
+
+自动生成的 DESIGN.md 包含：
+
+- **设计概述** — 目标与非目标模板
+- **架构设计** — 架构图占位符
+- **核心组件** — 从代码提取类列表
+- **设计决策** — 决策记录表格模板
+- **技术选型** — 自动检测语言和依赖
+- **权衡取舍** — 已知限制和技术债务模板
+- **安全考量** — 威胁模型和安全措施模板
+- **变更历史** — 初始版本记录
+
+## 智能分析
+
+### 支持的语言
+
+| 语言 | 分析能力 |
+|------|----------|
+| **Python** | 类、函数、文档字符串、依赖 |
+| **Go** | 目录结构、依赖 |
+| **TypeScript** | 目录结构、依赖 |
+| **Rust** | 目录结构、依赖 |
+| **其他** | 基础目录结构 |
+
+### 提取的信息
+
+- 模块名称（目录名）
+- 主要编程语言
+- 代码文件列表
+- 类和函数定义（Python）
+- 文档字符串（Python）
+- 依赖列表
+- 入口点文件
+
+## 自动触发时机
+
+| 场景 | 触发条件 |
+|------|----------|
+| 新建模块 | 模块创建开始时 |
+| 缺失文档 | 检测到模块缺少文档时 |
+
+## 使用流程
+
+```
+1. 运行 doc_generator.js 生成骨架
+2. 填充 TODO 标记的内容
+3. 补充设计决策和理由
+4. 添加使用示例
+5. 运行 /verify-module 校验完整性
+```
+
+## 生成后检查清单
+
+### README.md
+
+- [ ] 填充模块描述
+- [ ] 补充特性列表
+- [ ] 添加使用示例
+- [ ] 确认依赖完整
+
+### DESIGN.md
+
+- [ ] 明确设计目标
+- [ ] 记录设计决策
+- [ ] 说明技术选型理由
+- [ ] 列出已知限制
+
+---