sillyspec 3.7.14 → 3.7.16

package/templates/progress-format.md

@@ -1,90 +0,0 @@
-# Progress Format — AI 写入规范
-
-> 本文件供 AI 在各阶段执行时参考，规范 progress.json 和 user-inputs.md 的写入方式。
-
-## 文件位置
-
-- **进度文件：** `.sillyspec/.runtime/progress.json`
-- **用户输入记录：** `.sillyspec/.runtime/user-inputs.md`
-
-## progress.json 字段说明
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `_version` | number | 内部版本号，固定为 `1` |
-| `schemaVersion` | string | Schema 版本，固定为 `"1.0.0"` |
-| `currentStage` | string | 当前阶段：`brainstorm` / `propose` / `plan` / `execute` / `verify` |
-| `lastActiveAt` | string | ISO 8601 时间戳，每次更新时刷新 |
-| `resumeCount` | number | 恢复次数，每次恢复时 +1 |
-| `checkpoint` | string | 一句话描述当前进度（给恢复时快速定位） |
-| `stages.<stage>.status` | string | 阶段状态：`not_started` / `in_progress` / `completed` |
-| `stages.<stage>.completedSteps` | number[] | 已完成步骤 ID 列表 |
-| `stages.<stage>.inProgressStep` | object/null | 当前进行中的步骤：`{ id, name, startedAt, partialContext }` |
-| `stages.<stage>.summaries` | object | 步骤结论，key 为步骤 ID，value 见下方 |
-| `stages.<stage>.artifacts` | array | 产出文件列表：`[{ stepId, name, paths }]` |
-| `stages.<stage>.stageSummary` | string/null | 阶段总结 |
-
-### summaries 结构
-
-```json
-{
-  "1": {
-    "conclusion": "一句话结论",
-    "keyEntities": ["实体1", "实体2"],
-    "decisions": ["决定A"],
-    "rejectedAlternatives": ["被否的方案B"],
-    "userMessages": ["用户原话摘要"],
-    "openQuestions": ["未解决的问题"]
-  }
-}
-```
-
-## user-inputs.md 格式
-
-每步完成时 **append**（不覆盖）用户在本步说的所有原话：
-
-```markdown
-# 用户输入记录
-
-## Step 1 - 需求理解 (2026-04-05 00:30)
-- 我们主要做研发项目管理，不搞CRM
-- 目标用户是中大型团队，50人以上
-
-## Step 3 - 竞品分析 (2026-04-05 00:45)
-- Jira太重了，我们想做轻的
-- 排期最烦了，能不能AI帮搞
-```
-
-### 时间戳格式
-
-`YYYY-MM-DD HH:MM`
-
-### 获取当前时间
-
-- JavaScript：`new Date().toLocaleString('sv-SE', { timeZone: 'Asia/Shanghai', hour12: false }).slice(0, 16)` → `"2026-04-05 13:37"`
-- 或 shell 命令：`date '+%Y-%m-%d %H:%M'`
-
-## 每步完成后的保存流程
-
-1. **更新 progress.json**：
-   - 将步骤 ID 加入 `completedSteps`
-   - 清空 `inProgressStep`（或设为下一步）
-   - 在 `summaries` 中写入本步结论
-   - 刷新 `lastActiveAt`
-   - 更新 `checkpoint`（一句话描述）
-
-2. **Append user-inputs.md**：
-   - 追加 `## Step N - 步骤名 (YYYY-MM-DD HH:MM)` 段落
-   - 列出用户在本步的所有原话
-   - **不要删除之前的内容，只追加**
-
-3. **如果阶段完成**：
-   - 设置 `stages.<stage>.status = "completed"`
-   - 写入 `stageSummary`
-   - 更新 `currentStage` 为下一阶段
-
-## 多任务并行说明
-
-- `quick` 命令**不修改** progress.json，独立执行
-- quick 完成后主流程状态不变，直接继续
-- `resume` 恢复时忽略 quick 的内容

package/templates/propose.md

