sillyspec 3.26.10 → 3.26.13

package/.claude/skills/sillyspec-archive/SKILL.md

@@ -1,85 +1,85 @@
----
-name: sillyspec:archive
-description: 用于归档已验证完成的变更。适合用户说"归档、archive、收尾这个变更"。执行模块影响分析 + 同步模块文档 + 移动到 archive 目录 + 更新 ROADMAP。
----
-
-## 何时使用
-
-- 用户说"归档、archive、收尾这个变更"
-- verify 已通过，把变更包归档沉淀
-- 5 步：任务完成度检查 → 模块影响分析 → 同步模块文档 → 确认归档 → 更新路线图
-
-## 多变更说明
-
-项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
-
-## 步骤生命周期（所有阶段通用）
-
-> `sillyspec archive` 是 `sillyspec run archive` 的顶层别名，两者等价。
-
-```bash
-sillyspec run archive                          # 输出当前步骤 prompt
-sillyspec run archive --done --output "摘要"   # 完成当前步骤
-sillyspec run archive --status                 # 查看阶段进度
-sillyspec run archive --skip                   # 跳过可选步骤
-sillyspec run archive --reset                  # 重置阶段（从头开始）
-sillyspec run archive --reopen --from-step N   # 重新打开已完成阶段修订（N=序号或名称）
-```
-
-## 通用参数（所有阶段适用）
-
-| 参数 | 说明 |
-|---|---|
-| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
-| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
-
-## archive 特有
-
-### `--confirm`（确认归档步骤必填）
-
-第 4 步「确认归档」由 CLI 执行目录移动，**必须带 `--confirm`**：
-
-```bash
-sillyspec run archive --done --confirm --output "确认归档"
-```
-
-不带 `--confirm` 时 CLI 回退步骤为 pending 并提示，不会误归档。
-
-### 归档前硬校验
-
-CLI 移动目录前会校验 `plan.md` 存在——缺失则 `exit(1)` 阻断（目录尚未移动，可补全后重试）。移动后校验 `design.md` / `module-impact.md`（缺失只告警，因目录已移动）。
-
-### 模块文档同步（第 3 步）
-
-第 3 步「sync-module-docs」会更新 `_module-map.yaml` + 模块卡片，**必须暂停等用户确认**：
-
-```bash
-sillyspec run archive --wait --reason "等待用户确认模块文档同步" --options "确认写入,跳过同步" --output "diff 摘要"
-sillyspec run archive --continue --answer "确认写入"
-```
-
-只有用户 `--continue --answer "确认写入"` 后才写入文件。
-
-### 归档结果
-
-归档后变更目录从 `changes/<名>/` 移到 `changes/archive/YYYY-MM-DD-<名>/`，并从活跃列表注销。后续用 `/sillyspec:commit` 提交。
-
-## 阶段流转
-
-```
-verify → archive → git commit
-```
-
-archive 完成后，运行 `/sillyspec:commit` 提交归档结果（`git add .sillyspec/changes/`）。
-
-## 铁律
-
-- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
-- 不要用 `mv`/`rename` 重命名变更目录，必须由 CLI 的「确认归档」步骤移动
-- 归档不可逆——确认前核对变更名、文件列表、module-impact.md
-- 完成后立即 `--done`，不跳过
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:archive
+description: 用于归档已验证完成的变更。适合用户说"归档、archive、收尾这个变更"。执行模块影响分析 + 同步模块文档 + 移动到 archive 目录 + 更新 ROADMAP。
+---
+
+## 何时使用
+
+- 用户说"归档、archive、收尾这个变更"
+- verify 已通过，把变更包归档沉淀
+- 5 步：任务完成度检查 → 模块影响分析 → 同步模块文档 → 确认归档 → 更新路线图
+
+## 多变更说明
+
+项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec archive` 是 `sillyspec run archive` 的顶层别名，两者等价。
+
+```bash
+sillyspec run archive                          # 输出当前步骤 prompt
+sillyspec run archive --done --output "摘要"   # 完成当前步骤
+sillyspec run archive --status                 # 查看阶段进度
+sillyspec run archive --skip                   # 跳过可选步骤
+sillyspec run archive --reset                  # 重置阶段（从头开始）
+sillyspec run archive --reopen --from-step N   # 重新打开已完成阶段修订（N=序号或名称）
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
+
+## archive 特有
+
+### `--confirm`（确认归档步骤必填）
+
+第 4 步「确认归档」由 CLI 执行目录移动，**必须带 `--confirm`**：
+
+```bash
+sillyspec run archive --done --confirm --output "确认归档"
+```
+
+不带 `--confirm` 时 CLI 回退步骤为 pending 并提示，不会误归档。
+
+### 归档前硬校验
+
+CLI 移动目录前会校验 `plan.md` 存在——缺失则 `exit(1)` 阻断（目录尚未移动，可补全后重试）。移动后校验 `design.md` / `module-impact.md`（缺失只告警，因目录已移动）。
+
+### 模块文档同步（第 3 步）
+
+第 3 步「sync-module-docs」会更新 `_module-map.yaml` + 模块卡片，**必须暂停等用户确认**：
+
+```bash
+sillyspec run archive --wait --reason "等待用户确认模块文档同步" --options "确认写入,跳过同步" --output "diff 摘要"
+sillyspec run archive --continue --answer "确认写入"
+```
+
+只有用户 `--continue --answer "确认写入"` 后才写入文件。
+
+### 归档结果
+
+归档后变更目录从 `changes/<名>/` 移到 `changes/archive/<名>/`，并从活跃列表注销。后续用 `/sillyspec:commit` 提交。
+
+## 阶段流转
+
+```
+verify → archive → git commit
+```
+
+archive 完成后，运行 `/sillyspec:commit` 提交归档结果（`git add .sillyspec/changes/`）。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- 不要用 `mv`/`rename` 重命名变更目录，必须由 CLI 的「确认归档」步骤移动
+- 归档不可逆——确认前核对变更名、文件列表、module-impact.md
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

