sillyspec 3.11.6 → 3.11.8

package/package.json

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

package/src/run.js

@@ -154,7 +154,15 @@ function outputStep(stageName, stepIndex, steps, cwd, changeName) {
     console.log(personas[stageName])
     console.log('')
   }
+  // 注入全局护栏（如 _globalGuardrails）
+  const stageDef = stageRegistry[stageName]
+  const guardrails = stageDef && stageDef._globalGuardrails ? stageDef._globalGuardrails : ''
+
   console.log(`## Step ${stepIndex + 1}/${total}: ${step.name}\n`)
+  if (guardrails) {
+    console.log(guardrails.trim())
+    console.log('')
+  }
   console.log(step.prompt)
   console.log(`\n### ⚠️ 铁律`)
   console.log('- **文档是核心资产，代码是文档的产物。** 没有文档就没有代码——文档是 AI 的记忆，是团队协作的基础，是后续维护的唯一依据。任何代码产出必须先有对应的设计/规范文档支撑。')

package/src/stages/brainstorm.js

@@ -322,8 +322,19 @@ Then 期望结果
 - 可测试：...
 \`\`\`
 
+### 后续变更包处理
+如果 MASTER.md 中规划了后续变更包（拆分后的子阶段），**必须同时为每个后续包创建独立变更目录**：
+1. 读取 MASTER.md 中的变更包列表（包名 + 边界描述）
+2. 为每个后续包创建目录：\`mkdir -p .sillyspec/changes/<后续包名>\`
+3. 每个目录生成骨架文件：
+   - \`proposal.md\`：从 MASTER.md 中提取该包的动机和边界
+   - \`design.md\`：从 MASTER.md 中提取该包的职责描述（标记为「待设计 - 本包 design 在该包进入 brainstorm 时完善」）
+   - \`requirements.md\`：从 MASTER.md 中提取该包的需求范围（标记为「待完善」）
+   - \`tasks.md\`：创建空任务列表，标记为「待 plan 阶段展开」
+4. \`git add .sillyspec/\` — 暂存所有新增文件（不要 commit）
+
 ### 输出
-所有规范文件路径
+所有规范文件路径（含后续变更包目录列表）
 
 ### 注意
 - 必须等待用户明确确认

package/src/stages/scan.js

@@ -4,6 +4,38 @@ export const definition = {
   description: '分析项目结构、约定和架构',
   auxiliary: true,
   steps: [
+    {
+      name: '探测项目结构并建议子项目',
+      prompt: `扫描项目顶层目录结构，自动发现可能的子项目，**需用户确认后才创建 projects 配置**。
+
+### 操作
+1. 列出项目顶层目录：\`ls -d */ 2>/dev/null | grep -v node_modules | grep -v '.git' | grep -v '.sillyspec'\`
+2. 对每个顶层目录，快速判断是否为独立项目（检查 package.json / pom.xml / build.gradle / pyproject.toml / go.mod 等构建文件）
+3. 对每个疑似独立项目，检测技术栈：\`cat <dir>/package.json 2>/dev/null | head -5\` 或类似
+4. 对比 \`.sillyspec/projects/\` 已有配置，找出未注册的子项目
+
+### 判断标准（满足任一即为子项目）
+- 有独立的构建文件（package.json, pom.xml, build.gradle, pyproject.toml 等）
+- 有独立的源码目录结构（src/, app/, lib/ 等）
+- 有独立的测试目录（test/, tests/, __tests__/ 等）
+- 不是 .git / node_modules / .sillyspec / dist / build 等工具目录
+
+### 输出格式
+列出发现的可能子项目列表，每个含：
+- 目录名
+- 技术栈（如 Next.js + TypeScript、FastAPI + Python）
+- 是否已注册到 projects/
+- 建议：注册 / 跳过
+
+### ⛔ 红线
+- **不要自动创建 projects 配置文件**，只列出建议供用户确认
+- **不要修改任何文件**，只做探测和报告
+
+### 输出
+子项目建议列表（含技术栈和注册状态）`,
+      outputHint: '子项目建议列表',
+      optional: false
+    },
     {
       name: '检查已有扫描文档和子项目列表',
       prompt: `检查已有扫描文档和子项目列表。

package/src/stages/verify.js

@@ -2,6 +2,38 @@ export const definition = {
   name: 'verify',
   title: '验证确认',
   description: '对照规范检查 + 测试套件',
+
+  // ⛔ 全局护栏：verify 阶段禁止一切破坏性操作
+  // 子代理只能「读」和「写报告」，不能「改代码」或「改 git 状态」。
+  _globalGuardrails: `
+## ⛔ verify 阶段绝对禁止的操作
+
+以下操作在 verify 阶段**绝对禁止**，无论出于任何原因（包括「恢复文件」「修复问题」「清理目录」）：
+
+### 禁止的 Git 操作
+- git checkout（覆盖文件）
+- git restore（覆盖文件）
+- git reset（回滚提交）
+- git revert（撤销提交）
+- git clean（删除未跟踪文件）
+- git stash drop（删除 stash）
+- git branch -D（强制删除分支）
+
+### 禁止的文件操作
+- 删除任何源码文件（rm、trash）
+- 覆盖任何源码文件（cp 覆盖、echo > 覆盖）
+- 修改任何源码文件（除了 .sillyspec/ 下的报告文件）
+
+### 只允许的操作
+- git status / git diff / git show / git log / git stash list（只读）
+- cat / head / grep / find / wc（只读检查）
+- 写入 .sillyspec/changes/ 下的报告文件（verification.md）
+- 运行测试命令（不修改源码）
+- 运行 lint 命令（不自动修复）
+
+如果发现文件缺失或异常，**只报告问题，不尝试修复**。
+`,
+
   steps: [
     {
       name: '状态检查',
@@ -56,8 +88,10 @@ export const definition = {
 ### 输出
 任务完成度列表 + 完成率
 
-### 注意
-- 不修改任何代码，只做检查和报告`,
+### ⛔ 红线提醒
+- **绝对禁止** git checkout/restore/reset 或删除/覆盖任何文件
+- 发现文件缺失只报告，不尝试恢复
+- verify 阶段的唯一职责是「检查 + 报告」，不是「修复」`,
       outputHint: '任务完成度报告',
       optional: false
     },