sillyspec 2.4.0 → 2.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "type": "module",
   "bin": {
@@ -9,6 +9,12 @@
   "engines": {
     "node": ">=18"
   },
-  "keywords": ["sillyspec", "ai", "claude", "cursor", "spec-driven"],
+  "keywords": [
+    "sillyspec",
+    "ai",
+    "claude",
+    "cursor",
+    "spec-driven"
+  ],
   "license": "MIT"
 }

package/templates/archive.md

@@ -18,7 +18,11 @@ $ARGUMENTS
 - 包含的文件列表
 - 生成总结
 
-**等待用户确认后再执行归档操作。**
+**归档前确认：**
+
+请确认是否执行归档：
+1. 确认归档
+2. 取消
 
 将 `.sillyspec/changes/<change-name>/` 移动到 `.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/`。
 

package/templates/brainstorm.md

@@ -42,11 +42,9 @@ cat .sillyspec/config.yaml 2>/dev/null
 
 **如果是工作区模式：**
 1. 询问本次需求属于哪个子项目：
-   ```
    检测到工作区模式，请选择需求所属的子项目：
-     1) frontend — 前端 - Vue3 + TypeScript
-     2) backend — 后端 - Node.js + PostgreSQL
-   ```
+   > 1. frontend — 前端 - Vue3 + TypeScript
+   > 2. backend — 后端 - Node.js + PostgreSQL
 2. 加载该子项目的上下文 + 工作区共享规范：
 
 ```bash

package/templates/explore.md

@@ -61,18 +61,19 @@ cat .sillyspec/ROADMAP.md 2>/dev/null
 读取变更的 proposal、design、tasks，自然地引用它们。
 
 当发现重要的决策时，**提议保存**（不自动保存）：
-> "这是一个设计决策，要写到 design.md 里吗？"
-> "这是新需求，要加到 specs 里吗？"
 
-用户决定是否保存。
+请选择：
+1. 写入 design.md
+2. 加入 specs
+3. 暂不保存
 
 ## 没有必需的结束
 
 探索可以：
-- 流入 proposal："感觉足够成熟了，要创建变更提案吗？"
-- 产出文档更新
-- 只是提供清晰度
-- 稍后继续
+1. 创建变更提案 — 流入 proposal
+2. 产出文档更新
+3. 继续探索
+4. 结束探索
 
 ## 禁止事项
 

package/templates/init.md

@@ -17,12 +17,10 @@ cat .sillyspec/config.yaml 2>/dev/null
 
 如果 config.yaml 存在且包含 `projects` → 工作区模式：
 1. 列出所有子项目：
-   ```
    检测到工作区模式，请选择要初始化的子项目：