package/.claude/skills/sillyspec-brainstorm/SKILL.md

@@ -1,114 +1,114 @@
----
-name: sillyspec:brainstorm
-description: 用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案（design/proposal/requirements/tasks 四件套），但不直接写代码。
----
-
-## 交互规范
-
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。** 不要用编号列表让用户手动输入数字。
-
-## 何时使用
-
-- 用户提出新功能、新模块、架构调整、复杂改造
-- 用户说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"
-- 产出：`design.md` + `proposal.md` + `requirements.md` + `tasks.md`（四件套），不写代码
-
-## 多变更说明
-
-项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。建议变更名格式：`YYYY-MM-DD-<简短描述>`。
-
-## 步骤生命周期（所有阶段通用）
-
-> `sillyspec brainstorm` 是 `sillyspec run brainstorm` 的顶层别名，两者等价。
-
-```bash
-sillyspec run brainstorm                       # 输出当前步骤 prompt
-sillyspec run brainstorm --done --output "摘要"     # 完成当前步骤（--input "用户原话" 记录输入）
-sillyspec run brainstorm --status              # 查看阶段进度
-sillyspec run brainstorm --skip                # 跳过可选步骤
-sillyspec run brainstorm --reset               # 重置阶段（从头开始）
-sillyspec run brainstorm --reopen --from-step N     # 重新打开已完成阶段修订（N=序号或名称）
-sillyspec run brainstorm --wait --reason "..." --options "A,B"   # 暂停等用户决策
-sillyspec run brainstorm --continue --answer "..."               # 恢复等待中的步骤
-sillyspec run brainstorm --done --answer "..." --output "..."    # 一步完成 wait+done
-```
-
-## 通用参数（所有阶段适用）
-
-| 参数 | 说明 |
-|---|---|
-| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
-| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--interactive` | 强制交互（即便 stdin 非 TTY） |
-| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
-
-## brainstorm 特有：requiresWait 步骤
-
-某些步骤（如"对话式探索与需求澄清"）需要用户输入。两种方式：
-
-> 自动去重：若前置 step 已对同一问题（waitReason 归一化后相同）确认过，后续重复 wait 会自动跳过，无需再 `--wait`。
-
-- **方式一（推荐）**：分步——先 `--wait` 记录等待，让用户亲眼看到 CLI 打出的选项再作答，再 `--continue --answer`，最后 `--done`：
-  ```bash
-  sillyspec run brainstorm --wait --change <名> --reason "等待用户回答" --output "探索问题"
-  sillyspec run brainstorm --continue --answer "用户回答" --change <名>
-  sillyspec run brainstorm --done --change <名> --output "需求已澄清"
-  ```
-- **方式二**：AI 自行与用户交互后，一步完成（仅在用户已在对话中明确给出答案、无需再走 CLI 等待展示时用）：
-  ```bash
-  sillyspec run brainstorm --done --change <名> --answer "用户回答" --output "需求已澄清"
-  ```
-
-> ⚠️ 两种方式都要求 `--answer` 是**用户真实的回答**，不是你替用户编的回答。`requiresWait` 门只校验 `--answer` 非空，挡不住「AI 伪造用户回答」——所以对方案选择/设计确认这类关键决策，优先用方式一让用户亲手作答，而不是 AI 中继一句话带过。
-
-## 阶段流转
-
-```
-                ┌─ scale=large → plan（四件套齐）
-scan → brainstorm ┤
-                └─ scale=small → quick --linked-changes（仅 design.md）
-```
-
-brainstorm 完成时按 design.md frontmatter 的 `scale` 分叉：
-- **large**（多文件/跨模块/有状态机或 schema 变更）：四件套齐 + Design Grill 审查通过（tier=independent 时由独立审查子代理产出 stage review.json）→ `sillyspec run plan --change <变更名>`
-- **small**（≤2 文件、单模块、无跨模块依赖）：仅生成 design.md → `sillyspec run quick --linked-changes <变更名>`
-
-> 规模由 AI 在 brainstorm 最后一步评估并写入 design.md frontmatter。判错可手动改 `scale` 后再跑相应阶段。
-
-### Stage Review Gate（brainstorm 末尾的 design review.json）
-
-brainstorm 在 `tier=independent` 规模下除 design.md 等四件套外，还需产出一个 stage 级 `review.json`，CLI `Stage Review Gate` 硬校验其 schema 与 `docHash` 真实性。
-
-- 路径：`.sillyspec/.runtime/stage-reviews/brainstorm-review-<stage-review-run-id>/review.json`（目录可能不存在需手建；run-id 由该步 `--done` prompt 输出指定）。marker 文件 `.runtime/current-stage-review-run-id-brainstorm-<变更名>`。
-- **run-id / marker 由 CLI 自动生成注入**（review step prompt 渲染时 echo 完整目录路径 + 写 marker；撞 gate 报缺 review.json 时 gate 也 echo 完整路径 + 写 marker）。直接用 CLI 给的路径写 review.json，**勿手算 run-id（必须 `review-` 前缀）、勿手写 marker**。卡住时用 `sillyspec register-stage-review --change <名> --stage brainstorm` 一步生成。
-- 字段（`schemaVersion:1`，`reviewType=design` —— 区别于 execute 的 `acceptance`）：
-
-  ```json
-  {
-    "schemaVersion": 1,
-    "reviewType": "design",
-    "reviewedFiles": ["changes/<变更名>/design.md"],   // [0] 为主文档
-    "docHash": "<sha256(reviewedFiles[0] 文件内容，hex)>",
-    "specVerdict": "pass",       // pass | fail | cannot_verify
-    "qualityVerdict": "pass",    // pass | fail | cannot_verify
-    "checklist": [               // 扁平数组，逐条对照 design 章节核验
-      { "item": "背景与目标", "result": "pass", "note": "..." }   // result: pass | gap | fail
-    ],
-    "requiredEvidence": [],      // cannot_verify 时必填非空
-    "reviewerNotes": "..."
-  }
-  ```
-
-- `docHash` = `sha256(主审查文档内容)`（hex）—— brainstorm 主文档是 `design.md`（即 `reviewedFiles[0]`）。CLI 重算 sha256 比对，不符判伪造（fail-closed）。改 design.md 后须重算 docHash。`tier=self`（≤3 文件）降级为当前 agent 自审，不强制独立子代理。
-- 运行时 CLI 会把精确 schema 表 + 完整 JSON 示例 + docHash 算法注入到该步 prompt，以你实际收到的注入版契约为权威逐字模板。
-
-## 铁律
-
-- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
-- 只做当前步骤 prompt 描述的操作，不跳过、不自行扩展
-- 产物写入 CLI 输出的 `changeDir` 目录（如 `<changeDir>/design.md`），不要自己拼路径
-- 完成后立即 `--done`，不跳过
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:brainstorm
+description: 用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案（design/proposal/requirements/tasks 四件套），但不直接写代码。
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。** 不要用编号列表让用户手动输入数字。
+
+## 何时使用
+
+- 用户提出新功能、新模块、架构调整、复杂改造
+- 用户说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"
+- 产出：`design.md` + `proposal.md` + `requirements.md` + `tasks.md`（四件套），不写代码
+
+## 多变更说明
+
+项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。建议变更名格式：`YYYY-MM-DD-<简短描述>`。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec brainstorm` 是 `sillyspec run brainstorm` 的顶层别名，两者等价。
+
+```bash
+sillyspec run brainstorm                       # 输出当前步骤 prompt
+sillyspec run brainstorm --done --output "摘要"     # 完成当前步骤（--input "用户原话" 记录输入）
+sillyspec run brainstorm --status              # 查看阶段进度
+sillyspec run brainstorm --skip                # 跳过可选步骤
+sillyspec run brainstorm --reset               # 重置阶段（从头开始）
+sillyspec run brainstorm --reopen --from-step N     # 重新打开已完成阶段修订（N=序号或名称）
+sillyspec run brainstorm --wait --reason "..." --options "A,B"   # 暂停等用户决策
+sillyspec run brainstorm --continue --answer "..."               # 恢复等待中的步骤
+sillyspec run brainstorm --done --answer "..." --output "..."    # 一步完成 wait+done
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--interactive` | 强制交互（即便 stdin 非 TTY） |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
+
+## brainstorm 特有：requiresWait 步骤
+
+某些步骤（如"对话式探索与需求澄清"）需要用户输入。两种方式：
+
+> 自动去重：若前置 step 已对同一问题（waitReason 归一化后相同）确认过，后续重复 wait 会自动跳过，无需再 `--wait`。
+
+- **方式一（推荐）**：分步——先 `--wait` 记录等待，让用户亲眼看到 CLI 打出的选项再作答，再 `--continue --answer`，最后 `--done`：
+  ```bash
+  sillyspec run brainstorm --wait --change <名> --reason "等待用户回答" --output "探索问题"
+  sillyspec run brainstorm --continue --answer "用户回答" --change <名>
+  sillyspec run brainstorm --done --change <名> --output "需求已澄清"
+  ```
+- **方式二**：AI 自行与用户交互后，一步完成（仅在用户已在对话中明确给出答案、无需再走 CLI 等待展示时用）：
+  ```bash
+  sillyspec run brainstorm --done --change <名> --answer "用户回答" --output "需求已澄清"
+  ```
+
+> ⚠️ 两种方式都要求 `--answer` 是**用户真实的回答**，不是你替用户编的回答。`requiresWait` 门只校验 `--answer` 非空，挡不住「AI 伪造用户回答」——所以对方案选择/设计确认这类关键决策，优先用方式一让用户亲手作答，而不是 AI 中继一句话带过。
+
+## 阶段流转
+
+```
+                ┌─ scale=large → plan（四件套齐）
+scan → brainstorm ┤
+                └─ scale=small → quick --linked-changes（仅 design.md）
+```
+
+brainstorm 完成时按 design.md frontmatter 的 `scale` 分叉：
+- **large**（多文件/跨模块/有状态机或 schema 变更）：四件套齐 + Design Grill 审查通过（tier=independent 时由独立审查子代理产出 stage review.json）→ `sillyspec run plan --change <变更名>`
+- **small**（≤2 文件、单模块、无跨模块依赖）：仅生成 design.md → `sillyspec run quick --linked-changes <变更名>`
+
+> 规模由 AI 在 brainstorm 最后一步评估并写入 design.md frontmatter。判错可手动改 `scale` 后再跑相应阶段。
+
+### Stage Review Gate（brainstorm 末尾的 design review.json）
+
+brainstorm 在 `tier=independent` 规模下除 design.md 等四件套外，还需产出一个 stage 级 `review.json`，CLI `Stage Review Gate` 硬校验其 schema 与 `docHash` 真实性。
+
+- 路径：`.sillyspec/.runtime/stage-reviews/brainstorm-review-<stage-review-run-id>/review.json`（目录可能不存在需手建；run-id 由该步 `--done` prompt 输出指定）。marker 文件 `.runtime/current-stage-review-run-id-brainstorm-<变更名>`。
+- **run-id / marker 由 CLI 自动生成注入**（review step prompt 渲染时 echo 完整目录路径 + 写 marker；撞 gate 报缺 review.json 时 gate 也 echo 完整路径 + 写 marker）。直接用 CLI 给的路径写 review.json，**勿手算 run-id（必须 `review-` 前缀）、勿手写 marker**。卡住时用 `sillyspec register-stage-review --change <名> --stage brainstorm` 一步生成。
+- 字段（`schemaVersion:1`，`reviewType=design` —— 区别于 execute 的 `acceptance`）：
+
+  ```json
+  {
+    "schemaVersion": 1,
+    "reviewType": "design",
+    "reviewedFiles": ["changes/<变更名>/design.md"],   // [0] 为主文档
+    "docHash": "<sha256(reviewedFiles[0] 文件内容，hex)>",
+    "specVerdict": "pass",       // pass | fail | cannot_verify
+    "qualityVerdict": "pass",    // pass | fail | cannot_verify
+    "checklist": [               // 扁平数组，逐条对照 design 章节核验
+      { "item": "背景与目标", "result": "pass", "note": "..." }   // result: pass | gap | fail
+    ],
+    "requiredEvidence": [],      // cannot_verify 时必填非空
+    "reviewerNotes": "..."
+  }
+  ```
+
+- `docHash` = `sha256(主审查文档内容)`（hex）—— brainstorm 主文档是 `design.md`（即 `reviewedFiles[0]`）。CLI 重算 sha256 比对，不符判伪造（fail-closed）。改 design.md 后须重算 docHash。`tier=self`（≤3 文件）降级为当前 agent 自审，不强制独立子代理。
+- 运行时 CLI 会把精确 schema 表 + 完整 JSON 示例 + docHash 算法注入到该步 prompt，以你实际收到的注入版契约为权威逐字模板。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- 只做当前步骤 prompt 描述的操作，不跳过、不自行扩展
+- 产物写入 CLI 输出的 `changeDir` 目录（如 `<changeDir>/design.md`），不要自己拼路径
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

package/.claude/skills/sillyspec-commit/SKILL.md

@@ -1,109 +1,109 @@
----
-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/<project>/scan/*.md → scan 产出
-- changes/<name>/design.md → brainstorm 产出
-- changes/<name>/proposal.md → brainstorm 产出
-- changes/<name>/tasks.md → plan 产出
-- changes/<name>/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 后直接提交（不需手动确认）
+---
+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/<project>/scan/*.md → scan 产出
+- changes/<name>/design.md → brainstorm 产出
+- changes/<name>/proposal.md → brainstorm 产出
+- changes/<name>/tasks.md → plan 产出
+- changes/<name>/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 后直接提交（不需手动确认）