sillyspec 3.7.17 → 3.7.18

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

@@ -3,75 +3,9 @@ name: sillyspec:archive
 description: 归档变更 — 规范沉淀，可追溯
 ---
 
-## 交互规范
+## 执行
+运行 `sillyspec run archive`，按提示逐步执行。
+每步完成后运行 `sillyspec run archive --done --output "摘要"`。
 
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-不要用编号列表让用户手动输入数字。
-如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
-
-你现在是 SillySpec 的归档器。
-
-## 变更名称
+## 用户指令
 $ARGUMENTS
-
-## 流程
-
-### 1. 任务完成度检查
-
-检查 tasks.md 中所有 checkbox 是否已勾选。如有遗漏 → 询问用户是否继续归档。
-
-### 2. 归档
-
-### 3. 确认归档
-
-在移动文件之前，展示即将归档的内容：
-- 变更目录名
-- 包含的文件列表
-- 生成总结
-
-**归档前确认：**
-
-请确认是否执行归档：
-1. 确认归档
-2. 取消
-
-将 `.sillyspec/changes/<change-name>/` 移动到 `.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/`。
-
-### 3. 更新 tasks.md
-
-确保所有 checkbox 都已勾选。如有遗漏 → 打勾。
-
-### 4. 更新路线图（如存在）
-
-如果 `.sillyspec/ROADMAP.md` 存在，标记对应 Phase 为已完成。
-
-### 5. Git 提交
-
-```bash
-git add .sillyspec/
-git commit -m "docs: archive sillyspec change <change-name>"
-```
-
-### 最后说：
-
-> ✅ 变更 `<change-name>` 已归档。
->
-> 累积规范：
-> - `.sillyspec/changes/archive/` — X 个已归档变更
-> - `.sillyspec/specs/` — X 份设计文档
-> - `.sillyspec/plans/` — X 份实现计划
->
-> 继续下一个：`/sillyspec:brainstorm "新想法"`
-
-### 更新 progress.json
-
-archive 完成后，**必须自动更新进度**：
-```bash
-sillyspec progress complete-stage <当前阶段>
-```
-
-- 清除当前变更信息（归档后不再活跃）
-- 如果是主变更（有 MASTER.md），标记所有阶段为 ✅，然后清除
-- 历史记录追加时间 + 归档完成
-- 下一步改为 `/sillyspec:brainstorm "新想法"` 或留空

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

@@ -3,100 +3,9 @@ name: sillyspec:quick
 description: 快速任务 — 跳过完整流程，直接做
 ---
 
-## 交互规范
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+## 执行
+运行 `sillyspec run quick`，按提示逐步执行。
+每步完成后运行 `sillyspec run quick --done --output "摘要"`。
 
-## 核心约束（必须遵守）
-- ❌ 不写测试（底线是仍然要写测试）
-- ❌ 修改无关文件
-- ❌ 跳过测试因为"任务太简单"
-
-## 用法
-
-- `/sillyspec:quick "修复用户创建接口漏了手机号校验"` — 独立记录到按用户名隔离的 QUICKLOG
-- `/sillyspec:quick --change user-module "修复用户创建接口漏了手机号校验"` — 追加到 user-module 变更的 tasks.md
-
-## 任务
+## 用户指令
 $ARGUMENTS