-     1) frontend — 前端 - Vue3 + TypeScript
-     2) backend — 后端 - Node.js + PostgreSQL
-     3) 新建子项目（先运行 /sillyspec:workspace add）
-   ```
+   > 1. frontend — 前端 - Vue3 + TypeScript
+   > 2. backend — 后端 - Node.js + PostgreSQL
+   > 3. 新建子项目（先运行 /sillyspec:workspace add）
 2. 用户选择后，**切换到该子项目目录**执行后续所有步骤
 3. 后续步骤中的所有文件路径相对于子项目目录
 

package/templates/resume.md

@@ -33,7 +33,9 @@ cat .sillyspec/STATE.md 2>/dev/null
 
 **不需要执行 Git 操作或文件探测。** STATE.md 已经包含所有信息。
 
-然后问用户：直接继续，还是需要了解更多细节？
+然后问用户：
+> 1. 直接继续执行下一步
+> 2. 查看更多细节
 
 ### 3. 如果没有 STATE.md
 

package/templates/scan.md

@@ -42,12 +42,10 @@ cat .sillyspec/config.yaml 2>/dev/null
 如果 config.yaml 存在且包含 `projects` → 工作区模式：
 
 询问用户：
-```
-检测到工作区模式，请选择扫描范围：
-  1) 全部子项目（逐个扫描后生成汇总）
-  2) 指定某个子项目
-  3) 取消
-```
+> 检测到工作区模式，请选择扫描范围：
+> 1. 全部子项目（逐个扫描后生成汇总）
+> 2. 指定某个子项目
+> 3. 取消
 
 根据选择：
 - 选 1 → 逐个扫描，最后生成 `.sillyspec/workspace/CODEBASE-OVERVIEW.md`
@@ -69,12 +67,10 @@ wc -l .sillyspec/codebase/*.md 2>/dev/null
 → 不提示，直接进入 Step 2 选择扫描模式。
 
 **已有 3 份（STACK + STRUCTURE + PROJECT）：**
-```
-检测到上次的快速扫描结果。
-→ 输入 1 升级为完整扫描（补充 4 份文档）
-→ 输入 2 重新快速扫描（覆盖现有文档）
-→ 输入 3 跳过，直接开始开发
-```
+> 检测到上次的快速扫描结果。
+> 1. 升级为完整扫描（补充 4 份文档）
+> 2. 重新快速扫描（覆盖现有文档）
+> 3. 跳过，直接开始开发
 
 **已有 7 份完整文档：**
 先检查距上次扫描过了多久：
@@ -83,29 +79,23 @@ git log -1 --format="%ci" .sillyspec/codebase/ 2>/dev/null
 git log --oneline --since="上次扫描时间" | wc -l
 ```
 
-```
-上次扫描距今 X 天，期间有 Y 个新提交。
-→ 输入 1 刷新（重新扫描全部）
-→ 输入 2 跳过，直接开始开发
-```
+> 上次扫描距今 X 天，期间有 Y 个新提交。
+> 1. 刷新（重新扫描全部）
+> 2. 跳过，直接开始开发
 
 **用户选跳过** → 输出"可以开始开发了。建议下一步：`/sillyspec:brainstorm '你的需求'`"然后结束。
 
 ### Step 2: 选择扫描模式
 
-```
 请选择扫描模式：
 
-  1. 快速扫描 ⚡
-     读取配置文件和目录结构，约 30 秒
-     生成 3 份文档：技术栈 + 目录结构 + 项目概览
-
-  2. 深度扫描 🔍
-     读取全部源代码并分析，约 2-3 分钟
-     生成 7 份文档：技术栈 + 架构 + 目录结构 + 编码约定 + 集成 + 测试 + 技术债务
-
-  3. 取消
-```
+> 1. 快速扫描 ⚡
+>    读取配置文件和目录结构，约 30 秒
+>    生成 3 份文档：技术栈 + 目录结构 + 项目概览
+> 2. 深度扫描 🔍
+>    读取全部源代码并分析，约 2-3 分钟
+>    生成 7 份文档：技术栈 + 架构 + 目录结构 + 编码约定 + 集成 + 测试 + 技术债务
+> 3. 取消
 
 根据选择进入对应的扫描流程。
 
@@ -140,14 +130,9 @@ git log --oneline --since="上次扫描时间" | wc -l
 
 把以上选择汇总，让用户最后确认：
 
-```
-扫描计划确认：
-  模式：深度扫描
-  范围：整个项目
-  排除：node_modules, dist, .git, vendor, build, __pycache__, .next, coverage, .nuxt, target
-
-开始扫描？（输入 y 确认，或修改以上选项）
-```
+开始扫描？
+> 1. 确认，开始扫描
+> 2. 修改选项
 
 用户确认 → 执行扫描。用户想改 → 回到对应步骤。
 

package/templates/workspace.md

