sillyspec 3.18.4 → 3.18.6

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

@@ -68,7 +68,7 @@ $ARGUMENTS
 
 ### 关键规则
 - 不要跳过任何步骤
-- 不要手动修改 progress.json
+- 不要手动修改进度数据（SQLite 数据库）
 - 不要自动 commit，只 git add
 - 不要使用 npx
 - 不要编造不存在的 CLI 子命令

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

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:doctor
-description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复 progress.json 与实际产出不匹配的问题。
+description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
 ---
 
 ## 前置检查

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

@@ -23,6 +23,8 @@ description: 用于按 plan 执行代码实现。适合用户说"开始写代码
 - Worktree 路径在 Step 3（确认 worktree 路径）中输出，后续子代理的 cwd 必须设为该路径
 - **禁止跳过 worktree 或在主仓库直接写代码**
 - 如果 worktree 创建失败，CLI 会报错并退出，需要排查后再重试
+- **未提交的文件、dirty 状态等不影响 worktree 创建和进入，直接按 CLI 输出的 worktree 路径操作即可**
+- 不要自行检查 git 状态来判断是否可以进入 worktree，CLI 会自动处理
 
 ## 用户指令
 $ARGUMENTS

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

@@ -22,15 +22,15 @@ description: 恢复工作 — 从中断处继续
 sillyspec progress show
 ```
 
-### 2. 如果有 progress.json
+### 2. 如果有活跃变更
 
-从 progress.json 中提取并展示当前状态，使用 `sillyspec progress show` 查看。
+从 `sillyspec progress show` 输出中提取并展示当前状态。
 
 然后问用户：
    1. 直接继续执行下一步
    2. 查看更多细节
 
-### 3. 如果没有 progress.json 或变更目录
+### 3. 如果没有活跃变更
 
 自动探测项目状态：
 
@@ -64,5 +64,5 @@ cat .sillyspec/ROADMAP.md 2>/dev/null
 
 ### 4. 关键原则
 
-- progress.json 是唯一的恢复数据源（存储在 `.sillyspec/changes/<name>/progress.json` 或旧版 `.sillyspec/.runtime/progress.json`）
-- progress.json 随 `sillyspec run <stage> --done` 自动更新，不需要手动保存
+- 进度数据存储在 SQLite 数据库中（`.sillyspec/.runtime/sillyspec.db`），通过 `sillyspec progress show` 命令查看
+- 进度随 `sillyspec run <stage> --done` 自动更新，不需要手动保存

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

@@ -1,19 +1,19 @@
 ---
 name: sillyspec:state
-description: 查看当前工作状态 — 显示 progress.json 内容
+description: 查看当前工作状态 — 显示 SillySpec 进度
 ---
 
 你现在是 SillySpec 的状态查看器。
 
 ## 流程
 
-### 1. 读取 progress.json
+### 1. 读取进度
 
 ```bash