-
----
-
-## 流程
-
-1. **解析参数：** 检查是否携带 `--change <变更名>`，确定记录方式
-2. **理解任务：** 模糊则问一个问题确认
-3. **加载上下文：** `cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null`
-4. **知识库查询（强制步骤）：**
-   ```bash
-   cat .sillyspec/knowledge/INDEX.md 2>/dev/null
-   ```
-   根据当前任务描述中的关键词匹配 INDEX.md 条目，命中时 `cat` 对应知识文件，将内容纳入后续开发考量。未命中则跳过。
-5. **文档/代码查询（强制步骤）：** 如果涉及不熟悉的库/框架/API：
-   - 通过 Context7 MCP 查询官方文档
-   - 如果文档不足，通过 grep.app MCP 搜索 GitHub 开源代码
-   - 将查询结果纳入后续开发考量
-6. **先读后写：** 调用已有方法前 `cat` 源文件确认签名，`grep` 确认方法存在
-7. **TDD 执行：**
-   ```
-   🔴 RED    → 先写测试，运行确认失败
-   🟢 GREEN  → 写最少代码让测试通过
-   🔵 REFACTOR → 清理，保持测试通过
-   ✅ STAGE   → git add 暂存（测试文件必须包含在暂存中）
-   ```
-   测试文件必须保留在项目中，不能删除。违反 TDD → 删掉代码从测试重新开始。
-   - 纯配置/数据/文档可跳过 TDD
-   - 其他情况一律走 TDD
-8. **运行测试：** 先检查 local.yaml 构建命令配置：
-```bash
-cat .sillyspec/local.yaml 2>/dev/null
-```
-如果有则使用 local.yaml 中的命令；否则使用默认命令：
-```bash
-mvn test -pl <模块> -Dtest=<测试类> 2>/dev/null || ./gradlew test --tests <测试类> 2>/dev/null || pnpm test 2>/dev/null || npm test 2>/dev/null || pytest <测试文件> 2>/dev/null
-```
-9. **Git 暂存：** `git add -A`。**不要 commit**，由用户通过 `/sillyspec:commit` 统一提交。**工作区模式下，确认当前在正确的子项目目录中执行暂存。**
-10. **记录：**
-   - **有 `--change`：** 在 `.sillyspec/changes/<变更名>/tasks.md` 追加 task 并勾选，**记录精确到秒的时间戳**：
-
-```
-- [x] [YYYY-MM-DD HH:MM:SS] 任务描述
-```
-   - **无 `--change`：** 记录到 `.sillyspec/quicklog/QUICKLOG-<git用户名>.md`（见下方规则）
-11. **检查复杂度：** 任务比预期复杂 → 建议用完整流程
-
-12. **记录发现的坑：** 执行过程中如果发现项目特有的规律、陷阱或约定（如"某方法参数顺序容易搞反"、"某表有隐藏软删除字段"），追加到 `.sillyspec/knowledge/uncategorized.md`，格式：
-
-```markdown
-### [待确认] {简短标题}
-> 来源：quick / {时间戳}
-
-{坑的具体描述}
-```
-
-**工作区模式下：** 只影响当前子项目 → 写入当前子项目 `.sillyspec/knowledge/uncategorized.md`；影响多个子项目 → 写入工作区根目录 `.sillyspec/knowledge/uncategorized.md`。
-
-13. **知识库审阅提示：** 如果本次执行向 knowledge/ 写入了新条目，提示用户：
-> 📚 本次 quick 发现了新知识，请审阅：`cat .sillyspec/knowledge/uncategorized.md`
-> 确认后请将 `[待确认]` 改为 `[已确认]`，并可归类到 knowledge/ 下的专题文件中更新 INDEX.md。
-
-### QUICKLOG 规则
-
-**按 git 用户名隔离，避免多人同时操作冲突：**
-
-```bash
-USER=$(git config user.name 2>/dev/null || echo "default")
-LOG_FILE=".sillyspec/quicklog/QUICKLOG-${USER}.md"
-```
-
-文件路径：`$LOG_FILE`
-
-**追加记录格式（时间精确到秒）：**
-```markdown
-## YYYY-MM-DD HH:MM:SS | fix: 任务描述
-- 文件：`修改的文件列表`
-- 关联归档：`相关的已归档变更名`（如有）
-```
-
-**文件轮转：** 追加前检查文件大小，超过 500 行则：
-1. 将当前文件重命名为 `QUICKLOG-${USER}-YYYY-MM-DD.md`
-2. 创建新的空 `QUICKLOG-${USER}.md`

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

@@ -1,140 +1,11 @@
-## 交互规范
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-你现在是 SillySpec 代码库扫描器（编排器）。**你不读源码，只编排子代理或串行执行。**
-
-## 参数处理
-- 空白 → 交互式引导（逐步询问）
-- `--deep` → 直接深度扫描
-- 其他 → 快速扫描该区域
-
-## 流程控制（必须先执行）
-
-```bash
-sillyspec status --json
-```
-
-非 `init` phase → 以 CLI 返回为准决定下一步。
-
----
-
-## 交互式引导（参数为空时）
-
-### 检查工作区 & 已有文档
-
-```bash
-ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .   # 有 .yaml → 工作区模式
-ls docs/*/scan/ 2>/dev/null       # 检查已有文档
-wc -l docs/*/scan/*.md 2>/dev/null
-```
-
-- 已有 3 份 → 建议升级深度扫描
-- 已有 7 份 → 建议刷新或跳过
-- 工作区 → 逐个扫描 / 选子项目 / 退出
-
-### 选择扫描模式、范围、排除目录、确认
-按原流程交互，确认后进入扫描。
-
----
-
-## 构建环境探测（主代理执行）
-
-```bash
-cat package.json pom.xml build.gradle go.mod Cargo.toml requirements.txt pyproject.toml Gemfile composer.json 2>/dev/null
-find . -maxdepth 2 -name "*.config.*" -not -path "*/node_modules/*" -not -path "*/.git/*" | head -20 | xargs cat 2>/dev/null
-```
-
-结果保存到 `docs/<project>/scan/_env-detect.md`（临时文件，扫描完删除）。
-
----
-
-## 深度扫描
-
-```bash
-PROJECT=$(python3 -c "import sys,json; print(json.load(open('.sillyspec/.runtime/progress.json')).get('project',''))" 2>/dev/null || basename "$(pwd)")
-mkdir -p docs/${PROJECT}/scan
-```
-
-### 断点续扫
-
-```bash
-PROJECT=$(python3 -c "import sys,json; print(json.load(open('.sillyspec/.runtime/progress.json')).get('project',''))" 2>/dev/null || basename "$(pwd)")
-for f in ARCHITECTURE STRUCTURE CONVENTIONS INTEGRATIONS TESTING CONCERNS PROJECT; do
-  [ -f "docs/${PROJECT}/scan/${f}.md" ] && echo "✅ ${f}.md" || echo "⬜ ${f}.md"
-done
-```
-
-只生成缺失的文档。
-
-### 检测子代理可用性
-检查是否有 Task/Spawn 工具。有 → 子代理模式，无 → 串行模式。
-
 ---
