sillyspec 3.22.6 → 3.22.8

package/.claude/skills/sillyspec-brainstorm/SKILL.md

@@ -64,10 +64,16 @@ sillyspec run brainstorm --done --answer "..." --output "..."    # 一步完成
 ## 阶段流转
 
 ```
-scan → brainstorm → plan
+                ┌─ scale=large → plan（四件套齐）
+scan → brainstorm ┤
+                └─ scale=small → quick --linked-changes（仅 design.md）
 ```
 
-brainstorm 完成后（四件套齐 + 自审通过），运行 `sillyspec run plan --change <变更名>` 进入实现计划。
+brainstorm 完成时按 design.md frontmatter 的 `scale` 分叉：
+- **large**（多文件/跨模块/有状态机或 schema 变更）：四件套齐 + 自审通过 → `sillyspec run plan --change <变更名>`
+- **small**（≤2 文件、单模块、无跨模块依赖）：仅生成 design.md → `sillyspec run quick --linked-changes <变更名>`
+
+> 规模由 AI 在 brainstorm 最后一步评估并写入 design.md frontmatter。判错可手动改 `scale` 后再跑相应阶段。
 
 ## 铁律
 

package/.claude/skills/sillyspec-quick/SKILL.md

@@ -7,6 +7,7 @@ description: 用于明确、低风险、范围很小的直接任务。适合用
 
 - 明确、低风险、范围小的直接修改：改文案、修小 bug、更新单个文件
 - 用户说"直接改、快速修、顺手调整、不要完整流程"
+- brainstorm 判定 `scale=small` 的变更：带 design.md 进 quick（`sillyspec run quick --linked-changes <变更名>`），design 当背景
 - 跳过 brainstorm/plan，但仍走 quick 的 3 步流程（理解任务 → 实现 → 自检提交）
 
 ## 多变更说明（quick 特殊，务必注意）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.22.6",
+  "version": "3.22.8",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",

package/src/run.js

@@ -1571,6 +1571,25 @@ export async function runCommand(args, cwd, specDir = null) {
     }
   }
 