-sillyspec run state --status 2>/dev/null
+sillyspec progress show
 ```
 
-### 2. 如果有 progress.json
+### 2. 如果有活跃变更
 
 格式化展示当前状态：
 
@@ -33,9 +33,9 @@ sillyspec run state --status 2>/dev/null
 > **阻塞项**：
 > - xxx（如无则省略）
 
-### 3. 如果没有 progress.json
+### 3. 如果没有活跃变更
 
-提示用户项目还没有开始，或 progress.json 尚未生成：
+提示用户项目还没有开始：
 
 > 📊 还没有工作记录。
 >
@@ -44,11 +44,11 @@ sillyspec run state --status 2>/dev/null
 > - 已有项目：`/sillyspec:scan`
 > - 恢复中断的工作：`/sillyspec:resume`
 >
-> progress.json 会在 `sillyspec init` 时自动创建。
+> 进度数据会在 `sillyspec init` 时自动创建到 SQLite 数据库中。
 
 ### 注意
 
 - 这是只读命令，**不修改任何文件**
 - `/sillyspec:status` 查看项目整体进度（change 文件级别）
-- `/sillyspec:state` 查看当前工作状态（progress.json 级别）
+- `/sillyspec:state` 查看当前工作状态（阶段/步骤级别）
 - 两者互补：status 看"有什么"，state 看"在做什么"

package/docs/sillyspec/file-lifecycle/storage-and-state.md

@@ -43,7 +43,7 @@ created_at: 2026-06-04 16:25:42
 | `batch_progress` | 批量任务统计 |
 | `approvals` | 平台审批状态 |
 
-`progress.js` 通过 SQL 读写这些表，并组装成兼容旧 progress JSON 的 JS 对象。当前没有看到 `progress.json` 被作为权威状态写入。
+`progress.js` 通过 SQL 读写这些表，并组装成兼容旧 progress 格式的 JS 对象。进度数据仅存储在 SQLite 数据库中，不再使用 progress.json 文件。
 
 注意：`db.js` 的 `project.schema_version` DDL 默认值是 `4`，但 `progress.js` 的 `CURRENT_VERSION` 是 `3`，并在初始化/写入时使用 `3`。文档不要把这里写成稳定的 v4 schema 事实。
 

package/package.json

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

package/packages/dashboard/server/index.js

@@ -48,12 +48,13 @@ function startProgressWatch(projectPath) {
     progressWatchers.get(projectPath).refCount++
     return
   }
-  const progressFile = join(projectPath, '.sillyspec', '.runtime', 'progress.json')
-  if (!existsSync(progressFile)) return
+  // Watch the SQLite database file for changes (replaces old progress.json watch)
+  const dbFile = join(projectPath, '.sillyspec', '.runtime', 'sillyspec.db')
+  if (!existsSync(dbFile)) return
 
   let timer = null
   try {
-    const watcher = watch(progressFile, (eventType) => {
+    const watcher = watch(dbFile, (eventType) => {
       if (timer) clearTimeout(timer)
       timer = setTimeout(() => {
         timer = null

package/packages/dashboard/server/parser.js

@@ -77,18 +77,13 @@ export function parseProjectOverview(projectPath) {
 
   // --- Last active ---
   const sillyspecDir = join(projectPath, '.sillyspec')
-  const progressPath = join(sillyspecDir, '.runtime', 'progress.json')
-  if (existsSync(progressPath)) {
+  // Progress is stored in SQLite (.sillyspec/.runtime/sillyspec.db), not progress.json
+  // Use mtime of the DB file as a fallback for lastActive
+  const dbPath = join(sillyspecDir, '.runtime', 'sillyspec.db')
+  if (existsSync(dbPath)) {
     try {
-      const progress = JSON.parse(readFileSync(progressPath, 'utf-8'))
-      if (progress.stages) {
-        for (const stageData of Object.values(progress.stages)) {
-          if (stageData.lastActive && (!result.lastActive || new Date(stageData.lastActive) > new Date(result.lastActive))) {
-            result.lastActive = stageData.lastActive
-          }
-        }
-      }
-      if (progress.lastActive) result.lastActive = progress.lastActive
+      const s = statSync(dbPath)
+      result.lastActive = s.mtime.toISOString()
     } catch {}
   }
   if (!result.lastActive) {
@@ -432,81 +427,46 @@ export function parseSillyspecDocsTree(projectPath) {
 }
 
 /**
- * Parse project state from .sillyspec directory
+ * Parse project state from .sillyspec SQLite database via CLI.
+ * Progress data is stored in SQLite (.sillyspec/.runtime/sillyspec.db),
+ * accessed through `sillyspec progress show`.
  * @param {string} projectPath - Path to the project directory
- * @returns {object} Project state with currentStage, nextStep, progress, stages, specs, lastActive
+ * @returns {object|null} Project state with currentStage, stages, lastActive
  */
 export function parseProjectState(projectPath) {
   const sillyspecDir = join(projectPath, '.sillyspec')
+  const dbPath = join(sillyspecDir, '.runtime', 'sillyspec.db')
 
-  if (!existsSync(sillyspecDir)) {
+  if (!existsSync(sillyspecDir) || !existsSync(dbPath)) {
     return null
   }
 
   let currentStage = ''
-  let nextStep = null
-  let progress = { stages: {} }
-  let stages = []
-  let specs = []
   let lastActive = null
 
-  // Read progress.json for current stage
-  const progressPath = join(sillyspecDir, '.runtime', 'progress.json')
-  if (existsSync(progressPath)) {
-    try {
-      const progressData = JSON.parse(readFileSync(progressPath, 'utf-8'))
-      progress = progressData
-      currentStage = progressData.currentStage || ''
-      stages = Object.keys(progressData.stages || {})
-
-      // Find last active
-      if (progressData.lastActive) lastActive = progressData.lastActive
-      if (progressData.stages) {
-        for (const [stageName, stageData] of Object.entries(progressData.stages)) {
-          if (stageData.lastActive || stageData.startedAt) {
-            const t = stageData.lastActive || stageData.startedAt
-            if (!lastActive || new Date(t) > new Date(lastActive)) lastActive = t
-          }
-        }
-      }
-    } catch (err) {
-      // Progress file exists but couldn't be parsed
-    }
-  }
+  // Use DB file mtime as lastActive indicator
+  try {
+    const s = statSync(dbPath)
+    lastActive = s.mtime.toISOString()
+  } catch {}
 
-  // List all spec files
-  const specsDir = join(sillyspecDir, 'specs')
-  if (existsSync(specsDir)) {
-    try {
-      const specFiles = readdirSync(specsDir)
-        .filter(f => f.endsWith('.md'))
-        .sort()
-
-      specs = specFiles.map(f => {
-        const specPath = join(specsDir, f)
-        try {
-          const content = readFileSync(specPath, 'utf-8')
-          const titleMatch = content.match(/^#\s+(.+)$/m)
-          return {
-            name: f,
-            title: titleMatch ? titleMatch[1] : f,
-            path: specPath
-          }
-        } catch {
-          return { name: f, title: f, path: specPath }
-        }
-      })
-    } catch (err) {
-      // Specs directory couldn't be read
-    }
+  // Use CLI to read current stage from SQLite
+  try {
+    const output = execSync('sillyspec progress show 2>/dev/null', {
+      cwd: projectPath, encoding: 'utf-8', timeout: 5000
+    })
+    const stageMatch = output.match(/当前阶段:\s*(\S+)/)
+    if (stageMatch) currentStage = stageMatch[1]
+  } catch {
+    // CLI unavailable or no active change
   }
 
   return {
     currentStage,
-    nextStep,
-    progress,
-    stages,
-    specs,
+    nextStep: null,
+    progress: { stages: {} },
+    stages: [],
+    specs: [],
     lastActive
   }
 }

package/src/index.js

@@ -145,6 +145,21 @@ async function main() {
     targetDir = resolve(filteredArgs[1]);
     filteredArgs.splice(1, 1);
   }
+  // ── 自动纠正 cwd ──
+  // 当 agent 在 worktree 内跑 pnpm 等工具后 shell cwd 可能被改变，
+  // 导致 sillyspec 命令找不到 .sillyspec。此函数尝试从 git root 解析。
+  function resolveEffectiveDir(baseDir) {
+    if (existsSync(join(baseDir, '.sillyspec'))) return baseDir
+    try {
+      const { execSync } = require('child_process')
+      const gitRoot = execSync('git rev-parse --show-toplevel', {
+        cwd: baseDir, encoding: 'utf8', timeout: 5000
+      }).trim()
+      if (gitRoot && existsSync(join(gitRoot, '.sillyspec'))) return gitRoot
+    } catch {}
+    return baseDir
+  }
+
   const dir = targetDir;
 
   if (command === 'init' && !existsSync(dir)) {
@@ -167,6 +182,7 @@ async function main() {
       break;
     case 'progress': {
       const pm = new ProgressManager();
+      const progDir = resolveEffectiveDir(dir);
       const subCommand = filteredArgs[1];
       const stageIdx = filteredArgs.indexOf('--stage');
       const stage = stageIdx >= 0 && filteredArgs[stageIdx + 1] ? filteredArgs[stageIdx + 1] : null;
@@ -176,18 +192,18 @@ async function main() {
 
       switch (subCommand) {
         case 'init':
-          pm.init(dir);
+          pm.init(progDir);
           break;
         case 'status':
         case 'show':
-          pm.show(dir, progChangeName);
+          pm.show(progDir, progChangeName);
           break;
         case 'check':
-          await pm.checkConsistency(dir, progChangeName);
+          await pm.checkConsistency(progDir, progChangeName);
           break;
         case 'repair': {
           const repairApply = filteredArgs.includes('--apply');
-          await pm.repairConsistency(dir, { apply: repairApply, changeName: progChangeName });
+          await pm.repairConsistency(progDir, { apply: repairApply, changeName: progChangeName });
           break;
         }
         case 'validate':
@@ -270,7 +286,22 @@ async function main() {
     }
     case 'run': {
       const { runCommand } = await import('./run.js')
-      await runCommand(filteredArgs.slice(1), dir, specDir)
+      await runCommand(filteredArgs.slice(1), resolveEffectiveDir(dir), specDir)
+      break
+    }
+    // task-10: 顶层命令别名，转发 runCommand，与 case 'run': 路径行为一致
+    // help 文本(:44-46)已宣称这些 stage 可直接使用，这里补齐路由避免落 default 分支。
+    // 注意：filteredArgs[0] === command，直接透传 filteredArgs 即可让 runCommand
+    // 从 args[0] 取到 stage 名（run.js:1036）。与 case 'run': 的 filteredArgs.slice(1)
+    // 区别只在于 slice(1) 去掉的是 'run' 字面量，这里 command 本身就是 stage 名不能丢。
+    case 'doctor':
+    case 'scan':
+    case 'status':
+    case 'quick':
+    case 'explore': {
+      const { runCommand } = await import('./run.js')
+      const stageArgs = [command, ...filteredArgs.slice(1)]
+      await runCommand(stageArgs, resolveEffectiveDir(dir), specDir)
       break
     }
     case 'dashboard': {

package/src/run.js

@@ -11,6 +11,22 @@ const require = createRequire(import.meta.url)
 import { ProgressManager } from './progress.js'
 import { SCAN_STATUS, POINTER_STATUS, isPointerCorrupted } from './constants.js'
 
+/**
+ * 清洗项目名：只保留 ASCII 字母/数字/横线/下划线/点，过滤中文和特殊字符。
+ * - 必须含至少一个字母（拒绝纯数字 "0"/"7"/"07"，避免 scan-projects.json 脏数据）
+ * - 长度必须 ≥ 2（拒绝单字符 "a"/"0"）
+ * @param {string} name - 原始项目名候选
+ * @returns {string | null} 合法项目名或 null（拒绝）
+ */
+export function sanitizeProjectName(name) {
+  if (!name) return null
+  const clean = String(name).replace(/[^a-zA-Z0-9_\-.]/g, '').trim()
+  if (!clean) return null
+  if (!/[a-zA-Z]/.test(clean)) return null    // 纯数字/符号拒绝（"0"/"7"/"07"）
+  if (clean.length < 2) return null           // 单字符拒绝（"a"/"0"）
+  return clean
+}
+
 /**
  * 在容器/Docker 环境下，git 可能因目录所有权不匹配报 dubious ownership。
  * 使用 -c safe.directory= 临时参数，不污染全局 git config。
@@ -666,6 +682,12 @@ async function outputStep(stageName, stepIndex, steps, cwd, changeName, dbProjec
       `2. **不允许**用 cat >、tee、heredoc 等 Bash 方式绕过 Write 工具。\n` +
       `3. 如果 Write 和 Read 均失败，记录失败并停止当前 step。\n` +
       `\n` +
+      `### 📍 Workflow YAML 占位符映射（task-05）\n` +
+      `读取 \`{WORKFLOWS_ROOT}/scan-docs.yaml\` 时，yaml 内的占位符按以下映射替换为绝对路径：\n` +
+      `- \`{SPEC_ROOT}\` → \`${specSillyspec}\`（规范目录根）\n` +
+      `- \`<project>\` → 当前项目名（见下方 step 提示，等于 \`${projectName}\`）\n` +
+      `- 例：\`{SPEC_ROOT}/docs/<project>/scan/ARCHITECTURE.md\` → \`${docsRoot}/scan/ARCHITECTURE.md\`\n` +
+      `\n` +
       `创建目录: \`mkdir -p ${docsRoot}/{scan,modules,flows} ${projectsRoot} ${changesRoot}\`\n`
     )
     if (platformOpts.runtimeRoot) {
@@ -1416,7 +1438,9 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
   const specBase = platformOpts.specRoot || join(cwd, '.sillyspec')
   // 状态转换校验
   const prevStage = progress.currentStage || ''
-  const transition = checkTransition(prevStage, stageName)
+  // task-07: 提取 prevStage 的 stageData，传给 checkTransition 检测 failed_post_check 门控
+  const fromStageData = (progress.stages && prevStage && progress.stages[prevStage]) || undefined
+  const transition = checkTransition(prevStage, stageName, fromStageData ? { fromStageData } : {})
   if (!transition.allowed) {
     console.error(`❌ 阶段转换不允许: ${prevStage || '(起始)'} → ${stageName}`)
     console.error(`   原因: ${transition.reason}`)
@@ -2150,16 +2174,15 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
   if (stageName === 'scan' && steps[currentIdx]?.name === '构建扫描项目列表') {
     // 解析项目列表：从 step 2 输出提取，或回退读取 projects/*.yaml
     let projectNames = []
-    // 项目名清洗：只保留 ASCII 字母/数字/横线/下划线/点，过滤中文和特殊字符
-    const sanitizeProjectName = (name) => {
-      const clean = name.replace(/[^a-zA-Z0-9_\-.]/g, '').trim()
-      return clean || null
-    }
+    // sanitizeProjectName 已提取到模块顶层（含字母校验 + 长度≥2）
     if (outputText) {
       // 匹配方式 1: "1. project-name" 编号列表
-      const numbered = outputText.match(/^\s*\d+\.\s+(\S+)/gm)
+      // 正则收紧：token 必须以字母开头，避免误捕获纯数字 "0"/"7" 和步骤说明中英文行
+      const numbered = outputText.match(/^\s*\d+\.\s+([a-zA-Z][\w\-.]*)/gm)
       if (numbered) {
-        const raw = numbered.map(m => m.replace(/^\s*\d+\.\s+/, '').replace(/[—\-:].*$/, '').trim())
+        // task-05 B2 延伸修正：原 /[—\-:].*$/ 会把 ASCII 连字符当后缀分隔符，
+        // 把 order-service 切成 order。现只针对中文长破折号 `—`（LLM 输出列表时常作分隔符）。
+        const raw = numbered.map(m => m.replace(/^\s*\d+\.\s+/, '').replace(/—.*$/, '').trim())
         projectNames = raw.map(sanitizeProjectName).filter(Boolean)
         if (projectNames.length > 0) { stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.projectListParsed = true; }
       }
@@ -2434,8 +2457,18 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
           stageData.status = SCAN_STATUS.FAILED_POST_CHECK
           stageData.completedAt = new Date().toLocaleString('zh-CN',{hour12:false})
           await pm._write(cwd, progress, changeName)
+          triggerSync(cwd, changeName, platformOpts)
           console.error(`\n❌ scan post-check 失败，状态设为 failed_post_check。不允许 clean success。`)
           console.error(`   请检查上方错误信息并修复后重新 scan。`)
+          // 平台模式：exit(1) 让 daemon/SillyHub 感知非 0 退出码（manifest.json 已落盘，不会被撤销）
+          if (platformOpts.specRoot || platformOpts.runtimeRoot) {
+            console.error('   平台模式：CLI 将以 exit code 1 退出，通知 SillyHub scan 失败。')
+            process.exit(1)
+          }
+          // 接口与 plan contract (run.js:2551 附近 plan 失败分支) 对齐：
+          // 返回 { stageCompleted:false, currentIdx, nextPendingIdx: currentIdx }
+          // 让上层 runStage 走"完成但不推进"分支，--done 被拒
+          return { stageCompleted: false, currentIdx, nextPendingIdx: currentIdx }
         } else if (postResult.status === 'completed_with_warnings') {
           // 警告不阻止完成，但记录
           stageData.status = 'completed'
@@ -2623,8 +2656,17 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
       const { loadWorkflow, runPostCheck, formatCheckReport, saveWorkflowRun } = await import('./workflow.js')
       const wf = loadWorkflow(cwd, 'scan-docs')
       if (wf) {
-        // 确定当前项目：优先从 step metadata 读取，回退从 display name 提取
-        const currentProjectName = steps[currentIdx].project
+        // 确定当前项目（优先级链）：
+        //   progress.project (dbProjectName，平台模式真实项目名，与 outputStep 占位符渲染对齐)
+        //   > change?.project (变更对象的项目字段，平台模式 change 创建时传入)
+        //   > steps[idx].project (perProject 展开标记，兼容旧模式)
+        //   > steps[idx].name 正则提取 [xxx] 后缀
+        //   > null（回退检查所有项目）
+        // task-05 修复：日志显示项目名变 frontend 是 perProject 误展开 bug，
+        // 用 progress.project（与 outputStep 占位符渲染路径一致）修正 myaaa/frontend 分裂。
+        const currentProjectName = progress.project
+          || (typeof change !== 'undefined' && change ? change.project : null)
+          || steps[currentIdx].project
           || (steps[currentIdx].name.match(/\[([^\]]+)\]\s*$/) || [])[1]
           || null
 
@@ -2644,7 +2686,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
 
         let anyFailed = false
         for (const pName of projectsToCheck) {
-          const result = runPostCheck(wf, cwd, pName)
+          const result = runPostCheck(wf, cwd, pName, {}, specBase)
           const report = formatCheckReport(result)
           console.log(report)
           if (result.status === 'fail') {
@@ -2667,6 +2709,10 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
         }
         if (anyFailed) {
           console.log(`\n⚠️ 存在检查失败项，请按上面的重试提示修复后再继续。`)
+          // task-07: 阻断推进（与 task-06 平台模式 scan-postcheck 失败分支 return 结构对齐）
+          // scan 深度扫描产物校验未通过时，不允许 clean success / 进入下一 step，
+          // 让上层走"完成但不推进"分支，--done 被拒。
+          return { stageCompleted: false, currentIdx, nextPendingIdx: currentIdx }
         }
       }
     } catch (e) {
@@ -2682,7 +2728,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
       if (wf && changeName) {
         const raw = JSON.stringify(wf)
         const resolved = JSON.parse(raw.replace(/<change-name>/g, changeName))
-        const result = runPostCheck(resolved, cwd, 'sillyspec')
+        const result = runPostCheck(resolved, cwd, 'sillyspec', {}, specBase)
         // 只报告 impact-analyzer 的结果（doc-syncer 是后续步骤）
         const impactResult = (result.roles || []).find(r => r.id === 'impact-analyzer')
         if (impactResult) {

package/src/stage-contract.js

@@ -587,9 +587,11 @@ export function getContract(stageName) {
  * 校验状态转换是否允许
  * @param {string} fromStage - 当前阶段（空字符串表示变更起始）
  * @param {string} toStage - 目标阶段
+ * @param {{ fromStageData?: { status?: string } | undefined }} [options] - 可选，从 progress.stages[prevStage] 提取
  * @returns {{ allowed: boolean, reason?: string }}
  */
-export function checkTransition(fromStage, toStage) {
+export function checkTransition(fromStage, toStage, options = {}) {
+  const { fromStageData } = options  // { status?: string } | undefined
   const contract = contracts[toStage]
   if (!contract) {
     return { allowed: false, reason: `未知阶段: ${toStage}` }
@@ -605,6 +607,17 @@ export function checkTransition(fromStage, toStage) {
     return { allowed: true }
   }
 
+  // task-07: failed_post_check 门控
+  // scan post-check 未通过时，禁止进入主流程的下游阶段（brainstorm/plan/execute/verify/archive）
+  // 必须先重跑 scan 修复。toStage === 'scan' 的重跑路径已被上方 fromStage === toStage 放行。
+  // fromStageData.status 缺失（旧数据）时门控不触发（向后兼容）。
+  if (fromStage === 'scan' && fromStageData?.status === 'failed_post_check' && toStage !== 'scan') {
+    return {
+      allowed: false,
+      reason: 'scan post-check 未通过（failed_post_check），需修复后重跑 scan 再进入 ' + toStage,
+    }
+  }
+
   // archive 特殊处理：从 verify 来的允许，从其他主流程阶段来的需要校验
   if (toStage === 'archive') {
     if (fromStage === 'verify') {

package/src/stages/execute.js

@@ -165,6 +165,7 @@ const fixedPrefix = [
 - **worktree 已由 CLI 在 execute 阶段启动时自动创建，不要自行创建或跳过**
 - **后续所有子代理的 cwd 必须设为该 worktree 路径**
 - 如果 meta.json 不存在（说明创建失败），停止并报错
+- **不要自行检查 git dirty/uncommitted 状态来判断是否可以进入 worktree，CLI 已自动处理**
 
 ### 输出
 worktree 路径 + 分支名 + 模式

package/src/workflow.js

@@ -149,10 +149,13 @@ function replaceProjectPlaceholder(wf, projectName) {
  * @param {string} cwd - 项目根目录
  * @returns {CheckResult}
  */
-function checkOutput(outputDef, projectName, cwd) {
+function checkOutput(outputDef, projectName, cwd, specBase) {
+  // specBase 优先（平台模式 platformOpts.specRoot，已含或不含 .sillyspec 语义）；
+  // 未传时回退 join(cwd, '.sillyspec')，等价于旧行为 resolve(cwd, '.sillyspec/...')
+  const effectiveBase = specBase || join(cwd, '.sillyspec')
   // 将 <project> 替换为实际项目名
   const rawPath = (outputDef.path || '').replace(/<project>/g, projectName)
-  const fullPath = resolve(cwd, rawPath)
+  const fullPath = resolve(effectiveBase, rawPath)
   const checks = outputDef.checks || []
   const results = []
 
@@ -241,7 +244,7 @@ function checkOutput(outputDef, projectName, cwd) {
  *   retry_prompts: [{ role_id, role_name, prompt }]
  * }
  */
-export function runPostCheck(wf, cwd, projectName, placeholders = {}) {
+export function runPostCheck(wf, cwd, projectName, placeholders = {}, specBase) {
   let resolved = replaceProjectPlaceholder(wf, projectName)
   if (Object.keys(placeholders).length > 0) {
     let json = JSON.stringify(resolved)
@@ -250,10 +253,11 @@ export function runPostCheck(wf, cwd, projectName, placeholders = {}) {
     }
     resolved = JSON.parse(json)
   }
-  return _checkWorkflow(resolved, cwd, projectName)
+  return _checkWorkflow(resolved, cwd, projectName, specBase)
 }
 
-function _checkWorkflow(wf, cwd, projectName) {
+function _checkWorkflow(wf, cwd, projectName, specBase) {
+  const effectiveBase = specBase || join(cwd, '.sillyspec')
   const workflowName = wf.name || 'unknown'
   const specVersion = wf.spec_version || wf.version || 0
   const workflowChecks = wf.checks?.workflow_level || []
@@ -270,7 +274,7 @@ function _checkWorkflow(wf, cwd, projectName) {
 
     for (const outputDef of outputDefs) {
       const rawPath = (outputDef.path || '').replace(/<project>/g, projectName)
-      const checkResults = checkOutput(outputDef, projectName, cwd)
+      const checkResults = checkOutput(outputDef, projectName, cwd, effectiveBase)
       const outputPassed = checkResults.every(c => c.passed)
 
       outputs.push({
@@ -309,7 +313,7 @@ function _checkWorkflow(wf, cwd, projectName) {
   for (const check of workflowChecks) {
     switch (check.type) {
       case 'file_count': {
-        const scanDir = join(cwd, '.sillyspec', 'docs', projectName, check.path || 'scan/')
+        const scanDir = join(effectiveBase, 'docs', projectName, check.path || 'scan/')
         if (existsSync(scanDir)) {
           const files = readdirSync(scanDir).filter(f => f.endsWith('.md'))
           const min = check.min || 0
@@ -328,7 +332,7 @@ function _checkWorkflow(wf, cwd, projectName) {
         break
       }
       case 'no_empty_files': {
-        const scanDir = join(cwd, '.sillyspec', 'docs', projectName, check.path || 'scan/')
+        const scanDir = join(effectiveBase, 'docs', projectName, check.path || 'scan/')
         if (existsSync(scanDir)) {
           const files = readdirSync(scanDir).filter(f => f.endsWith('.md'))
           let anyEmpty = false

package/src/worktree-apply.js

@@ -214,7 +214,7 @@ export function applyWorktree(changeName, { cwd, checkOnly = false } = {}) {
   const patchFiles = hasAllowList
     ? [...allowSet].filter(f => changedFiles.includes(f))
     : changedFiles;
-  const fileArgs = patchFiles.map(f => `-- ${f}`).join(' ');
+  const fileArgs = patchFiles.length > 0 ? `-- ${patchFiles.join(' ')}` : '';
 
   // 创建临时文件
   const tmpDir = mkdtempSync(join(tmpdir(), 'sillyspec-patch-'));
@@ -236,7 +236,7 @@ export function applyWorktree(changeName, { cwd, checkOnly = false } = {}) {
 
     // tracked 文件：git diff baseHash
     if (trackedFiles.length > 0) {
-      const trackedArgs = trackedFiles.map(f => `-- ${f}`).join(' ');
+      const trackedArgs = trackedFiles.length > 0 ? `-- ${trackedFiles.join(' ')}` : '';
       patchContent += execSync(
         `git diff --binary ${diffBase} ${trackedArgs}`,
         { cwd: worktreePath, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }
@@ -245,11 +245,12 @@ export function applyWorktree(changeName, { cwd, checkOnly = false } = {}) {
 
     // untracked 新文件：git add 到 index，git diff --cached，然后 reset
     if (untrackedPatchFiles.length > 0) {
-      const addArgs = untrackedPatchFiles.map(f => `-- ${f}`).join(' ');
+      const addArgs = untrackedPatchFiles.length > 0 ? `-- ${untrackedPatchFiles.join(' ')}` : '';
       git(worktreePath, `add ${addArgs}`);
       try {
+        const diffCachedArgs = untrackedPatchFiles.length > 0 ? `-- ${untrackedPatchFiles.join(' ')}` : '';
         patchContent += execSync(
-          `git diff --binary --cached ${untrackedPatchFiles.map(f => `-- ${f}`).join(' ')}`,
+          `git diff --binary --cached ${diffCachedArgs}`,
           { cwd: worktreePath, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }
         );
       } finally {