-
-### 子代理模式（4 个并行）
-
-#### Agent 1: tech → ARCHITECTURE.md
-扫描技术栈 + 数据库 Schema + 架构模式。参考 `_env-detect.md`。
-用 grep/rg 搜索（`@Entity`、`schema.prisma`、`models.py` 等），**禁止读源码全文**。
-Schema 只记表名+说明+字段数。含 `## 技术栈` `## 架构概览` `## 数据模型（摘要）`。路径用反引号，不编造。
-
-#### Agent 2: conventions → CONVENTIONS.md
-扫描框架隐形规则 + 实体继承 + 代码风格。参考 `_env-detect.md`。
-用 grep 搜索拦截器/插件/逻辑删除/基类/审计字段，**禁止读源码全文**。
-根据检测到的语言/框架自行决定搜索什么模式，提取 3-5 个典型示例。
-含 `## 框架隐形规则` `## 实体继承规范` `## 代码风格`。路径用反引号，不编造。
-
-#### Agent 3: structure → STRUCTURE.md + INTEGRATIONS.md
-扫描目录结构 + 外部集成。参考 `_env-detect.md`。
-用 find/ls/tree 和 grep，**禁止读源码全文**。
-搜索 API 调用、MQ 配置、缓存、第三方 SDK。STRUCTURE.md 含目录树+模块说明。INTEGRATIONS.md 按类型分组。路径用反引号，不编造。
-
-#### Agent 4: quality → TESTING.md + CONCERNS.md + PROJECT.md
-扫描测试现状 + 技术债务 + 项目概览。参考 `_env-detect.md`。
-用 grep 搜索测试文件、TODO/FIXME、过时依赖，**禁止读源码全文**。
-TESTING.md 含测试结构。CONCERNS.md 按严重程度分组。PROJECT.md 含项目信息。路径用反引号，不编造。
-
+name: sillyspec:scan
+description: 代码扫描 — 分析项目结构、约定和架构
 ---
 
-### 串行模式（降级）
-无子代理时，按 tech → conventions → structure → quality 顺序执行。
-每个 area 完成后**立即写文件**，下一个 area 开始前清除源码上下文。
-
----
-
-## 工作区模式
-对每个子项目：cd → 环境探测 → 扫描 → cd 回工作区。
-全部完成后汇总 `.sillyspec/workspace/CODEBASE-OVERVIEW.md`（只读各子项目的 ARCHITECTURE.md + CONVENTIONS.md）。
-
----
-
-## 扫描完成
-
-```bash
-# 路径校验
-PROJECT=$(python3 -c "import sys,json; print(json.load(open('.sillyspec/.runtime/progress.json')).get('project',''))" 2>/dev/null || basename "$(pwd)")
-for f in ARCHITECTURE STRUCTURE CONVENTIONS INTEGRATIONS TESTING CONCERNS PROJECT; do
-  [ -f "docs/${PROJECT}/scan/${f}.md" ] && echo "✅ ${f}.md"
-done
-
-# 验证 CLI
-sillyspec status --json   # 应返回 phase: "brainstorm"
-sillyspec next            # 推荐给用户
-
-# 清理 + 提交
-rm -f docs/${PROJECT}/scan/_env-detect.md
-git add . && git commit -m "chore: sillyspec scan - codebase mapped"
-```
-
-### 自检门控
-- [ ] ARCHITECTURE.md：技术栈 + Schema 摘要？
-- [ ] CONVENTIONS.md：隐形规则 + 代码风格？
-- [ ] STRUCTURE.md：目录结构？
-- [ ] INTEGRATIONS.md：外部依赖？
-- [ ] TESTING.md：测试现状？
-- [ ] CONCERNS.md：技术债务？
-- [ ] PROJECT.md：项目概览？
+## 执行
+运行 `sillyspec run scan`，按提示逐步执行。
+每步完成后运行 `sillyspec run scan --done --output "摘要"`。
 
