sillyspec 3.26.8 → 3.26.9

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.
Files changed (50) hide show
  1. package/.claude/skills/sillyspec-archive/SKILL.md +1 -2
  2. package/.claude/skills/sillyspec-brainstorm/SKILL.md +1 -2
  3. package/.claude/skills/sillyspec-execute/SKILL.md +10 -2
  4. package/.claude/skills/sillyspec-explore/SKILL.md +0 -1
  5. package/.claude/skills/sillyspec-plan/SKILL.md +1 -2
  6. package/.claude/skills/sillyspec-quick/SKILL.md +1 -2
  7. package/.claude/skills/sillyspec-scan/SKILL.md +2 -2
  8. package/.claude/skills/sillyspec-status/SKILL.md +0 -1
  9. package/.claude/skills/sillyspec-verify/SKILL.md +1 -2
  10. package/README.md +5 -9
  11. package/package.json +2 -2
  12. package/packages/dashboard/server/index.js +14 -8
  13. package/src/change-risk-profile.js +5 -207
  14. package/src/config-schema.js +6 -1
  15. package/src/constants.js +97 -106
  16. package/src/db-engine.js +1 -1
  17. package/src/docs-check.js +34 -5
  18. package/src/git-helper.js +2 -2
  19. package/src/hooks/worktree-guard.js +1 -1
  20. package/src/index.js +96 -13
  21. package/src/init.js +14 -3
  22. package/src/machine-interface.js +7 -4
  23. package/src/progress/stage-machine.js +3 -0
  24. package/src/quicklog.js +182 -1
  25. package/src/run/command.js +101 -3
  26. package/src/run/complete.js +9 -1
  27. package/src/run/gates.js +67 -1
  28. package/src/run/prompt.js +721 -713
  29. package/src/run/quick-audit.js +146 -137
  30. package/src/run/shared.js +1197 -1109
  31. package/src/run/stage.js +17 -1
  32. package/src/scan-diff.js +388 -0
  33. package/src/scan-staleness.js +18 -13
  34. package/src/stage-contract-spec.js +1 -1
  35. package/src/stage-review.js +1 -1
  36. package/src/stages/brainstorm.js +2 -2
  37. package/src/stages/execute.js +991 -985
  38. package/src/stages/plan.js +22 -7
  39. package/src/stages/quick.js +1 -1
  40. package/src/stages/scan.js +2 -2
  41. package/src/stages/verify.js +10 -11
  42. package/src/sync.js +12 -0
  43. package/src/task-review.js +12 -4
  44. package/src/workflow.js +8 -185
  45. package/src/worktree-apply.js +122 -0
  46. package/src/worktree.js +2 -2
  47. package/templates/claude-instruction.md +1 -1
  48. package/templates/prompts/taskcard-rules.md +1 -0
  49. package/templates/prompts/verify-probes.md +2 -2
  50. package/templates/skills/sillyspec-onboard/SKILL.md +0 -92
