sillyspec 3.11.2 → 3.11.4

package/package.json

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

package/src/run.js

@@ -144,7 +144,11 @@ function outputStep(stageName, stepIndex, steps, cwd, changeName) {
   console.log(`step: ${stepIndex + 1}/${total}`)
   console.log(`stepName: ${step.name}`)
   console.log(`project: ${projectName}`)
-  if (changeName) console.log(`change: ${changeName}`)
+  if (changeName) {
+    console.log(`change: ${changeName}`)
+    const changeDir = join('.sillyspec', 'changes', changeName)
+    console.log(`changeDir: ${changeDir}`)
+  }
   console.log(`---\n`)
   if (personas[stageName]) {
     console.log(personas[stageName])
@@ -160,6 +164,11 @@ function outputStep(stageName, stepIndex, steps, cwd, changeName) {
   console.log('- 完成后立即执行 --done 命令，不得跳过')
   console.log('- 文档类型文件（.md/.yaml/.json 等）头部必须包含 author（git 用户名）和 created_at（精确到秒）')
   console.log('- 执行构建/测试前必须先读 local.yaml，优先使用其中配置的命令、路径和环境变量；未配置时才使用默认值')
+  // 路径安全规则：防止 AI 拼错变更目录
+  if (changeName) {
+    const changeDir = join('.sillyspec', 'changes', changeName)
+    console.log(`- **文件路径规则：所有变更文件必须写入 \`${changeDir}/\` 目录下。不要自己拼接路径，直接使用 changeDir 值。示例：\`${changeDir}/proposal.md\`**`)
+  }
   const changeFlag = changeName ? ` --change ${changeName}` : ''
   console.log(`\n### 完成后执行`)
   console.log(`sillyspec run ${stageName} --done${changeFlag} --input "用户原始需求/反馈" --output "你的摘要"`)
@@ -368,6 +377,53 @@ function validateMetadata(cwd, stageName) {
   }
 }
 
+/**
+ * 验证关键文件是否存在于正确的变更目录下
+ * 防止 AI 将文件写到错误的路径
+ */
+function validateFileLocations(cwd, stageName, progress, changeName) {
+  const effectiveChange = changeName || progress.currentChange
+  if (!effectiveChange) return
+
+  const changeDir = join(cwd, '.sillyspec', 'changes', effectiveChange)
+  if (!existsSync(changeDir)) return
+
+  // 每个阶段完成后预期存在的文件
+  const expectedFiles = {
+    propose: ['proposal.md', 'design.md', 'requirements.md', 'tasks.md'],
+    plan: ['plan.md'],
+    verify: ['verify-result.md'],
+    archive: ['module-impact.md'],
+  }
+
+  const expected = expectedFiles[stageName]
+  if (!expected) return
+
+  const missing = []
+  for (const file of expected) {
+    if (!existsSync(join(changeDir, file))) {
+      missing.push(file)
+    }
+  }
+
+  if (missing.length > 0) {
+    console.log(`\n⚠️  文件位置验证：以下文件未在变更目录中找到`)
+    console.log(`  变更目录：${changeDir.replace(cwd + '/', '')}/`)
+    for (const f of missing) {
+      // 检查是否写到了错误的位置
+      const wrongPath = join(cwd, '.sillyspec', 'changes', 'change', effectiveChange, f)
+      if (existsSync(wrongPath)) {
+        console.log(`  ❌ ${f} — 不存在，但发现了错误路径：${wrongPath.replace(cwd + '/', '')}`)
+        console.log(`     提示：应该写入 ${changeDir.replace(cwd + '/', '')}/${f}`)
+      } else {
+        console.log(`  ⬜ ${f} — 未找到（该阶段可能未产出此文件）`)
+      }
+    }
+  } else {
+    console.log(`\n✅ 文件位置验证：所有 ${expected.length} 个预期文件均在变更目录中`)
+  }
+}
+
 async function completeStep(pm, progress, stageName, cwd, outputText, inputText = null, options = {}) {
   const { printNext = true, confirm = false, changeName } = options
   const stageData = progress.stages[stageName]
@@ -444,6 +500,9 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
 
     validateMetadata(cwd, stageName)
 
+    // 验证关键文件是否在正确的变更目录下
+    validateFileLocations(cwd, stageName, progress, changeName)
+
     // archive 阶段确认归档
     if (stageName === 'archive' && steps[currentIdx]?.name === '确认归档') {
       if (confirm) {