-## 绝对规则
-- ❌ 修改代码 / 编造路径 / 主代理读源码全文
-- ✅ 交互模式每步等用户 / 文档只写 `docs/<project>/scan/`
+## 用户指令
+$ARGUMENTS

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

@@ -3,129 +3,9 @@ name: sillyspec:status
 description: 查看项目进度和状态
 ---
 
----
-
-你现在是 SillySpec 的状态检查器。
-
-## 流程
-
-### 0: 检查工作区模式
-
-```bash
-ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
-```
-
-**如果是工作区模式：**
-
-1. 读取 projects/*.yaml 获取子项目列表：
-   ```bash
-   for f in .sillyspec/projects/*.yaml; do
-     [ -f "$f" ] || continue
-     proj_name=$(basename "$f" .yaml)
-     proj_path=$(grep '^path:' "$f" | head -1 | sed 's/^path:[[:space:]]*//')
-   done
-   ```
-2. 对每个子项目执行 Step 1-5 的检查（在子项目目录下）
-3. 检查共享规范：
-   ```bash
-   ls .sillyspec/shared/ 2>/dev/null
-   ```
-4. 检查工作区概览：
-   ```bash
-   ls .sillyspec/workspace/ 2>/dev/null
-   ```
-5. 输出汇总：
-
-```
-🏢 工作区状态
-
-📦 子项目：
-
-  ✅ frontend  ./frontend
-     📋 项目：已初始化
-     📂 代码库：已扫描（7 份文档）
-     🔄 进行中：1 个变更
-        - [user-auth] Phase 3 (Execute) — tasks 5/8
-     ✅ 已归档：3 个变更
-
-  ⚠️ backend   ./backend
-     📋 项目：已初始化
-     📂 代码库：未扫描
-     🔄 进行中：0 个变更
-
-📄 共享规范：2 份
-  - api-contract.md
-  - data-models.md
-
-💡 下一步：
-  - 扫描 backend：/sillyspec:scan backend
-  - 继续开发：/sillyspec:continue
-```
-
-然后结束，不执行下面的单项目流程。
-
-**如果不是工作区模式：** 继续下面的单项目流程。
-
-### 1. 项目基础
-
-```bash
-cat .sillyspec/PROJECT.md 2>/dev/null || echo "未初始化"
-PROJECT=$(python3 -c "import sys,json; print(json.load(open('.sillyspec/.runtime/progress.json')).get('project',''))" 2>/dev/null || basename "$(pwd)")
-ls docs/${PROJECT}/scan/ 2>/dev/null | head -10
-cat .sillyspec/REQUIREMENTS.md 2>/dev/null | head -20
-cat .sillyspec/ROADMAP.md 2>/dev/null
-```
-
-### 2. 进行中的变更
-
-```bash
-ls .sillyspec/changes/ 2>/dev/null | grep -v archive
-```
-
-对每个进行中的变更，检查文件完成度：
-- proposal.md ✅/❌
-- design.md ✅/❌
-- specs/requirements.md ✅/❌
-- tasks.md — X/Y 完成
-- 对应计划 .sillyspec/plans/ ✅/❌
-
-### 3. 归档历史
-
-```bash
-ls .sillyspec/changes/archive/ 2>/dev/null | wc -l
-```
-
-### 4. 中断状态
-
-```bash
-cat .sillyspec/HANDOFF.json 2>/dev/null
-```
-
-### 5. 代码库文档
-
-```bash
-PROJECT=$(python3 -c "import sys,json; print(json.load(open('.sillyspec/.runtime/progress.json')).get('project',''))" 2>/dev/null || basename "$(pwd)")
-ls docs/${PROJECT}/scan/ 2>/dev/null
-```
-
-### 6. 输出
-
-```
-📊 SillySpec 状态
-
-📋 项目：xxx（已初始化 / 未初始化）
-📂 代码库：已扫描（7 份文档）/ 未扫描
-
-🔄 进行中：N 个变更
-  - [change-1] Phase 3 (Execute) — tasks 5/8
-  - [change-2] Phase 2 (Propose) — 缺少 design.md
-
-✅ 已归档：N 个变更
-📝 设计文档：N 份
-📝 实现计划：N 份
-
-💡 下一步：/sillyspec:continue
-```
+## 执行
+运行 `sillyspec run status`，按提示逐步执行。
+每步完成后运行 `sillyspec run status --done --output "摘要"`。
 
-## 绝对规则
-- 不修改任何文件
+## 用户指令
+$ARGUMENTS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.7.17",
+  "version": "3.7.18",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",

package/src/progress.js

@@ -17,7 +17,7 @@ const PROGRESS_FILE = 'progress.json';
 const BACKUP_FILE = 'progress.json.bak';
 
 const CURRENT_VERSION = 2;
-const VALID_STAGES = ['brainstorm', 'propose', 'plan', 'execute', 'verify'];
+const VALID_STAGES = ['brainstorm', 'propose', 'plan', 'execute', 'verify', 'scan', 'quick', 'archive', 'status'];
 const VALID_STATUSES = ['pending', 'in-progress', 'completed', 'failed', 'blocked'];
 
 const STAGE_LABELS = {
@@ -26,6 +26,10 @@ const STAGE_LABELS = {
   plan: '📐 实现计划',
   execute: '⚡ 波次执行',
   verify: '🔍 验证确认',
+  scan: '🔍 代码扫描',
+  quick: '⚡ 快速任务',
+  archive: '📦 归档变更',
+  status: '📊 状态查看',
 };
 
 function emptyStage() {

package/src/run.js

@@ -6,7 +6,7 @@
 import { basename, join } from 'path'
 import { existsSync, readdirSync, mkdirSync, writeFileSync } from 'fs'
 import { ProgressManager } from './progress.js'
-import { stageRegistry, getNextStage } from './stages/index.js'
+import { stageRegistry, getNextStage, auxiliaryStages } from './stages/index.js'
 import { buildExecuteSteps } from './stages/execute.js'
 
 /**
@@ -76,6 +76,11 @@ function outputStep(stageName, stepIndex, steps, cwd) {
   console.log(`---\n`)
   console.log(`## Step ${stepIndex + 1}/${total}: ${step.name}\n`)
   console.log(step.prompt)
