sillyspec 3.7.1 → 3.7.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/src/index.js +11 -483
- package/src/setup.js +232 -64
- package/templates/brainstorm.md +2 -6
- package/templates/execute.md +79 -0
- package/templates/explore.md +24 -0
- package/templates/plan.md +30 -6
- package/templates/propose.md +3 -7
- package/templates/quick.md +9 -0
- package/templates/scan.md +17 -5
- package/templates/verify.md +113 -4
- package/.claude/commands/sillyspec/archive.md +0 -63
- package/.claude/commands/sillyspec/brainstorm.md +0 -182
- package/.claude/commands/sillyspec/continue.md +0 -32
- package/.claude/commands/sillyspec/execute.md +0 -133
- package/.claude/commands/sillyspec/explore.md +0 -43
- package/.claude/commands/sillyspec/export.md +0 -21
- package/.claude/commands/sillyspec/init.md +0 -64
- package/.claude/commands/sillyspec/plan.md +0 -112
- package/.claude/commands/sillyspec/propose.md +0 -77
- package/.claude/commands/sillyspec/quick.md +0 -76
- package/.claude/commands/sillyspec/resume.md +0 -53
- package/.claude/commands/sillyspec/scan-quick.md +0 -47
- package/.claude/commands/sillyspec/scan.md +0 -135
- package/.claude/commands/sillyspec/status.md +0 -72
- package/.claude/commands/sillyspec/verify.md +0 -87
- package/.claude/commands/sillyspec/workspace-sync.md +0 -89
- package/.claude/commands/sillyspec/workspace.md +0 -67
- package/.sillyspec/config.yaml +0 -13
|
@@ -1,64 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: 绿地项目初始化 — 深度提问、调研、需求文档、路线图
|
|
3
|
-
argument-hint: "[项目名]"
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
## 交互规范
|
|
7
|
-
**当需要用户从多个选项中做出选择时,必须使用 Claude Code 内置的 AskUserQuestion 工具,将选项以参数传入。**
|
|
8
|
-
|
|
9
|
-
## 核心约束(必须遵守)
|
|
10
|
-
- ❌ 写任何实现代码
|
|
11
|
-
- ❌ 安装任何依赖
|
|
12
|
-
- ❌ 一次问多个问题
|
|
13
|
-
- ❌ 接受模糊需求(❌"好用" → ✅"首屏加载 < 2 秒")
|
|
14
|
-
|
|
15
|
-
## 用户输入
|
|
16
|
-
$ARGUMENTS
|
|
17
|
-
|
|
18
|
-
---
|
|
19
|
-
|
|
20
|
-
## 流程
|
|
21
|
-
|
|
22
|
-
### Step 1: 检查工作区模式
|
|
23
|
-
|
|
24
|
-
```bash
|
|
25
|
-
cat .sillyspec/config.yaml 2>/dev/null
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
有 `projects` → 工作区模式:AskUserQuestion 选子项目,切换到子项目目录执行。
|
|
29
|
-
|
|
30
|
-
### Step 2: 检查项目状态
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
ls -la
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
已有代码/配置 → 提示用 `/sillyspec:scan`。空目录 → 继续。
|
|
37
|
-
|
|
38
|
-
### Step 3: 深度提问(一次一个问题)
|
|
39
|
-
|
|
40
|
-
按需探索(不是每个都要):项目本质 → 核心功能 → 技术偏好 → 非功能需求 → 设计偏好 → 约束 → 不在范围内。
|
|
41
|
-
|
|
42
|
-
### Step 4: 技术选型(如需要)
|
|
43
|
-
|
|
44
|
-
用户无明确偏好时,推荐 2-3 套技术栈并列优劣和推荐理由。可选快速调研选定框架的版本、生态、已知坑。
|
|
45
|
-
|
|
46
|
-
### Step 5: 生成文档
|
|
47
|
-
|
|
48
|
-
**`REQUIREMENTS.md`:** 概述、目标用户、功能需求(P0/P1/P2)、非功能需求、不在范围内、技术选型表。
|
|
49
|
-
|
|
50
|
-
**`ROADMAP.md`:** Phase 分阶段路线图(目标 + 交付物)。
|
|
51
|
-
|
|
52
|
-
**`PROJECT.md`:** 项目名、一句话描述、状态。
|
|
53
|
-
|
|
54
|
-
### Step 6: Git 初始化
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
git init && git add . && git commit -m "chore: sillyspec init - project initialized"
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
### 最后说:
|
|
61
|
-
|
|
62
|
-
> ✅ 项目初始化完成!
|
|
63
|
-
> 生成文件:PROJECT.md、REQUIREMENTS.md、ROADMAP.md
|
|
64
|
-
> 下一步:`/sillyspec:brainstorm "Phase 1: xxx"` 或直接告诉我改什么
|
|
@@ -1,112 +0,0 @@
|
|
|
1
|
-
## 交互规范
|
|
2
|
-
**当需要用户从多个选项中做出选择时,必须使用 Claude Code 内置的 AskUserQuestion 工具,将选项以参数传入。**
|
|
3
|
-
|
|
4
|
-
## 核心约束(必须遵守)
|
|
5
|
-
- ❌ 写实现代码(只写计划中的代码示例)
|
|
6
|
-
- ❌ 每个步骤缺验证命令和预期输出
|
|
7
|
-
- ❌ 编造表名、字段名(必须来自 ARCHITECTURE.md 或 design.md)
|
|
8
|
-
|
|
9
|
-
## 状态检查(必须先执行)
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
sillyspec status --json
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
- `phase: "plan"` → ✅ 继续
|
|
16
|
-
- 其他 phase → 提示 `sillyspec next`
|
|
17
|
-
|
|
18
|
-
---
|
|
19
|
-
|
|
20
|
-
## 流程
|
|
21
|
-
|
|
22
|
-
### 1. 加载上下文
|
|
23
|
-
|
|
24
|
-
```bash
|
|
25
|
-
cat .sillyspec/config.yaml 2>/dev/null
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
**工作区模式:** 加载 CODEBASE-OVERVIEW.md + 共享规范 + 子项目的 CONVENTIONS/ARCHITECTURE/STACK + REQUIREMENTS.md。
|
|
29
|
-
|
|
30
|
-
**单项目模式:**
|
|
31
|
-
```bash
|
|
32
|
-
LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
|
|
33
|
-
cat "$LATEST"/{design,tasks}.md 2>/dev/null
|
|
34
|
-
cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
|
|
35
|
-
cat .sillyspec/REQUIREMENTS.md 2>/dev/null
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
### 1.5 锚定确认(必须完成)
|
|
39
|
-
|
|
40
|
-
确认实际存在的文件(design / tasks),不存在的标注跳过。
|
|
41
|
-
|
|
42
|
-
### 2. 逐任务展开
|
|
43
|
-
|
|
44
|
-
把 tasks.md 每个 checkbox **保留 `- [ ]` 格式**并展开为任务描述,按 Wave 分组组织。工作区模式下每个 Task 标注所属项目。
|
|
45
|
-
|
|
46
|
-
**输出格式要求(必须严格遵守):**
|
|
47
|
-
|
|
48
|
-
```markdown
|
|
49
|
-
### Wave 1(并行,无依赖)
|
|
50
|
-
- [ ] 添加用户创建接口
|
|
51
|
-
- 修改: `UserController.java`、`UserService.java`
|
|
52
|
-
- 参考: `RoleController.createRole`
|
|
53
|
-
- 步骤:
|
|
54
|
-
1. 写测试 UserControllerTest.testCreateUser
|
|
55
|
-
2. 运行测试确认失败
|
|
56
|
-
3. 写 UserController.createUser
|
|
57
|
-
4. 运行测试确认通过
|
|
58
|
-
|
|
59
|
-
- [ ] 添加角色创建接口
|
|
60
|
-
- ...
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
**每个 Task 必须保留 `- [ ]` checkbox,这是 execute 阶段勾选完成状态的依据。** 禁止写成纯文本列表。
|
|
64
|
-
|
|
65
|
-
**每个 Task 必须包含「步骤」字段,列出 TDD 执行顺序:**
|
|
66
|
-
- 1. 写测试 → 2. 运行确认失败 → 3. 写代码 → 4. 运行确认通过
|
|
67
|
-
|
|
68
|
-
**纯配置/数据/文档类任务可跳过 TDD,步骤简化为:1. 实现 → 2. 验证**
|
|
69
|
-
|
|
70
|
-
**注意:不需要写精确方法签名和代码示例。** 方法签名和代码风格由 execute 阶段先读后写确认。plan 专注"做什么"和"执行顺序"。
|
|
71
|
-
|
|
72
|
-
**每个 Task 包含:**
|
|
73
|
-
- 精确文件路径(修改哪个文件)
|
|
74
|
-
- 任务描述(做什么,一两句话说清楚)
|
|
75
|
-
- 涉及已有类调用时,标注参考文件(如"参考 `RoleController.createRole`)
|
|
76
|
-
- 依赖关系
|
|
77
|
-
|
|
78
|
-
**注意:不需要写精确方法签名和代码示例。** 方法签名和代码风格由 execute 阶段先读后写确认。plan 专注"做什么",execute 负责"怎么做"。
|
|
79
|
-
|
|
80
|
-
### 3. 标注执行顺序
|
|
81
|
-
|
|
82
|
-
按 Wave 分组,标注依赖关系:
|
|
83
|
-
```markdown
|
|
84
|
-
### Wave 1(并行,无依赖)
|
|
85
|
-
- [ ] 添加用户创建接口
|
|
86
|
-
- 修改: `UserController.java`、`UserService.java`
|
|
87
|
-
- 参考: `RoleController.createRole`
|
|
88
|
-
|
|
89
|
-
- [ ] 添加角色创建接口
|
|
90
|
-
- ...
|
|
91
|
-
|
|
92
|
-
### Wave 2(依赖 Wave 1)
|
|
93
|
-
- [ ] 添加用户列表查询(依赖用户创建完成)
|
|
94
|
-
- ...
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
### 4. 保存
|
|
98
|
-
|
|
99
|
-
**直接覆盖** `.sillyspec/changes/<变更名>/tasks.md`。不再生成单独的 plan.md 文件。
|
|
100
|
-
|
|
101
|
-
### 5. 自检门控
|
|
102
|
-
|
|
103
|
-
- [ ] 每个 task 有具体文件路径?
|
|
104
|
-
- [ ] 标注了 Wave 和依赖关系?
|
|
105
|
-
|
|
106
|
-
### 6. 完成
|
|
107
|
-
|
|
108
|
-
```bash
|
|
109
|
-
sillyspec status --json && sillyspec next
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
更新 `.sillyspec/STATE.md`:阶段改为 `plan ✅`,下一步 `/sillyspec:execute`。
|
|
@@ -1,77 +0,0 @@
|
|
|
1
|
-
## 交互规范
|
|
2
|
-
**当需要用户从多个选项中做出选择时,必须使用 Claude Code 内置的 AskUserQuestion 工具,将选项以参数传入。**
|
|
3
|
-
|
|
4
|
-
> **提示:** 通常不需要单独执行 propose。brainstorm 阶段会自动产出 design.md。仅当需求已经明确、跳过 brainstorm 时才手动执行 propose。
|
|
5
|
-
|
|
6
|
-
## 核心约束(必须遵守)
|
|
7
|
-
- ❌ 写实现代码
|
|
8
|
-
- ❌ tasks.md 写具体步骤(只列任务名)
|
|
9
|
-
- ❌ 编造表名、字段名、API 端点(必须来自 ARCHITECTURE.md 或明确标注"新增")
|
|
10
|
-
|
|
11
|
-
## 状态检查(必须先执行)
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
sillyspec status --json
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
- `phase: "propose"` → ✅ 继续
|
|
18
|
-
- 其他 phase → 提示 `sillyspec next`
|
|
19
|
-
|
|
20
|
-
## 变更名称
|
|
21
|
-
$ARGUMENTS
|
|
22
|
-
|
|
23
|
-
---
|
|
24
|
-
|
|
25
|
-
## 流程
|
|
26
|
-
|
|
27
|
-
### 1. 加载上下文
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
cat .sillyspec/changes/*/MASTER.md 2>/dev/null # 子阶段变更
|
|
31
|
-
ls -t .sillyspec/knowledge/*.md | head -1
|
|
32
|
-
cat .sillyspec/{REQUIREMENTS}.md .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
|
|
33
|
-
ls .sillyspec/changes/ | grep -v archive
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
**子阶段变更(如 `name/stage-1`):** 读 MASTER.md 获取方向 + 前序经验 + 原型分析。规范保存到 `changes/<name>/stages/<stage-N>/`。
|
|
37
|
-
|
|
38
|
-
无设计文档 → 提示先 `/sillyspec:brainstorm`。
|
|
39
|
-
|
|
40
|
-
### 1.5 锚定确认(必须完成)
|
|
41
|
-
|
|
42
|
-
确认实际存在的文件。
|
|
43
|
-
|
|
44
|
-
### 2. 探索现有代码
|
|
45
|
-
|
|
46
|
-
理解相关模块当前实现,识别影响范围。
|
|
47
|
-
|
|
48
|
-
### 3. 生成规范文件
|
|
49
|
-
|
|
50
|
-
创建 `.sillyspec/changes/$ARGUMENTS/`:
|
|
51
|
-
|
|
52
|
-
**`design.md`:** 动机与范围、功能需求(REQ-001 格式、Given/When/Then 用户场景、非功能需求)、架构决策及理由、文件变更清单表格、数据模型、API 设计、**代码风格参照**(参考已有的 Controller/Service/Entity 源文件,标注返回值类型、异常类型、注解风格)
|
|
53
|
-
|
|
54
|
-
**`tasks.md`:** 准备 → 实现 → 收尾的任务列表(每个 task 标注文件路径)
|
|
55
|
-
|
|
56
|
-
### 4. 展示关键文件
|
|
57
|
-
|
|
58
|
-
展示 design.md 给用户审阅。tasks.md 只展示任务列表。
|
|
59
|
-
|
|
60
|
-
### 5. 自检门控
|
|
61
|
-
|
|
62
|
-
- [ ] design.md 含"动机、变更范围、功能需求"?
|
|
63
|
-
- [ ] design.md 含"文件变更清单"表格?
|
|
64
|
-
- [ ] design.md 含 Given/When/Then 用户场景?
|
|
65
|
-
- [ ] tasks.md 每个 task 有文件路径?
|
|
66
|
-
|
|
67
|
-
```bash
|
|
68
|
-
bash scripts/validate-proposal.sh .sillyspec/changes/$ARGUMENTS 2>/dev/null
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
### 6. 完成
|
|
72
|
-
|
|
73
|
-
```bash
|
|
74
|
-
sillyspec status --json && sillyspec next
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
更新 `.sillyspec/STATE.md`:阶段改为 `propose ✅`,下一步 `/sillyspec:plan`。
|
|
@@ -1,76 +0,0 @@
|
|
|
1
|
-
## 交互规范
|
|
2
|
-
**当需要用户从多个选项中做出选择时,必须使用 Claude Code 内置的 AskUserQuestion 工具,将选项以参数传入。**
|
|
3
|
-
|
|
4
|
-
## 核心约束(必须遵守)
|
|
5
|
-
- ❌ 不写测试(底线是仍然要写测试)
|
|
6
|
-
- ❌ 修改无关文件
|
|
7
|
-
- ❌ 跳过测试因为"任务太简单"
|
|
8
|
-
|
|
9
|
-
## 用法
|
|
10
|
-
|
|
11
|
-
- `/sillyspec:quick "修复用户创建接口漏了手机号校验"` — 独立记录到按用户名隔离的 QUICKLOG
|
|
12
|
-
- `/sillyspec:quick --change user-module "修复用户创建接口漏了手机号校验"` — 追加到 user-module 变更的 tasks.md
|
|
13
|
-
|
|
14
|
-
## 任务
|
|
15
|
-
$ARGUMENTS
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
19
|
-
## 流程
|
|
20
|
-
|
|
21
|
-
1. **解析参数:** 检查是否携带 `--change <变更名>`,确定记录方式
|
|
22
|
-
2. **理解任务:** 模糊则问一个问题确认
|
|
23
|
-
3. **加载上下文:** `cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null`
|
|
24
|
-
4. **先读后写:** 调用已有方法前 `cat` 源文件确认签名,`grep` 确认方法存在
|
|
25
|
-
5. **TDD 执行:**
|
|
26
|
-
```
|
|
27
|
-
🔴 RED → 先写测试,运行确认失败
|
|
28
|
-
🟢 GREEN → 写最少代码让测试通过
|
|
29
|
-
🔵 REFACTOR → 清理,保持测试通过
|
|
30
|
-
✅ COMMIT → git 提交(测试文件必须包含在提交中)
|
|
31
|
-
```
|
|
32
|
-
测试文件必须保留在项目中,不能删除。违反 TDD → 删掉代码从测试重新开始。
|
|
33
|
-
- 纯配置/数据/文档可跳过 TDD
|
|
34
|
-
- 其他情况一律走 TDD
|
|
35
|
-
6. **运行测试:** 先检查 local.yaml 构建命令配置:
|
|
36
|
-
```bash
|
|
37
|
-
cat .sillyspec/local.yaml 2>/dev/null
|
|
38
|
-
```
|
|
39
|
-
如果有则使用 local.yaml 中的命令;否则使用默认命令:
|
|
40
|
-
```bash
|
|
41
|
-
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
|
|
42
|
-
```
|
|
43
|
-
7. **Git commit:** 展示 commit message 给用户确认后提交。**工作区模式下,确认当前在正确的子项目目录中执行 commit。**
|
|
44
|
-
8. **记录:**
|
|
45
|
-
- **有 `--change`:** 在 `.sillyspec/changes/<变更名>/tasks.md` 追加 task 并勾选,**记录精确到秒的时间戳**:
|
|
46
|
-
|
|
47
|
-
```
|
|
48
|
-
- [x] [YYYY-MM-DD HH:MM:SS] 任务描述
|
|
49
|
-
```
|
|
50
|
-
- **无 `--change`:** 记录到 `.sillyspec/quicklog/QUICKLOG-<git用户名>.md`(见下方规则)
|
|
51
|
-
9. **检查复杂度:** 任务比预期复杂 → 建议用完整流程
|
|
52
|
-
|
|
53
|
-
10. **记录发现的坑:** 执行过程中如果发现项目特有的规律、陷阱或约定(如"某方法参数顺序容易搞反"、"某表有隐藏软删除字段"),追加到 CONVENTIONS.md 的「注意事项」章节。**工作区模式下:** 只影响当前子项目 → 写入当前子项目 `.sillyspec/codebase/CONVENTIONS.md`;影响多个子项目 → 写入 `.sillyspec/shared/CONVENTIONS.md`(共享规范,所有子项目可见)。
|
|
54
|
-
|
|
55
|
-
### QUICKLOG 规则
|
|
56
|
-
|
|
57
|
-
**按 git 用户名隔离,避免多人同时操作冲突:**
|
|
58
|
-
|
|
59
|
-
```bash
|
|
60
|
-
USER=$(git config user.name 2>/dev/null || echo "default")
|
|
61
|
-
LOG_FILE=".sillyspec/quicklog/QUICKLOG-${USER}.md"
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
文件路径:`$LOG_FILE`
|
|
65
|
-
|
|
66
|
-
**追加记录格式(时间精确到秒):**
|
|
67
|
-
```markdown
|
|
68
|
-
## YYYY-MM-DD HH:MM:SS | fix: 任务描述
|
|
69
|
-
- 文件:`修改的文件列表`
|
|
70
|
-
- commit:`commit hash`
|
|
71
|
-
- 关联归档:`相关的已归档变更名`(如有)
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
**文件轮转:** 追加前检查文件大小,超过 500 行则:
|
|
75
|
-
1. 将当前文件重命名为 `QUICKLOG-${USER}-YYYY-MM-DD.md`
|
|
76
|
-
2. 创建新的空 `QUICKLOG-${USER}.md`
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
## 交互规范
|
|
2
|
-
**当需要用户从多个选项中做出选择时,必须使用 Claude Code 内置的 AskUserQuestion 工具,将选项以参数传入。**
|
|
3
|
-
|
|
4
|
-
## 核心约束(必须遵守)
|
|
5
|
-
- ❌ 直接说"没有记录"(无 STATE.md 时应自动探测)
|
|
6
|
-
- ❌ 修改任何文件(只读展示,但探测后可创建 STATE.md)
|
|
7
|
-
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
## 流程
|
|
11
|
-
|
|
12
|
-
### Step 1: 读取 STATE.md
|
|
13
|
-
|
|
14
|
-
```bash
|
|
15
|
-
cat .sillyspec/STATE.md 2>/dev/null
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
**有 STATE.md:** 提取并展示当前变更、阶段、进度、下一步命令、阶段进度表、关键决策。AskUserQuestion:直接继续 / 查看更多细节。
|
|
19
|
-
|
|
20
|
-
**无 STATE.md:** 自动探测(工作区模式下同时检查子项目):
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
cat .sillyspec/config.yaml 2>/dev/null # 检查是否工作区模式
|
|
24
|
-
ls .sillyspec/changes/*/MASTER.md 2>/dev/null
|
|
25
|
-
ls -d .sillyspec/changes/*/ | grep -v archive | grep -v stages | tail -1 2>/dev/null
|
|
26
|
-
ls .sillyspec/codebase/*.md .sillyspec/codebase/details/*.md .sillyspec/changes/*/tasks.md .sillyspec/{REQUIREMENTS,ROADMAP}.md 2>/dev/null
|
|
27
|
-
# 工作区模式:检查每个子项目的状态
|
|
28
|
-
for proj in $(cat .sillyspec/config.yaml | grep -oP 'path:\s*\K.*'); do
|
|
29
|
-
echo "=== $(basename $proj) ==="
|
|
30
|
-
cat "$proj/.sillyspec/STATE.md" 2>/dev/null
|
|
31
|
-
ls "$proj/.sillyspec/changes/" 2>/dev/null | grep -v archive
|
|
32
|
-
done
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
**探测结果推断:**
|
|
36
|
-
|
|
37
|
-
| 探测到的文件 | 推断阶段 | 建议操作 |
|
|
38
|
-
|---|---|---|
|
|
39
|
-
| 无 .sillyspec/ 内容 | 未开始 | `/sillyspec:init` 或 `/sillyspec:scan` |
|
|
40
|
-
| 有 SCAN-RAW.md 或 codebase 文档不全 | 扫描中断 | `/sillyspec:scan`(断点续扫) |
|
|
41
|
-
| codebase 文档齐全无 changes/ | 已扫描未开始需求 | `/sillyspec:brainstorm` |
|
|
42
|
-
| 有 REQUIREMENTS.md 无 changes/ | 绿地有需求 | `/sillyspec:brainstorm` |
|
|
43
|
-
| changes/ 有 design 无 tasks | 待计划 | `/sillyspec:plan` |
|
|
44
|
-
| tasks.md 有未完成 checkbox | 执行中 | `/sillyspec:execute` |
|
|
45
|
-
| tasks.md 全完成 | 待验证 | `/sillyspec:verify` |
|
|
46
|
-
|
|
47
|
-
**同时创建 STATE.md 记录推断状态。**
|
|
48
|
-
|
|
49
|
-
### 关键原则
|
|
50
|
-
|
|
51
|
-
- STATE.md 是唯一恢复数据源(不需要 HANDOFF.json)
|
|
52
|
-
- STATE.md 不需要 Git 提交(可加入 `.gitignore`)
|
|
53
|
-
- 每次命令执行完自动更新
|
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
## 交互规范
|
|
2
|
-
**当需要用户从多个选项中做出选择时,必须使用 Claude Code 内置的 AskUserQuestion 工具,将选项以参数传入。**
|
|
3
|
-
|
|
4
|
-
> 本模板由 `/sillyspec:scan --quick` 触发。如需完整深度扫描,使用 `/sillyspec:scan`。
|
|
5
|
-
|
|
6
|
-
## 核心约束(必须遵守)
|
|
7
|
-
- ❌ 修改任何代码
|
|
8
|
-
- ❌ 编造文件路径或代码模式(必须包含真实路径)
|
|
9
|
-
- ❌ 读源码文件(快扫只读配置和目录)
|
|
10
|
-
|
|
11
|
-
## 快速扫描流程
|
|
12
|
-
|
|
13
|
-
### Step 1: 检查工作区模式
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
cat .sillyspec/config.yaml 2>/dev/null
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
有 `projects` 字段 → 工作区模式:逐个子项目快扫。
|
|
20
|
-
|
|
21
|
-
### Step 2: 读配置文件
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
cat package.json tsconfig.json requirements.txt Cargo.toml go.mod pom.xml build.gradle 2>/dev/null
|
|
25
|
-
find . -maxdepth 2 -name "*.config.*" -not -path "*/node_modules/*" -not -path "*/.git/*" | head -20 | xargs cat 2>/dev/null
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
### Step 3: 生成文档
|
|
29
|
-
|
|
30
|
-
`mkdir -p .sillyspec/codebase`,生成 4 份文档:
|
|
31
|
-
|
|
32
|
-
1. **ARCHITECTURE.md** — 架构 + 技术栈(合并原 STACK.md)
|
|
33
|
-
2. **STRUCTURE.md** — 目录结构(`find . -type f | head -200`)
|
|
34
|
-
3. **CONVENTIONS.md** — 空骨架文件,含章节标题(注意事项、代码风格等),供后续 quick/execute 追加
|
|
35
|
-
4. **PROJECT.md** — 项目概览
|
|
36
|
-
|
|
37
|
-
### Step 4: Git 提交
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
git add .sillyspec/ && git commit -m "chore: sillyspec quick scan"
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
工作区模式在每个子项目分别提交。
|
|
44
|
-
|
|
45
|
-
### 完成
|
|
46
|
-
|
|
47
|
-
提示用户:快扫只提取基础信息。如需完整代码规范(框架规则、实体继承、代码风格),执行 `/sillyspec:scan` 进行深度扫描。
|
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
## 交互规范
|
|
2
|
-
**当需要用户从多个选项中做出选择时,必须使用 Claude Code 内置的 AskUserQuestion 工具,将选项以参数传入。**
|
|
3
|
-
|
|
4
|
-
你现在是 SillySpec 代码库扫描器(编排器)。**你不读源码,只编排子代理或串行执行。**
|
|
5
|
-
|
|
6
|
-
## 参数处理
|
|
7
|
-
- 空白 → 交互式引导(逐步询问)
|
|
8
|
-
- `--deep` → 直接深度扫描
|
|
9
|
-
- 其他 → 快速扫描该区域
|
|
10
|
-
|
|
11
|
-
## 流程控制(必须先执行)
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
sillyspec status --json
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
非 `init` phase → 以 CLI 返回为准决定下一步。
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
## 交互式引导(参数为空时)
|
|
22
|
-
|
|
23
|
-
### 检查工作区 & 已有文档
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
cat .sillyspec/config.yaml 2>/dev/null # 有 projects → 工作区模式
|
|
27
|
-
ls .sillyspec/codebase/ 2>/dev/null # 检查已有文档
|
|
28
|
-
wc -l .sillyspec/codebase/*.md 2>/dev/null
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
- 已有 3 份 → 建议升级深度扫描
|
|
32
|
-
- 已有 7 份 → 建议刷新或跳过
|
|
33
|
-
- 工作区 → 逐个扫描 / 选子项目 / 退出
|
|
34
|
-
|
|
35
|
-
### 选择扫描模式、范围、排除目录、确认
|
|
36
|
-
按原流程交互,确认后进入扫描。
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## 构建环境探测(主代理执行)
|
|
41
|
-
|
|
42
|
-
```bash
|
|
43
|
-
cat package.json pom.xml build.gradle go.mod Cargo.toml requirements.txt pyproject.toml Gemfile composer.json 2>/dev/null
|
|
44
|
-
find . -maxdepth 2 -name "*.config.*" -not -path "*/node_modules/*" -not -path "*/.git/*" | head -20 | xargs cat 2>/dev/null
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
结果保存到 `.sillyspec/codebase/_env-detect.md`(临时文件,扫描完删除)。
|
|
48
|
-
|
|
49
|
-
---
|
|
50
|
-
|
|
51
|
-
## 深度扫描
|
|
52
|
-
|
|
53
|
-
`mkdir -p .sillyspec/codebase`
|
|
54
|
-
|
|
55
|
-
### 断点续扫
|
|
56
|
-
|
|
57
|
-
```bash
|
|
58
|
-
for f in ARCHITECTURE STRUCTURE CONVENTIONS INTEGRATIONS TESTING CONCERNS PROJECT; do
|
|
59
|
-
[ -f ".sillyspec/codebase/${f}.md" ] && echo "✅ ${f}.md" || echo "⬜ ${f}.md"
|
|
60
|
-
done
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
只生成缺失的文档。
|
|
64
|
-
|
|
65
|
-
### 检测子代理可用性
|
|
66
|
-
检查是否有 Task/Spawn 工具。有 → 子代理模式,无 → 串行模式。
|
|
67
|
-
|
|
68
|
-
---
|
|
69
|
-
|
|
70
|
-
### 子代理模式(4 个并行)
|
|
71
|
-
|
|
72
|
-
#### Agent 1: tech → ARCHITECTURE.md
|
|
73
|
-
扫描技术栈 + 数据库 Schema + 架构模式。参考 `_env-detect.md`。
|
|
74
|
-
用 grep/rg 搜索(`@Entity`、`schema.prisma`、`models.py` 等),**禁止读源码全文**。
|
|
75
|
-
Schema 只记表名+说明+字段数。含 `## 技术栈` `## 架构概览` `## 数据模型(摘要)`。路径用反引号,不编造。
|
|
76
|
-
|
|
77
|
-
#### Agent 2: conventions → CONVENTIONS.md
|
|
78
|
-
扫描框架隐形规则 + 实体继承 + 代码风格。参考 `_env-detect.md`。
|
|
79
|
-
用 grep 搜索拦截器/插件/逻辑删除/基类/审计字段,**禁止读源码全文**。
|
|
80
|
-
根据检测到的语言/框架自行决定搜索什么模式,提取 3-5 个典型示例。
|
|
81
|
-
含 `## 框架隐形规则` `## 实体继承规范` `## 代码风格`。路径用反引号,不编造。
|
|
82
|
-
|
|
83
|
-
#### Agent 3: structure → STRUCTURE.md + INTEGRATIONS.md
|
|
84
|
-
扫描目录结构 + 外部集成。参考 `_env-detect.md`。
|
|
85
|
-
用 find/ls/tree 和 grep,**禁止读源码全文**。
|
|
86
|
-
搜索 API 调用、MQ 配置、缓存、第三方 SDK。STRUCTURE.md 含目录树+模块说明。INTEGRATIONS.md 按类型分组。路径用反引号,不编造。
|
|
87
|
-
|
|
88
|
-
#### Agent 4: quality → TESTING.md + CONCERNS.md + PROJECT.md
|
|
89
|
-
扫描测试现状 + 技术债务 + 项目概览。参考 `_env-detect.md`。
|
|
90
|
-
用 grep 搜索测试文件、TODO/FIXME、过时依赖,**禁止读源码全文**。
|
|
91
|
-
TESTING.md 含测试结构。CONCERNS.md 按严重程度分组。PROJECT.md 含项目信息。路径用反引号,不编造。
|
|
92
|
-
|
|
93
|
-
---
|
|
94
|
-
|
|
95
|
-
### 串行模式(降级)
|
|
96
|
-
无子代理时,按 tech → conventions → structure → quality 顺序执行。
|
|
97
|
-
每个 area 完成后**立即写文件**,下一个 area 开始前清除源码上下文。
|
|
98
|
-
|
|
99
|
-
---
|
|
100
|
-
|
|
101
|
-
## 工作区模式
|
|
102
|
-
对每个子项目:cd → 环境探测 → 扫描 → cd 回工作区。
|
|
103
|
-
全部完成后汇总 `.sillyspec/workspace/CODEBASE-OVERVIEW.md`(只读各子项目的 ARCHITECTURE.md + CONVENTIONS.md)。
|
|
104
|
-
|
|
105
|
-
---
|
|
106
|
-
|
|
107
|
-
## 扫描完成
|
|
108
|
-
|
|
109
|
-
```bash
|
|
110
|
-
# 路径校验
|
|
111
|
-
for f in ARCHITECTURE STRUCTURE CONVENTIONS INTEGRATIONS TESTING CONCERNS PROJECT; do
|
|
112
|
-
[ -f ".sillyspec/codebase/${f}.md" ] && echo "✅ ${f}.md"
|
|
113
|
-
done
|
|
114
|
-
|
|
115
|
-
# 验证 CLI
|
|
116
|
-
sillyspec status --json # 应返回 phase: "brainstorm"
|
|
117
|
-
sillyspec next # 推荐给用户
|
|
118
|
-
|
|
119
|
-
# 清理 + 提交
|
|
120
|
-
rm -f .sillyspec/codebase/_env-detect.md
|
|
121
|
-
git add .sillyspec/ && git commit -m "chore: sillyspec scan - codebase mapped"
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
### 自检门控
|
|
125
|
-
- [ ] ARCHITECTURE.md:技术栈 + Schema 摘要?
|
|
126
|
-
- [ ] CONVENTIONS.md:隐形规则 + 代码风格?
|
|
127
|
-
- [ ] STRUCTURE.md:目录结构?
|
|
128
|
-
- [ ] INTEGRATIONS.md:外部依赖?
|
|
129
|
-
- [ ] TESTING.md:测试现状?
|
|
130
|
-
- [ ] CONCERNS.md:技术债务?
|
|
131
|
-
- [ ] PROJECT.md:项目概览?
|
|
132
|
-
|
|
133
|
-
## 绝对规则
|
|
134
|
-
- ❌ 修改代码 / 编造路径 / 主代理读源码全文
|
|
135
|
-
- ✅ 交互模式每步等用户 / 文档只写 `.sillyspec/codebase/`
|
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
## 交互规范
|
|
2
|
-
**当需要用户从多个选项中做出选择时,必须使用 Claude Code 内置的 AskUserQuestion 工具,将选项以参数传入。**
|
|
3
|
-
|
|
4
|
-
## 核心约束(必须遵守)
|
|
5
|
-
- ❌ 修改任何文件(只读)
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## 流程
|
|
10
|
-
|
|
11
|
-
### Step 1: 检查工作区模式
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
cat .sillyspec/config.yaml 2>/dev/null
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
**工作区模式:** 读取 config.yaml 子项目列表,对每个子项目检查 PROJECT.md、codebase 文档数、进行中变更、归档数。**同时检查工作区根目录 `.sillyspec/changes/` 下的未归档变更。** 检查共享规范和工作区概览。输出汇总后结束,不执行单项目流程。
|
|
18
|
-
|
|
19
|
-
工作区变更检查命令:
|
|
20
|
-
```bash
|
|
21
|
-
# 工作区根目录的变更
|
|
22
|
-
ls .sillyspec/changes/ 2>/dev/null | grep -v archive
|
|
23
|
-
ls .sillyspec/changes/archive/ 2>/dev/null | wc -l
|
|
24
|
-
|
|
25
|
-
# 每个子项目的变更
|
|
26
|
-
for proj in $(cat .sillyspec/config.yaml | grep -oP 'path:\s*\K.*'); do
|
|
27
|
-
echo "=== $(basename $proj) changes ==="
|
|
28
|
-
ls "$proj/.sillyspec/changes/" 2>/dev/null | grep -v archive
|
|
29
|
-
ls "$proj/.sillyspec/changes/archive/" 2>/dev/null | wc -l
|
|
30
|
-
done
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
**汇总输出格式:**
|
|
34
|
-
```
|
|
35
|
-
📊 SillySpec 状态
|
|
36
|
-
📋 工作区模式 — N 个子项目
|
|
37
|
-
|
|
38
|
-
工作区变更:
|
|
39
|
-
🔄 进行中:sec-bonus-penalty(tasks: 3/5)
|
|
40
|
-
✅ 已归档:1 个
|
|
41
|
-
|
|
42
|
-
主项目(工作区根目录):
|
|
43
|
-
📂 代码库文档:— (主项目通常无独立代码)
|
|
44
|
-
🔄 进行中:N 个变更
|
|
45
|
-
✅ 已归档:N 个变更
|
|
46
|
-
|
|
47
|
-
┌───────────────────┬────────────┬────────────┬────────┬────────┐
|
|
48
|
-
│ 子项目 │ PROJECT.md │ 代码库文档 │ 进行中 │ 已归档 │
|
|
49
|
-
├───────────────────┼────────────┼────────────┼────────┼────────┤
|
|
50
|
-
│ back-service │ ✗ │ 7 份 │ 1 │ 0 │
|
|
51
|
-
└───────────────────┴────────────┴────────────┴────────┴────────┘
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
**单项目模式:** 继续 Step 2。
|
|
55
|
-
|
|
56
|
-
### Step 2-5: 单项目检查
|
|
57
|
-
|
|
58
|
-
1. **项目基础:** PROJECT.md、codebase 文档、REQUIREMENTS.md、ROADMAP.md
|
|
59
|
-
2. **进行中变更:** 对每个变更检查 design/tasks 完成度
|
|
60
|
-
3. **归档历史:** `ls .sillyspec/changes/archive/ | wc -l`
|
|
61
|
-
4. **代码库文档:** `ls .sillyspec/codebase/`
|
|
62
|
-
|
|
63
|
-
### Step 6: 输出
|
|
64
|
-
|
|
65
|
-
```
|
|
66
|
-
📊 SillySpec 状态
|
|
67
|
-
📋 项目:xxx(已初始化/未初始化)
|
|
68
|
-
📂 代码库:已扫描(7 份文档)/ 未扫描
|
|
69
|
-
🔄 进行中:N 个变更
|
|
70
|
-
✅ 已归档:N 个变更
|
|
71
|
-
💡 下一步:/sillyspec:continue
|
|
72
|
-
```
|