sillyspec-commit

name	sillyspec:commit
description	智能提交 — 自动收集变更信息，生成 commit message
argument-hint	[可选：自定义 commit message]
version	3.7.32

交互规范

当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。

用法

• /sillyspec:commit — 智能提交：自动收集变更信息，生成 commit message
• /sillyspec:commit "自定义 message" — 使用指定 message 直接提交

任务

$ARGUMENTS

---

流程

1. 检查是否有未提交的修改

git diff --quiet 2>/dev/null; UNSTAGED=$? git diff --cached --quiet 2>/dev/null; STAGED=$?

两者都为 0（无修改）→ 提示"没有需要提交的修改"，结束。

2. 暂存所有修改

git add -A

3. 收集变更语义信息

上次 commit 时间

LAST_COMMIT_TIME=$(git log -1 --format=%ci 2>/dev/null)

修改的文件列表

git diff --cached --stat

从以下来源收集语义信息（筛选时间戳 > LAST_COMMIT_TIME 的条目）：

来源 A — QUICKLOG（quick 产生的修改）： USER=$(git config user.name 2>/dev/null || echo "default") cat .sillyspec/quicklog/QUICKLOG-${USER}.md 2>/dev/null

同时扫描活跃变更目录下的归属 quicklog

for dir in .sillyspec/changes//quicklog/.md; do [ -f "$dir" ] && cat "$dir"; done 2>/dev/null

注：QUICKLOG 现由 CLI 接管写入（src/quicklog.js），描述取 quick 启动的任务参数、

结果取 step3 --output 一句话，粒度可能较粗；条目仍含 标题|时间|描述 + 状态 + 结果 结构，

可直接读取。描述过泛时结合 diff stat 与 tasks.md 补充语义。

来源 B — tasks.md（execute 产生的修改）： LATEST=$(ls -d .sillyspec/changes/*/ 2>/dev/null | grep -v archive | tail -1) cat "$LATEST/tasks.md" 2>/dev/null 筛选时间戳 > LAST_COMMIT_TIME 的已勾选 task。

来源 C — 阶段产出（scan/brainstorm/plan/archive 等）： 检查 .sillyspec/ 下新增或修改的文件，根据路径识别来源阶段：

• .sillyspec/docs//scan/*.md → scan 产出
• changes//design.md → brainstorm 产出
• changes//proposal.md → brainstorm 产出
• changes//tasks.md → plan 产出
• changes//plan.md → plan 产出
• changes/archive/ → archive 产出
• knowledge/*.md → 知识库更新

4. 自动生成 commit message

按 conventional commits 格式，根据来源生成 message：

来源	type	示例
只有 quick 条目	fix/refactor	fix: 手机号校验修复（含正则修正）
只有 execute 条目	feat	feat(user): 用户模块 task 1~3
只有阶段产出	docs	docs: sillyspec scan 完成
混合来源	取最主要的 type	body 里列出所有条目
无匹配来源	—	展示 diff stat，让用户自己写

如果 $ARGUMENTS 非空，直接使用用户指定的 message，跳过自动生成，但仍展示 diff stat。

多条 quick 合并规则：

• 2 条以内 → 逐条列出
• 3 条以上 → 摘要 + body 详情

5. 展示确认

用 AskUserQuestion 展示： 📝 建议的 commit message： fix: 手机号校验修复（含正则修正）

📁 修改文件（N 个）： src/UserService.java (+15 -3) src/PhoneValidator.java (+28 -0)

选择：确认提交 / 编辑 message / 取消

用户选择编辑 → 让用户输入新 message → 再次确认。

6. 执行提交

git commit -m "{确认后的 message}"

提交成功后展示 commit hash + 文件数 + 行数统计。

多项目

检查修改的文件分别属于哪个子项目：

• 修改集中在一个子项目 → 在该子项目目录中 commit
• 修改跨多个子项目 → 用 AskUserQuestion 让用户选择：分开提交（每个子项目一个 commit）/ 合并提交

绝对规则

• ❌ 不要自动提交，必须展示 message 让用户确认
• ❌ 不要丢弃用户的修改
• ✅ $ARGUMENTS 非空时展示 diff stat 后直接提交（不需手动确认）