@@ -13,7 +13,9 @@ $ARGUMENTS
 cat .sillyspec/config.yaml 2>/dev/null
 ```
 
-如果不存在 → 这是一个尚未配置工作区的项目。询问用户是否要初始化工作区。
+如果不存在 → 这是一个尚未配置工作区的项目。询问用户：
+> 1. 初始化工作区
+> 2. 跳过
 
 ### Step 2: 解析指令
 
@@ -35,7 +37,9 @@ cat .sillyspec/config.yaml 2>/dev/null
    - 询问子项目路径（相对于工作区根目录，如 `./frontend`）
    - 询问子项目角色描述（如 `前端 - Vue3 + TypeScript`）
    - 验证路径存在
-   - 问是否继续添加
+   添加完后询问：
+   > 1. 继续添加子项目
+   > 2. 完成，配置共享规范
 3. 询问共享规范文件
 4. 生成 `.sillyspec/config.yaml`
 5. 创建 `.sillyspec/shared/` 目录
@@ -50,7 +54,9 @@ cat .sillyspec/config.yaml 2>/dev/null
 #### 3c. 移除子项目（`remove`）
 
 1. 显示当前所有子项目列表
-2. 询问要移除哪个
+2. 询问要移除哪个：
+   > 1. （列出子项目名称）
+   > 2. 取消
 3. 从 config.yaml 中删除对应条目
 4. Git 提交
 

package/adapters/adapters.sh

@@ -1,172 +0,0 @@
-#!/usr/bin/env bash
-# SillySpec 适配器 — 每个工具一个函数，负责 frontmatter 格式和输出目录
-set -euo pipefail
-
-# ── 元数据映射（从现有 commands 的 frontmatter 提取） ──
-
-get_description() {
-  local name=$1
-  case $name in
-    init)       echo "绿地项目初始化 — 深度提问、调研、需求文档、路线图" ;;
-    scan)       echo "代码库扫描 — 支持快速扫描和深度扫描两阶段" ;;
-    explore)    echo "自由思考模式 — 讨论、画图、调研，不写代码" ;;
-    brainstorm) echo "需求探索 — 结构化头脑风暴，生成设计文档（创建性工作前必用）" ;;
-    propose)    echo "生成结构化规范 — proposal + design + tasks" ;;
-    plan)       echo "编写实现计划 — 2-5 分钟粒度，精确到文件路径和代码" ;;
-    execute)    echo "波次执行 — 子代理并行 + 强制 TDD + 两阶段审查" ;;
-    verify)     echo "验证实现 — 对照规范检查 + 测试套件" ;;
-    archive)    echo "归档变更 — 规范沉淀，可追溯" ;;
-    status)     echo "查看项目进度和状态" ;;
-    continue)   echo "自动判断并执行下一步" ;;
-    state)      echo "查看当前工作状态 — 显示 STATE.md 内容" ;;
-    resume)     echo "恢复工作 — 从中断处继续" ;;
-    quick)      echo "快速任务 — 跳过完整流程，直接做" ;;
-    workspace)  echo "工作区管理 — 初始化、管理多项目工作区，查看子项目状态" ;;
-    export)     echo "导出成功方案为可复用模板" ;;
-    *)          echo "SillySpec $name" ;;
-  esac
-}
-
-get_argument_hint() {
-  local name=$1
-  case $name in
-    init)       echo "[项目名]" ;;
-    scan)       echo "[可选：指定区域，如 'api' 或 'auth'] [--deep 深度扫描]" ;;
-    explore)    echo "[探索主题]" ;;
-    brainstorm) echo "[需求或想法描述]" ;;
-    propose)    echo "[变更名]" ;;
-    plan)       echo "[计划名]" ;;
-    execute)    echo "[任务编号或 'all']" ;;
-    verify)     echo "[可选：指定验证范围]" ;;
-    archive)    echo "[变更名]" ;;
-    status)     echo "" ;;
-    continue)   echo "" ;;
-    state)      echo "[可选备注]" ;;
-    resume)     echo "" ;;
-    quick)      echo "[任务描述]" ;;
-    workspace)  echo "[可选：add/remove/status/info]" ;;
-    export)     echo "<change-name> [--to <path>]" ;;
-    *)          echo "" ;;
-  esac
-}
-
-# ── Claude Code commands 适配器 ──
-
-generate_claude() {
-  local name=$1 desc=$2 template=$3 arg_hint=$4
-  local out_dir=".claude/commands/sillyspec"
-  mkdir -p "$out_dir"
-  local body
-  body=$(cat "$template")
-  cat > "$out_dir/${name}.md" <<EOF
----
-description: $desc
-argument-hint: "$arg_hint"
----
-
-$body
-EOF
-}
-
-# ── Claude Code skills 适配器 ──
-
-generate_claude_skills() {
-  local name=$1 desc=$2 template=$3 arg_hint=$4
-  local out_dir=".claude/skills/sillyspec-${name}"
-  mkdir -p "$out_dir"
-  local body
-  body=$(cat "$template")
-  cat > "$out_dir/SKILL.md" <<EOF
----
-name: sillyspec:${name}
-description: $desc
----
-
-$body
-EOF
-}
-
-# ── Cursor 适配器 ──
-
-generate_cursor() {
-  local name=$1 desc=$2 template=$3 arg_hint=$4
-  local out_dir=".cursor/commands"
-  mkdir -p "$out_dir"
-  local body
-  body=$(cat "$template")
-  cat > "$out_dir/sillyspec-${name}.md" <<EOF
----
-name: /sillyspec-${name}
-id: sillyspec-${name}
-description: $desc
----
-
-$body
-EOF
-}
-
-# ── Codex 适配器 ──
-
-generate_codex() {
-  local name=$1 desc=$2 template=$3 arg_hint=$4
-  local out_dir="$HOME/.agents/skills/sillyspec-${name}"
-  mkdir -p "$out_dir"
-  local body
-  body=$(cat "$template")
-  cat > "$out_dir/SKILL.md" <<EOF
----
-name: sillyspec:${name}
-description: $desc
----
-
-$body
-EOF
-}
-
-# ── OpenCode 适配器 ──
-
-generate_opencode() {
-  local name=$1 desc=$2 template=$3 arg_hint=$4
-  local out_dir=".opencode/skills/sillyspec-${name}"
-  mkdir -p "$out_dir"
-  local body
-  body=$(cat "$template")
-  cat > "$out_dir/SKILL.md" <<EOF
----
-name: sillyspec:${name}
-description: $desc
----
-
-$body
-EOF
-}
-
-# ── OpenClaw 适配器 ──
-
-generate_openclaw() {
-  local name=$1 desc=$2 template=$3 arg_hint=$4
-  local out_dir=".openclaw/skills/sillyspec-${name}"
-  mkdir -p "$out_dir"
-  local body
-  body=$(cat "$template")
-  cat > "$out_dir/SKILL.md" <<EOF
----
-name: sillyspec:${name}
-description: $desc
----
-
-$body
-EOF
-}
-
-# ── 工具列表 ──
-
-VALID_TOOLS="claude claude_skills cursor codex opencode openclaw"
-
-is_valid_tool() {
-  local tool=$1
-  for t in $VALID_TOOLS; do
-    [ "$t" = "$tool" ] && return 0
-  done
-  return 1
-}

package/commands/sillyspec/archive.md

@@ -1,62 +0,0 @@
----
-description: 归档变更 — 规范沉淀，可追溯
----
-
-你现在是 SillySpec 的归档器。
-
-## 变更名称
-$ARGUMENTS
-
-## 流程
-
-### 1. 确认验证通过
-
-检查是否执行过验证。如果没有 → 提示先运行 `/sillyspec:verify`。
-
-### 2. 归档
-
-### 3. 确认归档
-
-在移动文件之前，展示即将归档的内容：
-- 变更目录名
-- 包含的文件列表
-- 生成总结
-
-**等待用户确认后再执行归档操作。**
-
-将 `.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 "新想法"`
-
-### 更新 STATE.md
-
-archive 完成后，**必须自动更新** `.sillyspec/STATE.md`：
-
-- 清除当前变更信息（归档后不再活跃）
-- 如果是主变更（有 MASTER.md），标记所有阶段为 ✅，然后清除
-- 历史记录追加时间 + 归档完成
-- 下一步改为 `/sillyspec:brainstorm "新想法"` 或留空