@@ -1,73 +0,0 @@
-## 交互规范
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-> **提示：** 通常不需要单独执行 propose。brainstorm 阶段会自动产出 design.md。仅当需求已经明确、跳过 brainstorm 时才手动执行 propose。
-
-## 核心约束（必须遵守）
-- ❌ 写实现代码
-- ❌ tasks.md 写具体步骤（只列任务名）
-- ❌ 编造表名、字段名、API 端点（必须来自 ARCHITECTURE.md 或明确标注"新增"）
-
-## 状态检查（必须先执行）
-
-```bash
-cat .sillyspec/STATE.md 2>/dev/null
-```
-
-- phase 为 `propose` 或 STATE.md 中下一步为 `/sillyspec:propose` → ✅ 继续
-- 其他 phase → 提示用户当前阶段
-
-## 变更名称
-$ARGUMENTS
-
----
-
-## 流程
-
-### 1. 加载上下文
-
-```bash
-cat .sillyspec/changes/*/MASTER.md 2>/dev/null  # 子阶段变更
-ls -t .sillyspec/knowledge/*.md | head -1
-cat .sillyspec/{REQUIREMENTS}.md .sillyspec/docs/<project>/scan/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
-ls .sillyspec/changes/ | grep -v archive
-```
-
-**子阶段变更（如 `name/stage-1`）：** 读 MASTER.md 获取方向 + 前序经验 + 原型分析。规范保存到 `.sillyspec/docs/<project>/changes/<name>/stages/<stage-N>/`。
-
-无设计文档 → 提示先 `/sillyspec:brainstorm`。
-
-### 1.5 锚定确认（必须完成）
-
-确认实际存在的文件。
-
-### 2. 探索现有代码
-
-理解相关模块当前实现，识别影响范围。
-
-### 3. 生成规范文件
-
-创建 `.sillyspec/docs/<project>/changes/$ARGUMENTS/`：
-
-**`design.md`：** 动机与范围、功能需求（REQ-001 格式、Given/When/Then 用户场景、非功能需求）、架构决策及理由、文件变更清单表格、数据模型、API 设计、**代码风格参照**（参考已有的 Controller/Service/Entity 源文件，标注返回值类型、异常类型、注解风格）
-
-**`tasks.md`：** 准备 → 实现 → 收尾的任务列表（每个 task 标注文件路径）
-
-### 4. 展示关键文件
-
-展示 design.md 给用户审阅。tasks.md 只展示任务列表。
-
-### 5. 自检门控
-
-- [ ] design.md 含"动机、变更范围、功能需求"？
-- [ ] design.md 含"文件变更清单"表格？
-- [ ] design.md 含 Given/When/Then 用户场景？
-- [ ] tasks.md 每个 task 有文件路径？
-
-```bash
-bash scripts/validate-proposal.sh .sillyspec/changes/$ARGUMENTS 2>/dev/null
-```
-
-### 6. 完成
-
-更新 `.sillyspec/STATE.md`：阶段改为 `propose ✅`，下一步 `/sillyspec:plan`。

package/templates/quick.md