+  console.log(`\n### ⚠️ 铁律`)
+  console.log('- 只做本步骤描述的操作，不得自行扩展或跳过')
+  console.log('- 不要回头修改已完成的步骤')
+  console.log('- 完成后立即执行 --done 命令，不得跳过')
+  console.log('- 生成的文件头部必须包含 author（git 用户名）和 created_at（精确到秒）')
   console.log(`\n### 完成后执行`)
   console.log(`sillyspec run ${stageName} --done --output "你的摘要"`)
 }
@@ -106,12 +111,18 @@ export function runCommand(args, cwd) {
     outputText = flags[outputIdx + 1]
   }
 
+  const isAuxiliary = auxiliaryStages.includes(stageName)
+
   const pm = new ProgressManager()
   let progress = pm.read(cwd)
 
   if (!progress) {
-    console.error('❌ 未找到 progress.json，请先运行 sillyspec init')
-    process.exit(1)
+    // 辅助命令可以在没有 progress.json 时工作（比如 scan）
+    if (!isAuxiliary) {
+      console.error('❌ 未找到 progress.json，请先运行 sillyspec init')
+      process.exit(1)
+    }
+    progress = pm.init(cwd)
   }
 
   // --reset

package/src/stages/archive.js

@@ -0,0 +1,54 @@
+export const definition = {
+  name: 'archive',
+  title: '归档变更',
+  description: '规范沉淀，可追溯',
+  auxiliary: true,
+  steps: [
+    {
+      name: '任务完成度检查',
+      prompt: `检查 tasks.md 中所有 checkbox 是否已勾选。
+
+### 操作
+1. 读取 \`.sillyspec/changes/<change-name>/tasks.md\`
+2. 检查所有 checkbox 是否已勾选
+3. 如有遗漏 → 询问用户是否继续归档
+
+### 输出
+完成度报告`,
+      outputHint: '完成度报告',
+      optional: false
+    },
+    {
+      name: '确认归档',
+      prompt: `展示即将归档的内容，请用户确认。
+
+### 操作
+1. 展示：变更目录名、包含的文件列表、生成总结
+2. 请用户确认是否执行归档
+3. 确认后：将 \`.sillyspec/changes/<change-name>/\` 移动到 \`.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/\`
+4. 确保所有 checkbox 都已勾选
+
+### 输出
+归档确认`,
+      outputHint: '归档确认',
+      optional: false
+    },
+    {
+      name: '更新路线图和提交',
+      prompt: `更新路线图并 Git 提交。
+
+### 操作
+1. 如果 \`.sillyspec/ROADMAP.md\` 存在，标记对应 Phase 为已完成
+2. \`git add .sillyspec/ && git commit -m "docs: archive sillyspec change <change-name>"\`
+3. 更新 progress.json：
+   - 清除当前变更信息（归档后不再活跃）
+   - 如果是主变更（有 MASTER.md），标记所有阶段为 ✅，然后清除
+   - 历史记录追加时间 + 归档完成
+
+### 输出
+归档完成确认 + 累积规范统计`,
+      outputHint: '归档完成',
+      optional: false
+    }
+  ]
+}

package/src/stages/index.js

