角色分工

角色	职责
Claude（主线程）	执行 Git 检查、收集 diff、决定是否启用 subagents、生成 commit message、执行提交
subagents	只读分析大 diff 的聚类结果、拆分建议与风险点，不执行 Git 写操作

执行约束

工作目录：

subagents 使用条件：

重要：

所有 Git 写操作（git add、git commit、写 .git/COMMIT_EDITMSG、写 .context/history/*）只由主线程执行
subagents 不得执行暂存、提交、改写历史、跳过钩子等 Git 写操作
已委托给 subagents 的 diff 分析内容，主线程不要重复分析
默认尊重 Git hooks；只有用户显式传入 --no-verify 时才可跳过
只有用户显式传入 --amend 时才允许修补上次提交

[模式：检查]

[模式：分析]

[模式：建议]

主线程先快速判断改动规模与关注点
若改动较小，主线程直接按以下维度聚类：
- 关注点（源代码 vs 文档/测试）
- 文件模式（不同目录/包）
- 改动类型（新增 vs 删除）
若检测到以下情况之一，则按需并行启动只读 subagents：
- 改动超过约 300 行
- 跨多个顶级目录
- 同时包含功能、测试、文档、配置等多类改动
subagents 典型拆分方式：
- 改动聚类：判断哪些文件应归为同一原子提交
- 风险扫描：识别 breaking change、配置风险、大量删除、测试缺口
主线程汇总后决定：
- 是否建议拆分提交
- 当前提交的最佳 type / scope / subject

[模式：生成]

格式：[emoji] <type>(<scope>): <subject>

若已启用 subagents，则结合其聚类与风险分析结果生成更准确的提交信息。

[模式：上下文归档]

前置判断：

若 .context/ 目录不存在 → 自动创建 .context/history/、.context/current/branches/ 目录结构，初始化空的 commits.jsonl 和 commits.md，然后继续执行归档
若 .context/ 存在 → 执行以下步骤

从 git diff 自动生成 ContextEntry：

获取当前分支名：git branch --show-current
获取暂存区变更：git diff --cached --stat + git diff --cached
分析 diff 生成 ContextEntry：
- summary：从阶段 4 生成的 commit message 中取首行
- decisions：分析 diff 中的关键变更（新增依赖、架构调整、接口变更、配置修改），推断决策理由
- bugs：若 commit type 为 fix，从 diff 中提取 bug 症状、根因、修复方式
- changes.files：从 git diff --cached --name-only 提取
- tests：若变更包含测试文件，记录测试相关信息
若 .context/current/branches/<branch>/session.log 存在且非空，将其中的手动记录合并到 decisions / bugs 中，然后清空 session.log
脱敏：扫描 token / key / password / secret 模式 → 替换为 [REDACTED]
追加：将 ContextEntry 作为一行追加到 .context/history/commits.jsonl
重生成：更新 .context/history/commits.md 人类视图
暂存：git add .context/history/
Trailer：在 commit message 中添加 Context-Id: <uuid> trailer

失败降级：若归档过程出错，不阻断提交。写入 minimal ContextEntry（仅 summary + files），继续正常提交。

[模式：执行]

git commit [-S] [--no-verify] [-s] -F .git/COMMIT_EDITMSG

/ac-commit
/ac-commit --all
/ac-commit --emoji
/ac-commit --scope ui --type feat --emoji
/ac-commit --amend --signoff