@@ -1,135 +0,0 @@
-## 交互规范
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-## 核心约束（必须遵守）
-- ❌ 不写测试（底线是仍然要写测试）
-- ❌ 修改无关文件
-- ❌ 跳过测试因为"任务太简单"
-
-## 用法
-
-- `/sillyspec:quick "修复用户创建接口漏了手机号校验"` — 独立记录到按用户名隔离的 QUICKLOG
-- `/sillyspec:quick --change user-module "修复用户创建接口漏了手机号校验"` — 追加到 user-module 变更的 tasks.md
-
-## 任务
-$ARGUMENTS
-
----
-
-## 流程
-
-1. **解析参数：** 检查是否携带 `--change <变更名>`，确定记录方式
-1.5 **归属检查：** 如果没有 `--change` 参数，检查 `.sillyspec/docs/<project>/changes/` 下是否有非 archive 的活跃变更目录：
-   ```bash
-   ls -d .sillyspec/docs/<project>/changes/*/ 2>/dev/null | grep -v archive
-   ```
-   - 有活跃变更 → AskUserQuestion 询问本次 quick 归属哪个变更，默认选当前活跃的
-   - 用户选择后将日志写入 `.sillyspec/docs/<project>/changes/<变更名>/quicklog/` 而非独立 QUICKLOG
-   - 用户选择"无归属" → 走原有的独立 QUICKLOG 流程
-   - 无活跃变更 → 走原有的独立 QUICKLOG 流程
-2. **理解任务：** 模糊则问一个问题确认
-3. **加载上下文：** `cat .sillyspec/docs/<project>/scan/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null`
-3b. **编码规范扫描：** 检测项目中的编码规范配置文件（`.eslintrc*`、`.prettierrc*`、`tsconfig.json`、`.editorconfig`、`tailwind.config.*`、`CONTRIBUTING.md`），提取关键规则生成摘要。写作代码时必须严格遵守这些规则（分号/引号/缩进/命名风格等），如不确定优先遵守规范约束。
-4. **知识库查询（强制步骤）：**
-   ```bash
-   cat .sillyspec/knowledge/INDEX.md 2>/dev/null
-   ```
-   根据当前任务描述中的关键词匹配 INDEX.md 条目，命中时 `cat` 对应知识文件，将内容纳入后续开发考量。未命中则跳过。
-   **MCP 检测：** 检查当前可用工具列表中是否存在 MCP 工具（Context7/浏览器/数据库/搜索等），根据检测结果动态利用：
-   - 有 Context7 → 查询不熟悉库/API 的最新文档
-   - 有浏览器 MCP → 验证页面改动效果
-   - 有数据库 MCP → 查询表结构和数据验证（只读）
-   - 有搜索 MCP → 搜索最佳实践和解决方案
-   - 有其他 MCP → 按任务需要灵活使用
-   - 无 MCP → 使用 web search
-5. **先读后写：** 调用已有方法前 `cat` 源文件确认签名，`grep` 确认方法存在
-6. **数据操作安全：** 任何改变现有数据的操作（非 SELECT 的数据库操作）必须暂停并报告给用户确认，不得自动执行。新建表不受此限制
-6. **TDD 执行：**
-   ```
-   🔴 RED    → 先写测试，运行确认失败
-   🟢 GREEN  → 写最少代码让测试通过
-   🔵 REFACTOR → 清理，保持测试通过
-   ✅ STAGE   → git add 暂存（测试文件必须包含在暂存中）
-   ```
-   测试文件必须保留在项目中，不能删除。违反 TDD → 删掉代码从测试重新开始。
-   - 纯配置/数据/文档可跳过 TDD
-   - 其他情况一律走 TDD
-7. **运行测试：** 先检查 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
-```
-8. **Lint 校验（如项目配置了）：** 写完代码后、暂存前，运行项目的 lint 工具验证代码质量：
-   ```bash
-   # 检测并运行可用的 lint 工具
-   npx eslint <修改的文件> 2>/dev/null || \
-   npx prettier --check <修改的文件> 2>/dev/null || \
-   npx tsc --noEmit 2>/dev/null || \
-   true  # 没有 lint 工具则跳过
-   ```
-   - **有报错 → 自动修复：** `npx eslint --fix <修改的文件>` / `npx prettier --write <修改的文件>`
-   - **修复后仍有报错 → 在 QUICKLOG 中标注，提醒用户手动处理**
-   - **工作区模式下，在子项目目录中执行，不要在主项目目录执行**
-9. **Git 暂存：** `git add -A`。**不要 commit**，由用户通过 `/sillyspec:commit` 统一提交。**工作区模式下，确认当前在正确的子项目目录中执行暂存。**
-10. **记录：**
-   - **有 `--change`：** 在 `.sillyspec/docs/<project>/changes/<变更名>/tasks.md` 追加 task 并勾选，**记录精确到秒的时间戳**：
-
-```
-- [x] [YYYY-MM-DD HH:MM:SS] 任务描述
-```
-   - **无 `--change` 但步骤 1.5 确认了归属变更：** 记录到 `.sillyspec/docs/<project>/changes/<变更名>/quicklog/YYYY-MM-DD-HHMMSS-任务简述.md`，格式：
-
-```markdown
-# quick: 任务描述
-
-- 时间：YYYY-MM-DD HH:MM:SS
-- 关联变更：<变更名>
-- 修改文件：
-  - `path/to/file1`
-  - `path/to/file2`
-- 改动说明：（2-3 句描述做了什么）
-- 发现的坑：（如有，简要记录）
-```
-
-   - **无 `--change` 且无归属：** 记录到 `.sillyspec/docs/<project>/quicklog/QUICKLOG-<git用户名>.md`（见下方规则）
-10. **检查复杂度：** 任务比预期复杂 → 建议用完整流程
-
-11. **记录发现的坑：** 执行过程中如果发现项目特有的规律、陷阱或约定（如"某方法参数顺序容易搞反"、"某表有隐藏软删除字段"），追加到 `.sillyspec/knowledge/uncategorized.md`，格式：
-
-```markdown
-### [待确认] {简短标题}
-> 来源：quick / {时间戳}
-
-{坑的具体描述}
-```
-
-**工作区模式下：** 只影响当前子项目 → 写入当前子项目 `.sillyspec/knowledge/uncategorized.md`；影响多个子项目 → 写入工作区根目录 `.sillyspec/knowledge/uncategorized.md`。
-
-12. **知识库审阅提示：** 如果本次执行向 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/docs/<project>/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/templates/resume-dialog.md

@@ -1,55 +0,0 @@
-# Resume Dialog Template
-
-> 此模板用于 AI 恢复中断的 SillySpec 工作流程。
-
-## 恢复流程
-
-当用户执行 `resume` 或对话中断后恢复时，按以下步骤操作：
-
-### 1. 读取进度
-
-```
-读取 .sillyspec/.runtime/progress.json
-读取 .sillyspec/.runtime/user-inputs.md（截取当前阶段相关部分）
-读取 .sillyspec/STATE.md
-```
-
-### 2. 向用户确认
-
-用简洁的语言告知：
-
-- 当前阶段和步骤
-- 上次做到哪里（checkpoint）
-- 距上次活跃时间
-- 下一步要做什么
-
-**示例：**
-
-> 📋 上次你在 **brainstorm** 阶段的 **Step 4 - 技术选型**，已经讨论了前端框架的选择。
-> 距今约 2 小时。要继续技术选型，还是回顾一下之前的结论？
-
-### 3. 恢复上下文
-
-从 `summaries` 和 `user-inputs.md` 中提取之前的关键信息，注入对话：
-
-- 已完成的步骤结论
-- 已做的决策和被否的方案
-- 未解决的问题
-- 用户的关键偏好
-
-### 4. 继续执行
-
-从 `inProgressStep` 指定的步骤继续。如果 `inProgressStep` 为空但从 `completedSteps` 可推断进度，则从下一步开始。
-
-### 5. 更新进度
-
-- `resumeCount` +1
-- 刷新 `lastActiveAt`
-- 开始执行后更新 `inProgressStep`
-
-## 注意事项
-
-- 不要重新问已完成步骤中已经确认的问题
-- 除非用户主动要求，不要从头开始
-- 如果 progress.json 损坏，告知用户并建议运行 `sillyspec progress validate`
-- quick 任务不影响主流程进度

package/templates/resume.md

@@ -1,53 +0,0 @@
-## 交互规范
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-## 核心约束（必须遵守）
-- ❌ 直接说"没有记录"（无 STATE.md 时应自动探测）
-- ❌ 修改任何文件（只读展示，但探测后可创建 STATE.md）
-
----
-
-## 流程
-
-### Step 1: 读取 STATE.md
-
-```bash
-cat .sillyspec/STATE.md 2>/dev/null
-```
-
-**有 STATE.md：** 提取并展示当前变更、阶段、进度、下一步命令、阶段进度表、关键决策。AskUserQuestion：直接继续 / 查看更多细节。
-
-**无 STATE.md：** 自动探测（工作区模式下同时检查子项目）：
-
-```bash
-cat .sillyspec/config.yaml 2>/dev/null  # 检查是否工作区模式
-ls .sillyspec/changes/*/MASTER.md 2>/dev/null
-ls -d .sillyspec/changes/*/ | grep -v archive | grep -v stages | tail -1 2>/dev/null
-ls .sillyspec/codebase/*.md .sillyspec/codebase/details/*.md .sillyspec/changes/*/tasks.md .sillyspec/{REQUIREMENTS,ROADMAP}.md 2>/dev/null
-# 工作区模式：检查每个子项目的状态
-for proj in $(cat .sillyspec/config.yaml | grep -oP 'path:\s*\K.*'); do
-  echo "=== $(basename $proj) ==="
-  cat "$proj/.sillyspec/STATE.md" 2>/dev/null
-  ls "$proj/.sillyspec/changes/" 2>/dev/null | grep -v archive
-done
-```
-
-**探测结果推断：**
-
-| 探测到的文件 | 推断阶段 | 建议操作 |
-|---|---|---|
-| 无 .sillyspec/ 内容 | 未开始 | `/sillyspec:init` 或 `/sillyspec:scan` |
-| 有 SCAN-RAW.md 或 codebase 文档不全 | 扫描中断 | `/sillyspec:scan`（断点续扫） |
-| codebase 文档齐全无 changes/ | 已扫描未开始需求 | `/sillyspec:brainstorm` |
-| 有 REQUIREMENTS.md 无 changes/ | 绿地有需求 | `/sillyspec:brainstorm` |
-| changes/ 有 design 无 tasks | 待计划 | `/sillyspec:plan` |
-| tasks.md 有未完成 checkbox | 执行中 | `/sillyspec:execute` |
-| tasks.md 全完成 | 待验证 | `/sillyspec:verify` |
-
-**同时创建 STATE.md 记录推断状态。**
-
-### 关键原则
-
-- STATE.md 是唯一恢复数据源（不需要 HANDOFF.json）
-- STATE.md 不需要 Git 提交（可加入 `.gitignore`）
-- 每次命令执行完自动更新

package/templates/scan-quick.md

@@ -1,49 +0,0 @@
-## 交互规范
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-> 本模板由 `/sillyspec:scan --quick` 触发。如需完整深度扫描，使用 `/sillyspec:scan`。
-
-## 核心约束（必须遵守）
-- ❌ 修改任何代码
-- ❌ 编造文件路径或代码模式（必须包含真实路径）
-- ❌ 读源码文件（快扫只读配置和目录）
-
-## 快速扫描流程
-
-### Step 1: 检查工作区模式
-
-```bash
-cat .sillyspec/config.yaml 2>/dev/null
-```
-
-有 `projects` 字段 → 工作区模式：逐个子项目快扫。
-
-### Step 2: 读配置文件
-
-```bash
-cat package.json tsconfig.json requirements.txt Cargo.toml go.mod pom.xml build.gradle 2>/dev/null
-find . -maxdepth 2 -name "*.config.*" -not -path "*/node_modules/*" -not -path "*/.git/*" | head -20 | xargs cat 2>/dev/null
-```
-
-### Step 3: 生成文档
-
-`mkdir -p .sillyspec/codebase`，生成 4 份文档：
-
-1. **ARCHITECTURE.md** — 架构 + 技术栈（合并原 STACK.md）
-2. **STRUCTURE.md** — 目录结构（`find . -type f | head -200`）
-3. **CONVENTIONS.md** — 空骨架文件，含章节标题（注意事项、代码风格等），供后续 quick/execute 追加
-4. **PROJECT.md** — 项目概览
-
-### Step 4: 暂存修改
-
-```bash
-git add .sillyspec/
-```
-
-工作区模式在每个子项目分别暂存。
-
-💡 扫描产出已暂存。准备好后用 `/sillyspec:commit` 提交。
-
-### 完成
-
-提示用户：快扫只提取基础信息。如需完整代码规范（框架规则、实体继承、代码风格），执行 `/sillyspec:scan` 进行深度扫描。