@@ -3,16 +3,24 @@ import { definition as propose } from './propose.js'
 import { definition as plan } from './plan.js'
 import { definition as execute } from './execute.js'
 import { definition as verify } from './verify.js'
+import { definition as scan } from './scan.js'
+import { definition as quick } from './quick.js'
+import { definition as archive } from './archive.js'
+import { definition as status } from './status.js'
 
 export const stageRegistry = {
   brainstorm,
   propose,
   plan,
   execute,
-  verify
+  verify,
+  scan,
+  quick,
+  archive,
+  status
 }
 
-// 阶段顺序，用于 getNextStage
+// 流程阶段顺序，用于 getNextStage
 const stageOrder = ['brainstorm', 'propose', 'plan', 'execute', 'verify']
 
 export function getNextStage(currentStage) {
@@ -20,3 +28,6 @@ export function getNextStage(currentStage) {
   if (index === -1 || index >= stageOrder.length - 1) return null
   return stageOrder[index + 1]
 }
+
+// 辅助命令（不影响流程阶段推进）
+export const auxiliaryStages = ['scan', 'quick', 'archive', 'status']

package/src/stages/quick.js

@@ -0,0 +1,93 @@
+export const definition = {
+  name: 'quick',
+  title: '快速任务',
+  description: '跳过完整流程，直接做',
+  auxiliary: true,
+  steps: [
+    {
+      name: '解析参数和上下文',
+      prompt: `解析任务参数，加载项目上下文。
+
+### 操作
+1. 检查是否携带 \`--change <变更名>\`，确定记录方式
+2. 理解任务：模糊则问一个问题确认
+3. 加载上下文：\`cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null\`
+4. 加载扫描文档（如存在）：\`cat docs/<project>/scan/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null\`
+
+### 输出
+任务理解 + 上下文摘要`,
+      outputHint: '任务理解',
+      optional: false
+    },
+    {
+      name: '知识库和文档查询',
+      prompt: `查询知识库和外部文档。
+
+### 操作
+1. \`cat .sillyspec/knowledge/INDEX.md 2>/dev/null\` — 根据关键词匹配
+2. 命中时 \`cat\` 对应知识文件
+3. 如果涉及不熟悉的库/框架/API：通过 Context7 查询官方文档
+4. 将查询结果纳入后续开发考量
+
+### 输出
+相关知识条目和文档查询结果`,
+      outputHint: '知识查询结果',
+      optional: true
+    },
+    {
+      name: 'TDD 实现',
+      prompt: `按 TDD 流程实现任务。
+
+### 操作
+1. 先读后写：调用已有方法前 \`cat\` 源文件确认签名，\`grep\` 确认方法存在
+2. 🔴 RED → 先写测试，运行确认失败
+3. 🟢 GREEN → 写最少代码让测试通过
+4. 🔵 REFACTOR → 清理，保持测试通过
+5. ✅ STAGE → git add 暂存（测试文件必须包含）
+
+### 纯配置/数据/文档可跳过 TDD，其他一律走 TDD。
+
+### 输出
+实现摘要 + 修改文件列表
+
+### 铁律
+- ❌ 不写测试（底线是仍然要写测试）
+- ❌ 修改无关文件
+- ❌ 跳过测试因为"任务太简单"`,
+      outputHint: '实现摘要',
+      optional: false
+    },
+    {
+      name: '运行测试',
+      prompt: `运行测试确认通过。
+
+### 操作
+1. 检查 local.yaml 构建命令配置：\`cat .sillyspec/local.yaml 2>/dev/null\`
+2. 有则使用 local.yaml 中的命令，否则使用默认命令
+3. 默认命令：\`mvn test -pl <模块> -Dtest=<测试类>\` 或 \`./gradlew test --tests <测试类>\` 或 \`pnpm test\` 或 \`npm test\` 或 \`pytest <测试文件>\`
+
+### 输出
+测试通过/失败结果`,
+      outputHint: '测试结果',
+      optional: false
+    },
+    {
+      name: '暂存和记录',
+      prompt: `Git 暂存并记录任务。
+
+### 操作
+1. \`git add -A\` — **不要 commit**，由用户通过统一提交
+2. 记录：
+   - 有 \`--change\`：在 \`.sillyspec/changes/<变更名>/tasks.md\` 追加 task 并勾选，记录精确到秒的时间戳
+   - 无 \`--change\`：记录到 \`.sillyspec/quicklog/QUICKLOG-<git用户名>.md\`（按 git 用户名隔离）
+3. QUICKLOG 轮转：超过 500 行则重命名为 \`QUICKLOG-<USER>-YYYY-MM-DD.md\`
+4. 如果发现项目特有的坑，追加到 \`.sillyspec/knowledge/uncategorized.md\`
+5. 任务比预期复杂 → 建议用完整流程
+
+### 输出
+暂存确认 + 记录路径`,
+      outputHint: '暂存和记录确认',
+      optional: false
+    }
+  ]
+}

package/src/stages/scan.js

@@ -0,0 +1,141 @@
+export const definition = {
+  name: 'scan',
+  title: '代码扫描',
+  description: '分析项目结构、约定和架构',
+  auxiliary: true,
+  steps: [
+    {
+      name: '检查工作区和已有文档',
+      prompt: `检查工作区模式和已有扫描文档。
+
+### 操作
+1. \`ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .\` — 判断是否工作区模式
+2. \`ls docs/*/scan/ 2>/dev/null\` — 检查已有文档
+3. \`wc -l docs/*/scan/*.md 2>/dev/null\` — 文档行数
+4. 已有 3 份 → 建议升级深度扫描；已有 7 份 → 建议刷新或跳过
+5. 工作区模式 → 询问扫描范围（逐个/选子项目/退出）
+
+### 输出
+工作区模式判断 + 已有文档状态 + 扫描建议`,
+      outputHint: '工作区和文档状态',
+      optional: false
+    },
+    {
+      name: '构建环境探测',
+      prompt: `探测项目的构建环境和依赖。
+
+### 操作
+1. \`cat package.json pom.xml build.gradle go.mod Cargo.toml requirements.txt pyproject.toml Gemfile composer.json 2>/dev/null\`
+2. \`find . -maxdepth 2 -name "*.config.*" -not -path "*/node_modules/*" -not -path "*/.git/*" | head -20 | xargs cat 2>/dev/null\`
+3. 结果保存到 \`docs/<project>/scan/_env-detect.md\`（临时文件，扫描完删除）
+
+### 输出
+环境探测结果摘要`,
+      outputHint: '环境探测摘要',
+      optional: false
+    },
+    {
+      name: '断点续扫检测',
+      prompt: `检测已有扫描文档，只生成缺失的。
+
+### 操作
+1. \`PROJECT=$(python3 -c "import sys,json; print(json.load(open('.sillyspec/.runtime/progress.json')).get('project',''))" 2>/dev/null || basename "$(pwd)")\`
+2. 检查 7 份文档是否存在：ARCHITECTURE、STRUCTURE、CONVENTIONS、INTEGRATIONS、TESTING、CONCERNS、PROJECT
+3. 列出已有 ✅ 和缺失 ⬜
+4. 只生成缺失的文档
+
+### 输出
+已有/缺失文档列表`,
+      outputHint: '断点续扫状态',
+      optional: false
+    },
+    {
+      name: '深度扫描 — 技术架构',
+      prompt: `扫描技术栈 + 数据库 Schema + 架构模式。参考 _env-detect.md。
+
+### 操作
+1. 用 grep/rg 搜索（\`@Entity\`、\`schema.prisma\`、\`models.py\` 等），**禁止读源码全文**
+2. Schema 只记表名+说明+字段数
+3. 写入 \`docs/<project>/scan/ARCHITECTURE.md\`
+4. 包含 \`## 技术栈\` \`## 架构概览\` \`## 数据模型（摘要）\`
+
+### 输出
+ARCHITECTURE.md 路径
+
+### 注意
+- 路径用反引号，不编造`,
+      outputHint: 'ARCHITECTURE.md 路径',
+      optional: false
+    },
+    {
+      name: '深度扫描 — 代码约定',
+      prompt: `扫描框架隐形规则 + 实体继承 + 代码风格。参考 _env-detect.md。
+
+### 操作
+1. 用 grep 搜索拦截器/插件/逻辑删除/基类/审计字段，**禁止读源码全文**
+2. 根据检测到的语言/框架自行决定搜索什么模式
+3. 提取 3-5 个典型示例
+4. 写入 \`docs/<project>/scan/CONVENTIONS.md\`
+5. 包含 \`## 框架隐形规则\` \`## 实体继承规范\` \`## 代码风格\`
+
+### 输出
+CONVENTIONS.md 路径
+
+### 注意
+- 路径用反引号，不编造`,
+      outputHint: 'CONVENTIONS.md 路径',
+      optional: false
+    },
+    {
+      name: '深度扫描 — 目录结构和集成',
+      prompt: `扫描目录结构 + 外部集成。参考 _env-detect.md。
+
+### 操作
+1. 用 find/ls/tree 和 grep，**禁止读源码全文**
+2. 搜索 API 调用、MQ 配置、缓存、第三方 SDK
+3. 写入 \`docs/<project>/scan/STRUCTURE.md\`（目录树+模块说明）
+4. 写入 \`docs/<project>/scan/INTEGRATIONS.md\`（按类型分组）
+
+### 输出
+STRUCTURE.md 和 INTEGRATIONS.md 路径
+
+### 注意
+- 路径用反引号，不编造`,
+      outputHint: 'STRUCTURE.md + INTEGRATIONS.md 路径',
+      optional: false
+    },
+    {
+      name: '深度扫描 — 测试和债务',
+      prompt: `扫描测试现状 + 技术债务 + 项目概览。参考 _env-detect.md。
+
+### 操作
+1. 用 grep 搜索测试文件、TODO/FIXME、过时依赖，**禁止读源码全文**
+2. 写入 \`docs/<project>/scan/TESTING.md\`（测试结构）
+3. 写入 \`docs/<project>/scan/CONCERNS.md\`（按严重程度分组）
+4. 写入 \`docs/<project>/scan/PROJECT.md\`（项目信息）
+
+### 输出
+TESTING.md、CONCERNS.md、PROJECT.md 路径`,
+      outputHint: '三份文档路径',
+      optional: false
+    },
+    {
+      name: '自检和提交',
+      prompt: `验证扫描完整性，清理并提交。
+
+### 操作
+1. 检查 7 份文档是否全部生成
+2. 自检门控：ARCHITECTURE（技术栈+Schema摘要）、CONVENTIONS（隐形规则+代码风格）、STRUCTURE（目录结构）、INTEGRATIONS（外部依赖）、TESTING（测试现状）、CONCERNS（技术债务）、PROJECT（项目概览）
+3. 清理：\`rm -f docs/<project>/scan/_env-detect.md\`
+4. \`git add . && git commit -m "chore: sillyspec scan - codebase mapped"\`
+
+### 输出
+扫描完整性报告 + commit hash
+
+### 注意
+- ❌ 修改代码 / 编造路径 / 读源码全文`,
+      outputHint: '自检报告 + commit hash',
+      optional: false
+    }
+  ]
+}

package/src/stages/status.js

@@ -0,0 +1,92 @@
+export const definition = {
+  name: 'status',
+  title: '状态查看',
+  description: '查看项目进度和状态',
+  auxiliary: true,
+  steps: [
+    {
+      name: '检查工作区模式',
+      prompt: `判断是否为工作区模式。
+
+### 操作
+1. \`ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .\`
+2. 是 → 工作区模式，对每个子项目执行状态检查
+3. 否 → 单项目模式，继续后续步骤
+
+### 工作区模式输出格式：
+\`\`\`
+🏢 工作区状态
+📦 子项目：
+  ✅ frontend  ./frontend
+     📋 项目：已初始化
+     📂 代码库：已扫描（7 份文档）
+     🔄 进行中：1 个变更
+  ⚠️ backend   ./backend
+     📂 代码库：未扫描
+📄 共享规范：2 份
+\`\`\`
+
+### 输出
+工作区/单项目判断`,
+      outputHint: '模式判断',
+      optional: false
+    },
+    {
+      name: '项目基础信息',
+      prompt: `收集项目基础信息。
+
+### 操作
+1. \`cat .sillyspec/PROJECT.md 2>/dev/null || echo "未初始化"\`
+2. 获取 project 名
+3. \`ls docs/<project>/scan/ 2>/dev/null | head -10\`
+4. \`cat .sillyspec/REQUIREMENTS.md 2>/dev/null | head -20\`
+5. \`cat .sillyspec/ROADMAP.md 2>/dev/null\`
+
+### 输出
+项目基础信息摘要`,
+      outputHint: '项目基础信息',
+      optional: false
+    },
+    {
+      name: '变更状态',
+      prompt: `检查进行中的变更和归档历史。
+
+### 操作
+1. \`ls .sillyspec/changes/ 2>/dev/null | grep -v archive\`
+2. 对每个进行中的变更：检查 proposal.md ✅/❌、design.md ✅/❌、requirements.md ✅/❌、tasks.md — X/Y 完成
+3. \`ls .sillyspec/changes/archive/ 2>/dev/null | wc -l\`
+4. \`cat .sillyspec/HANDOFF.json 2>/dev/null\`
+
+### 输出
+变更状态列表`,
+      outputHint: '变更状态',
+      optional: false
+    },
+    {
+      name: '输出状态报告',
+      prompt: `生成完整状态报告。
+
+### 输出格式：
+\`\`\`
+📊 SillySpec 状态
+
+📋 项目：xxx（已初始化 / 未初始化）
+📂 代码库：已扫描（7 份文档）/ 未扫描
+
+🔄 进行中：N 个变更
+  - [change-1] Phase 3 (Execute) — tasks 5/8
+
+✅ 已归档：N 个变更
+📝 设计文档：N 份
+📝 实现计划：N 份
+
+💡 下一步：/sillyspec:continue
+\`\`\`
+
+### 注意
+- 不修改任何文件`,
+      outputHint: '状态报告',
+      optional: false
+    }
+  ]
+}