+  // quick 启动（非 --done）：reset steps + 生成 quickRunId，避免多会话共享 progress.default.quick
+  // 继承并行会话的 step1（会话 B 复用会话 A 的 ql，本会话改动无 ql 记录）。C-实用方案：
+  // 每次 quick 启动 reset steps（逻辑隔离，本会话从 step1 重跑建独立 ql）+ 写 current-quick-run-id。
+  if (stageName === 'quick' && !isDone && !isStatus && !isSkip && !isReset && !isReopen) {
+    const qStage = progress.stages?.quick
+    if (qStage?.steps?.length) {
+      qStage.steps = qStage.steps.map(s => ({ ...s, status: 'pending', completedAt: null }))
+      qStage.status = 'in-progress'
+    }
+    try {
+      const now = new Date()
+      const pad = (n) => String(n).padStart(2, '0')
+      const quickRunId = `quick-${now.getFullYear()}-${pad(now.getMonth()+1)}-${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`
+      const runtimeRoot = platformOpts.runtimeRoot || join(specRoot, '.runtime')
+      mkdirSync(runtimeRoot, { recursive: true })
+      writeFileSync(join(runtimeRoot, 'current-quick-run-id'), quickRunId)
+    } catch {}
+  }
+
   // 确保步骤已初始化
   const changed = await ensureStageSteps(progress, stageName, cwd, specRoot)
   if (changed && effectiveChange) {
@@ -1832,6 +1851,7 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
     try {
       const gitResult = safeGit(cwd, ['rev-parse', 'HEAD'])
       const scanGuard = {
+        name_zh: '扫描守卫',
         sourceCommit: gitResult.value,
         sourceCommitError: gitResult.error,
         startedAt: new Date().toISOString(),
@@ -1878,6 +1898,7 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
       const allowNew = quickOpts?.isAllowNew || false
       const forceBaseline = quickOpts?.isForceBaseline || false
       progress.quickGuard = {
+        name_zh: '快速任务守卫',
         baselineCommit: safeGit(cwd, ['rev-parse', 'HEAD']).value,
         baselineFiles,
         allowedFiles,

package/src/stages/archive.js

@@ -23,6 +23,9 @@ export const definition = {
       name: 'extract-module-impact',
       prompt: `按照 \`.sillyspec/workflows/archive-impact.yaml\` 中定义的 \`impact-analyzer\` 角色规则，分析本次变更影响的模块。
 
+### 文件标题规则（sillyhub 平台解析识别用）
+module-impact.md 第一行标题必须用中文：# 模块影响分析（Module Impact）— <变更简述>
+
 ### 操作
 1. 读取 \`.sillyspec/workflows/archive-impact.yaml\`，了解角色定义和检查规则
 2. 读取变更目录下的 proposal.md、design.md、tasks.md

package/src/stages/brainstorm.js

@@ -329,6 +329,9 @@ HTML 原型文件路径（或"跳过"如果不适合）`,
       name: '写设计文档并自审',
       prompt: `撰写 design 文档并进行 AI 自审。
 
+### 文件标题规则（sillyhub 平台解析识别用）
+design.md 第一行标题必须用中文：# 设计文档（Design）— <变更简述>
+
 ### design.md 必须包含的章节
 1. **背景**：为什么做、解决什么问题
 2. **设计目标**：要达成什么
@@ -519,18 +522,21 @@ status: passed | needs-user-input | blocked | skipped
       requiresWait: true,
       waitReason: '等待用户最终确认设计方案',
       waitOptions: ['确认', '需要修改', '推翻重来'],
-      prompt: `用户确认设计方案，生成规范文件。
+      prompt: `用户确认设计方案，按变更规模生成规范文件并给出实现路径建议。
+
+### 规模评估（展示前先做）
+读取 design.md 的「文件变更清单」，判断本次变更规模：
+- **small（小变更）**：改动 ≤ 2 个文件、单模块、无跨模块依赖、无状态机/schema/API 变更
+- **large（大变更）**：不满足上述任意一条
+在 design.md frontmatter 写入 \`scale: small\` 或 \`scale: large\`（frontmatter 不存在则补 \`author\`/\`created_at\`/\`scale\`）。规模决定下面的产物范围和实现路径。
 
 ### 操作
-1. 展示 design.md 摘要给用户
+1. 展示 design.md 摘要 + **规模评估结果（small/large + 一句依据）** 给用户
 2. 暂停等待用户选择：✅ 确认 / ✏️ 修改 / ❌ 推翻重来
-3. 确认后，在 \`.sillyspec/changes/<change-name>/\` 下生成所有规范文件：
-   - **design.md**：架构决策、文件变更清单、数据模型、API 设计、兼容策略、风险登记、自审
-   - **decisions.md**（可选）：Grill/重大决策台账，使用 D-001@v1 稳定版本 ID
-   - **proposal.md**：动机、关键问题（为什么现有方案不够）、变更范围、不在范围内（显式清单）、成功标准（可验证条件）
-   - **requirements.md**：角色表 + FR 编号需求 + Given/When/Then 行为规格 + 非功能需求 + D-xxx@vN 覆盖关系
-   - **tasks.md**：任务列表（只列名称、对应文件路径、覆盖的 FR-xxx/D-xxx@vN，细节在 plan 阶段展开）
-   - \`git add .sillyspec/\` — 暂存规范文件（不要 commit）
+3. 确认后，**按规模生成规范文件**：
+   - **scale=large**：在 \`.sillyspec/changes/<change-name>/\` 下生成完整四件套（design.md / decisions.md 可选 / proposal.md / requirements.md / tasks.md），实现路径 → \`sillyspec run plan --change <变更名>\`
+   - **scale=small**：只生成/补全 design.md（proposal/requirements/tasks 对 quick 无用，不生成），实现路径 → \`sillyspec run quick --linked-changes <变更名>\`
+   - 两种规模都执行 \`git add .sillyspec/\` — 暂存规范文件（不要 commit）
 
 所有规范文件头部必须包含 YAML frontmatter：
 \`\`\`\`yaml
@@ -542,7 +548,7 @@ created_at: <now-datetime>
 
 ### proposal.md 格式要求
 \`\`\`markdown
-# Proposal
+# 提案书（Proposal）
 
 ## 动机
 为什么做、解决什么核心问题
@@ -565,7 +571,7 @@ created_at: <now-datetime>
 
 ### requirements.md 格式要求
 \`\`\`markdown
-# Requirements
+# 需求规格（Requirements）
 
 ## 角色
 | 角色 | 说明 |
@@ -595,7 +601,7 @@ Then 期望结果
 
 ### decisions.md 格式要求（仅在有 Grill/重大决策时生成）
 \`\`\`markdown
-# Decisions
+# 决策记录（Decisions）
 
 ## D-001@v1: 决策短标题
 - type: definition | consistency | feasibility | term | boundary | premise | architecture | compatibility | risk
@@ -637,8 +643,9 @@ Then 期望结果
 - 推翻重来回到 Step 6（对话式探索）
 - 表名/字段名/类名必须来自真实代码或标注"新增"
 - 如果存在 decisions.md，requirements.md 必须引用全部当前版本 D-xxx@vN；没有覆盖的 D-xxx@vN 必须标注为剩余风险
-- 如果 Design Grill 产生 P0/P1 unresolved blocker，必须回到 design 修正，不能进入 plan
-- tasks.md 只列任务名，细节在 plan 阶段展开`,
+- 如果 Design Grill 产生 P0/P1 unresolved blocker，必须回到 design 修正，不能进入 plan/quick
+- tasks.md 只列任务名，细节在 plan 阶段展开
+- **规范 md 文件第一行标题用中文**（sillyhub 平台解析识别用）：tasks.md 第一行用 # 任务清单（Tasks）（proposal/design/requirements/decisions 见各自模板，均已含中文标题）`,
 
     }
   ]

package/src/stages/execute.js

@@ -627,7 +627,7 @@ task-XX 对应：.sillyspec/.runtime/execute-runs/{EXECUTE_RUN_ID}/tasks/task-XX
 
 **review.json 必填字段：**
 
-{ "schemaVersion": 1, "task": "task-XX", "base": "<git-base-commit>", "head": "<git-head-commit>",
+{ "name_zh": "任务评审", "schemaVersion": 1, "task": "task-XX", "base": "<git-base-commit>", "head": "<git-head-commit>",
  "changedFiles": ["src/foo.js"], "specVerdict": "pass|fail|cannot_verify",
  "qualityVerdict": "pass|fail|cannot_verify", "reviewerNotes": "评审说明",
  "requiredEvidence": [] }

package/src/stages/plan.js

@@ -200,7 +200,7 @@ plan_level: none
 plan_level: light
 ---
 
-# 轻量计划：<需求简述>
+# 轻量计划（Light Plan）：<需求简述>
 
 ## 来源
 直接引用 brainstorm 结论或用户原始需求，不重新扩写。
@@ -243,7 +243,7 @@ light 计划的约束：
 plan_level: full
 ---
 
-# 实现计划
+# 实现计划（Plan）
 
 ## Spike 前置验证（如需要）
 | Spike | 验证内容 | 不通过后果 |
@@ -400,6 +400,7 @@ export function buildCoordinatorStep(changeDir, taskNames) {
 ---
 id: task-${num}
 title: ${name}
+title_zh: <任务中文标题>
 author: <git-user>
 created_at: <now-datetime>
 priority: P0

package/src/stages/scan.js

@@ -159,6 +159,14 @@ export const definition = {
 - 断点续扫步骤列出的缺失文档列表
 - 环境探测结果摘要（如有 _env-detect.md，直接贴入）
 - **⚠️ 必须强调：子代理必须用 write 工具将文件写入磁盘**
+- **文件标题用中文**（sillyhub 平台解析识别用）：每份 scan 文档第一行用 # 中文名（English）格式：
+  - STRUCTURE.md = # 目录结构（Structure）
+  - CONVENTIONS.md = # 代码约定（Conventions）
+  - ARCHITECTURE.md = # 架构（Architecture）
+  - TESTING.md = # 测试（Testing）
+  - CONCERNS.md = # 关注点（Concerns）
+  - INTEGRATIONS.md = # 集成（Integrations）
+  - PROJECT.md = # 项目（Project）
 
 ### 完成后
 列出每个项目的 7 份文档状态：
@@ -451,7 +459,7 @@ step1 → step2 → step3
 
 文件格式：
 \`\`\`markdown
-# Glossary
+# 术语表（Glossary）
 
 ## Session
 在本项目中，session 指...（项目内特殊含义）
@@ -486,9 +494,9 @@ step1 → step2 → step3
 
 INDEX.md 维护索引，格式（每行：关键词1|关键词2 → [条目名](文件#锚点)；关键词用于 execute 阶段命中匹配，必须给出能区分该知识的词）：
 \`\`\`markdown
-# Knowledge Index
+# 知识索引（Knowledge Index）
 
-## Conventions
+## 约定（Conventions）
 - ESM|module|import → [ESM Only](conventions.md#esm-only)
 \`\`\`
 
@@ -498,6 +506,7 @@ INDEX.md 维护索引，格式（每行：关键词1|关键词2 → [条目名](
 3. **不确定分类或不确定长期有效 → uncategorized.md** — 宁可不确定也不要放错
 4. **每个正式分类条目必须更新 INDEX.md** — 添加对应分类下的链接
 5. **每个条目用 markdown 锚点格式** — 文件内用 \`## 标题\`，INDEX 用 \`[#标题]\` 或 \`(文件名#标题)\`
+6. **knowledge 文件标题用中文**（sillyhub 平台解析识别用）：conventions.md 第一行 # 项目约定（Conventions）、patterns.md = # 复用模式（Patterns）、known-issues.md = # 已知问题（Known Issues）、uncategorized.md = # 未分类知识（Uncategorized）、INDEX.md 见模板（知识索引）
 
 ### 操作
 1. 读取现有 knowledge 文件：\`{KNOWLEDGE_ROOT}/INDEX.md\`、\`{KNOWLEDGE_ROOT}/conventions.md\` 等

package/src/stages/verify.js

@@ -264,7 +264,7 @@ grep -rl "<关键词>" <源码目录>/ --include="*.java" --include="*.js" --inc
 
 ### verify-result.md 格式
 \`\`\`markdown
-# 验证报告
+# 验证报告（Verify Result）
 
 ## 结论
 PASS / PASS WITH NOTES / FAIL

package/src/worktree.js

@@ -315,7 +315,8 @@ export class WorktreeManager {
     // worktree 内任何已写入的内容，不触发幽灵清理）。最终完整 meta 在 step 6 覆盖。
     try {
       const placeholderMeta = {
-        changeName: name,
+        name_zh: 'worktree 元数据',
+      changeName: name,
         branch,
         baseBranch,
         baseHash,
@@ -381,6 +382,7 @@ export class WorktreeManager {
 
     // 6. 写入 meta.json
     const meta = {
+      name_zh: 'worktree 元数据',
       changeName: name,
       branch,
       baseBranch,
@@ -416,6 +418,7 @@ export class WorktreeManager {
   _recoverNativeWorktreeMeta(name, { worktreePath, branch }) {
     const baseHash = gitQuiet(worktreePath, 'rev-parse HEAD') || null
     const meta = {
+      name_zh: 'worktree 元数据',
       changeName: name,
       branch: branch || BRANCH_PREFIX + name,
       baseBranch: branch,
@@ -459,7 +462,8 @@ export class WorktreeManager {
       baseBranch = baseBranch || gitQuiet(this.cwd, 'symbolic-ref --short HEAD') || gitQuiet(this.cwd, 'rev-parse HEAD')
       baseHash = baseHash || git(this.cwd, 'rev-parse HEAD')
       const meta = {
-        changeName: name,
+        name_zh: 'worktree 元数据',
+      changeName: name,
         branch: branch || BRANCH_PREFIX + name,
         baseBranch,
         baseHash,
@@ -494,6 +498,7 @@ export class WorktreeManager {
     }
 
     const meta = {
+      name_zh: 'worktree 元数据',
       changeName: name,
       branch: branch || BRANCH_PREFIX + name,
       baseBranch,