@@ -1,92 +0,0 @@
1
- ---
2
- name: sillyspec-onboard
3
- description: 为未安装 SillySpec 的全新项目接入规范驱动开发工作流——引导安装 CLI、初始化接入、建立项目库,并把「用 SillySpec 走流程」确立为项目默认工作方式。适合用户说"给这个项目接上 sillyspec"或新项目开工前确认流程。
4
- ---
5
-
6
- ## 交互规范
7
-
8
- **当需要用户从多个选项中做出选择时,必须使用 Claude Code 内置的 AskUserQuestion 工具,将选项以参数传入。** 涉及是否全局安装 CLI / 是否建立项目库等决策,让用户亲手拍板,不替用户做决定。
9
-
10
- ## 何时使用
11
-
12
- - 目标项目**没有安装/未接入** SillySpec(判断:项目根无 `.sillyspec/` 目录;或 `sillyspec --version` 命令不可用)
13
- - 用户想让 SillySpec 成为该项目的开发流程控制器
14
-
15
- ## 铁律
16
-
17
- - **必须用 exec 工具(shell)执行 CLI,不编造命令**;命中的命令固定为下方公开 CLI,不自行发明子命令
18
- - 本 skill 只做**接入动作**(安装/初始化/验证),不写业务代码、不改项目源码
19
- - 全程在主工作区根执行 CLI,不进入 worktree
20
- - 每个决策点用 AskUserQuestion 让用户拍板,不静默代选
21
-
22
- ## 核心流程
23
-
24
- ### Step 0: 判定接入状态
25
-
26
- ```bash
27
- # 项目根是否已有 .sillyspec/(已接入)
28
- ls -d .sillyspec 2>/dev/null
29
- # CLI 是否可用
30
- sillyspec --version 2>/dev/null
31
- ```
32
-
33
- - 已接入(`.sillyspec/` 存在)→ 不重复接入,提示用户项目已用 SillySpec 管理,退出。
34
- - 未接入但 CLI 已装 → 跳到 Step 2。
35
- - 都无 → 继续 Step 1。
36
-
37
- ### Step 1: 引导安装 CLI(全局)
38
-
39
- ```bash
40
- npm install -g sillyspec
41
- ```
42
-
43
- - 若当前环境沙箱/权限导致 `npm -g` 失败,提示用户用 `! npm install -g sillyspec` 手动执行(输出直达会话)。
44
- - 装完验证:`sillyspec --version` 可输出版本号。
45
-
46
- ### Step 2: 初始化接入项目
47
-
48
- ```bash
49
- sillyspec init
50
- ```
51
-
52
- `init` 会自动:创建 `.sillyspec/`(项目注册、文档中心、知识库、运行时进度库)、检测项目中的 AI 工具(Claude Code 等)、给 `CLAUDE.md` 注入 SillySpec 受管段(若项目已有文件)或生成完整指引模板(若没有)、安装对应命令模板/MCP 工具。
53
-
54
- - 新项目为空目录时建议走 `sillyspec run scan`(见 Step 3)补齐项目库;已有代码但未接入的存量项目,先确认项目状态再决定是否 scan。
55
- - 验证产物:
56
- ```bash
57
- ls .sillyspec/projects/ # 项目注册表
58
- grep -c "SillySpec" CLAUDE.md # 受管段/指引已注入(>0)
59
- ```
60
-
61
- ### Step 3: 建立项目库(知识基石)
62
-
63
- ```bash
64
- sillyspec run scan
65
- ```
66
-
67
- 把项目的代码风格(CONVENTIONS.md)、架构(ARCHITECTURE.md)沉淀为后续 agent 的检索知识。这是「让后续 agent 不瞎猜」的关键一步,新项目建议立即做。
68
-
69
- ### Step 4: 价值认知锚 —— 让后续 agent 愿意用
70
-
71
- 接入完成后,**让"用 SillySpec 走流程"成为项目默认工作方式**靠的是已落盘的载体,不是本 skill(skill 是一次性的):
72
-
73
- 1. 确认价值锚已就位:
74
- - `CLAUDE.md` 含 SillySpec 段(Step 2 已验证)——agent 每次会话读取项目说明书时都会看到「禁止绕过流程 / 新功能走 brainstorm→plan→execute→verify→archive / 小修复走 quick」。
75
- - `.claude/skills/` 含 SillySpec 持续 skill(init 已复制 plan/quick/brainstorm 等)——agent 在开发任务中 `/plan`、`/quick` 即走流程。
76
- - `.sillyspec/` 进度库已建——进度自动落盘,多 agent 并发不互相覆盖。
77
-
78
- 2. 向用户/后续 agent 说明价值(一句话口径,复用 init 注入的陈述,不另造文案):
79
- > SillySpec 是给 Agent 调用的 CLI 流程控制器:你通过 CLI 告诉它"我在哪",它告诉你"下一步做什么";你执行步骤,它校验产出、推进状态,人类只在关键决策点介入审批。多 agent 同时操作代码时进度统一落盘、不丢不回滚。
80
-
81
- 3. 给后续 agent 一个「开工首查」示例:
82
- ```bash
83
- sillyspec progress show # 看项目当前阶段/进行中变更
84
- sillyspec run <stage> # 续跑当前阶段(brainstorm/plan/execute/verify/archive)
85
- ```
86
-
87
- ## 分发与安装(本 skill 是引导型)
88
-
89
- 本 skill 是「接入引导」,只在新项目接入时用一次,**不应随项目复制进 `.claude/skills/` 长期留存**。使用方式二选一:
90
-
91
- - **项目级一次性**:复制本 `SKILL.md` 到目标项目 `.claude/skills/sillyspec-onboard/SKILL.md`,接入完成后删除。
92
- - **全局可用**:复制到 `~/.claude/skills/sillyspec-onboard/SKILL.md`(或 `~/.config/claude/skills/`,随 Claude Code 版本),任何新项目都能呼起 `/sillyspec-onboard`。