sillyspec 2.4.4 → 2.6.0
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/.claude/commands/sillyspec/archive.md +36 -43
- package/.claude/commands/sillyspec/brainstorm.md +86 -483
- package/.claude/commands/sillyspec/continue.md +24 -29
- package/.claude/commands/sillyspec/execute.md +63 -173
- package/.claude/commands/sillyspec/explore.md +20 -68
- package/.claude/commands/sillyspec/export.md +13 -37
- package/.claude/commands/sillyspec/init.md +25 -127
- package/.claude/commands/sillyspec/plan.md +40 -188
- package/.claude/commands/sillyspec/propose.md +36 -186
- package/.claude/commands/sillyspec/quick.md +17 -47
- package/.claude/commands/sillyspec/resume.md +22 -79
- package/.claude/commands/sillyspec/scan.md +109 -507
- package/.claude/commands/sillyspec/status.md +20 -95
- package/.claude/commands/sillyspec/verify.md +27 -86
- package/.claude/commands/sillyspec/workspace.md +27 -95
- package/.sillyspec/config.yaml +13 -0
- package/package.json +7 -2
- package/src/index.js +2 -2
- package/src/init.js +240 -75
- package/templates/archive.md +36 -43
- package/templates/brainstorm.md +81 -483
- package/templates/continue.md +20 -30
- package/templates/execute.md +63 -173
- package/templates/explore.md +15 -68
- package/templates/export.md +10 -39
- package/templates/init.md +20 -127
- package/templates/plan.md +40 -188
- package/templates/propose.md +36 -186
- package/templates/quick.md +13 -48
- package/templates/resume.md +22 -79
- package/templates/scan.md +109 -507
- package/templates/status.md +16 -96
- package/templates/verify.md +22 -86
- package/templates/workspace.md +22 -95
|
@@ -1,69 +1,62 @@
|
|
|
1
1
|
## 交互规范
|
|
2
|
-
|
|
3
2
|
**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
|
|
4
3
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
4
|
+
## 核心约束（必须遵守）
|
|
5
|
+
- ❌ 未经验证就归档（必须先确认验证通过）
|
|
6
|
+
- ❌ 未勾选的 checkbox 未告知用户就归档
|
|
7
|
+
- ❌ 归档后留下活跃变更的残留状态
|
|
8
|
+
- ❌ 覆盖已存在的归档目录
|
|
9
9
|
|
|
10
10
|
## 变更名称
|
|
11
11
|
$ARGUMENTS
|
|
12
12
|
|
|
13
|
+
---
|
|
14
|
+
|
|
13
15
|
## 流程
|
|
14
16
|
|
|
15
|
-
### 1.
|
|
17
|
+
### 1. 前置检查（门禁）
|
|
18
|
+
|
|
19
|
+
读取 `.sillyspec/changes/<change-name>/` 下所有必要文件，逐项检查：
|
|
16
20
|
|
|
17
|
-
|
|
21
|
+
- [ ] **verify 状态：** 检查是否有验证记录，无则提示先执行 `/sillyspec:verify`
|
|
22
|
+
- [ ] **文件完整性：** 检查 `proposal.md` 和 `design.md` 是否存在，缺失则警告
|
|
23
|
+
- [ ] **任务完成度：** 读取 `tasks.md`，统计已完成/未完成任务数。**有未完成的 → 用 AskUserQuestion 询问：**
|
|
24
|
+
- ① 继续归档（未完成任务将被标记完成）
|
|
25
|
+
- ② 取消，回去完成任务
|
|
18
26
|
|
|
19
|
-
|
|
27
|
+
> 任一门禁不通过且用户选择取消 → 终止流程。
|
|
20
28
|
|
|
21
|
-
###
|
|
29
|
+
### 2. 展示归档清单
|
|
22
30
|
|
|
23
|
-
|
|
31
|
+
展示即将归档的内容摘要：
|
|
24
32
|
- 变更目录名
|
|
25
33
|
- 包含的文件列表
|
|
26
|
-
-
|
|
34
|
+
- 任务完成统计（✅ 已完成 / ⬜ 未完成）
|
|
35
|
+
- 一句话总结本次变更
|
|
27
36
|
|
|
28
|
-
|
|
37
|
+
### 3. Spec 沉淀
|
|
29
38
|
|
|
30
|
-
|
|
31
|
-
1. 确认归档
|
|
32
|
-
2. 取消
|
|
39
|
+
将 `.sillyspec/changes/<change-name>/specs/` 下的设计文档**复制到 `.sillyspec/specs/` 主目录**，确保已完成的设计规范可被后续变更参考。如目标已存在同名文件则跳过并提示。
|
|
33
40
|
|
|
34
|
-
|
|
41
|
+
### 4. 用户确认
|
|
35
42
|
|
|
36
|
-
|
|
43
|
+
用 AskUserQuestion 让用户确认：
|
|
44
|
+
- ① 确认归档
|
|
45
|
+
- ② 取消
|
|
37
46
|
|
|
38
|
-
|
|
47
|
+
### 5. 执行归档
|
|
39
48
|
|
|
40
|
-
|
|
49
|
+
- 目标路径：`.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/`
|
|
50
|
+
- **检查目标路径是否已存在**，存在则中止并报错，防止覆盖
|
|
51
|
+
- 移动变更目录到归档路径
|
|
41
52
|
|
|
42
|
-
|
|
53
|
+
### 6. 归档后更新
|
|
43
54
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
git add .sillyspec/
|
|
48
|
-
git commit -m "docs: archive sillyspec change <change-name>"
|
|
49
|
-
```
|
|
55
|
+
- **tasks.md：** 确保所有 checkbox 都已勾选 `[x]`
|
|
56
|
+
- **ROADMAP.md**（如存在）：标记对应 Phase 已完成
|
|
57
|
+
- **STATE.md：** 清除当前变更信息，历史记录追加归档完成
|
|
58
|
+
- **Git 提交：** `git add .sillyspec/ && git commit -m "docs: archive sillyspec change <change-name>"`
|
|
50
59
|
|
|
51
60
|
### 最后说：
|
|
52
61
|
|
|
53
|
-
> ✅ 变更 `<change-name>`
|
|
54
|
-
>
|
|
55
|
-
> 累积规范：
|
|
56
|
-
> - `.sillyspec/changes/archive/` — X 个已归档变更
|
|
57
|
-
> - `.sillyspec/specs/` — X 份设计文档
|
|
58
|
-
> - `.sillyspec/plans/` — X 份实现计划
|
|
59
|
-
>
|
|
60
|
-
> 继续下一个：`/sillyspec:brainstorm "新想法"`
|
|
61
|
-
|
|
62
|
-
### 更新 STATE.md
|
|
63
|
-
|
|
64
|
-
archive 完成后，**必须自动更新** `.sillyspec/STATE.md`：
|
|
65
|
-
|
|
66
|
-
- 清除当前变更信息（归档后不再活跃）
|
|
67
|
-
- 如果是主变更（有 MASTER.md），标记所有阶段为 ✅，然后清除
|
|
68
|
-
- 历史记录追加时间 + 归档完成
|
|
69
|
-
- 下一步改为 `/sillyspec:brainstorm "新想法"` 或留空
|
|
62
|
+
> ✅ 变更 `<change-name>` 已归档到 `archive/YYYY-MM-DD-<change-name>/`。继续：`/sillyspec:brainstorm "新想法"`
|