sillyspec 3.16.2 → 3.17.1

package/package.json

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

package/src/change-list.js

@@ -40,7 +40,7 @@ export function parseFileChangeList(designMdPath) {
       continue
     }
 
-    const filePath = cells[1].trim()
+    const filePath = cells[1].trim().replace(/^`|`$/g, '')
 
     // 忽略空路径、注释、.sillyspec/ 内的路径
     if (!filePath || filePath === '—' || filePath === '-' || filePath.startsWith('.sillyspec/')) continue

package/src/index.js

@@ -22,6 +22,7 @@ SillySpec CLI — 规范驱动开发工具包
     [--tool <name>]            只安装指定工具
     [--interactive]            交互式引导
     [--dir <path>]             指定目录
+    [--spec-dir <path>]        指定规范目录（默认 <项目>/.sillyspec）
 
   sillyspec setup [--list]     安装推荐 MCP 工具
     [--list]                   查看已安装状态
@@ -32,7 +33,7 @@ SillySpec CLI — 规范驱动开发工具包
     --status                   查看阶段进度
     --reset                    重置阶段
     --change <name>            设置当前变更名
-    --spec-root <path>         平台模式：SillySpec storage root 路径
+    --spec-dir <path>          指定规范目录（默认 <项目>/.sillyspec）
     --runtime-root <path>       平台模式：运行时产物根路径
     --workspace-id <id>         平台模式：workspace ID
     --scan-run-id <id>          平台模式：scan run ID
@@ -70,9 +71,11 @@ SillySpec CLI — 规范驱动开发工具包
 选项:
   --json                       输出 JSON（给 AI 程序化读取）
   --dir <path>                 指定项目目录（默认当前目录）
+  --spec-dir <path>            指定规范目录（默认 <项目目录>/.sillyspec）
 
 示例:
   sillyspec init
+  sillyspec init --spec-dir /data/specs/my-project
   sillyspec run scan
   sillyspec run brainstorm
   sillyspec run quick
@@ -100,6 +103,7 @@ async function main() {
   let json = false;
   let saveWorkflowRunFlag = false;
   let targetDir = process.cwd();
+  let specDir = null;
   let tool = null;
   let interactive = false;
   const filteredArgs = [];
@@ -112,6 +116,9 @@ async function main() {
     } else if (args[i] === '--dir' && args[i + 1]) {
       targetDir = resolve(args[i + 1]);
       i++;
+    } else if (args[i] === '--spec-dir' && args[i + 1]) {
+      specDir = resolve(args[i + 1]);
+      i++;
     } else if (args[i] === '--tool' && args[i + 1]) {
       tool = args[i + 1];
       i++;
@@ -144,7 +151,7 @@ async function main() {
 
   switch (command) {
     case 'init':
-      await cmdInit(dir, { tool, interactive });
+      await cmdInit(dir, { tool, interactive, specDir });
       break;
     case 'setup':
       const setupList = filteredArgs.includes('--list') || filteredArgs.includes('-l');
@@ -247,7 +254,7 @@ async function main() {
     }
     case 'run': {
       const { runCommand } = await import('./run.js')
-      await runCommand(filteredArgs.slice(1), dir)
+      await runCommand(filteredArgs.slice(1), dir, specDir)
       break
     }
     case 'dashboard': {
@@ -278,7 +285,7 @@ async function main() {
       const wtSubCmd = filteredArgs[1];
       const wtName = filteredArgs.slice(2).find(a => !a.startsWith('-'));
       const wm = new WorktreeManager({ cwd: dir });
-      const pm = new ProgressManager();
+      const pm = new ProgressManager({ specDir });
 
       // isolation 写入 DB 的辅助函数
       async function _writeIsolationToDB(cwd, changeName, info) {
@@ -525,7 +532,7 @@ SillySpec platform — SillyHub 平台同步
         console.error('❌ 用法: sillyspec change-rename <旧变更名> <新变更名>');
         process.exit(1);
       }
-      const pm = new ProgressManager();
+      const pm = new ProgressManager({ specDir });
       await pm.renameChange(dir, oldName, newName);
       break;
     }

package/src/init.js

@@ -103,30 +103,35 @@ function isTTY() {
 
 // ── 核心安装逻辑 ──
 
-async function doInstall(projectDir, tools, subprojects = []) {
+async function doInstall(projectDir, tools, subprojects = [], specDir = null) {
+  // specDir: 规范目录（默认 projectDir/.sillyspec）
+  // projectDir: 源码项目根目录（用于工具检测、指令注入、.gitignore）
+  const spec = specDir || join(projectDir, '.sillyspec');
+
   // 创建基础目录
-  // .sillyspec/projects/    → 项目注册表
-  // .sillyspec/docs/<name>/ → 统一文档中心
-  // .sillyspec/knowledge/   → 跨项目共享知识库
-  // .sillyspec/.runtime/    → progress (gitignored)
+  // spec/projects/    → 项目注册表
+  // spec/docs/<name>/ → 统一文档中心
+  // spec/knowledge/   → 跨项目共享知识库
+  // spec/.runtime/    → progress (gitignored)
 
   // 注册当前项目到 projects/
   const projectName = basename(projectDir) || 'project';
-  const projectsDir = join(projectDir, '.sillyspec', 'projects');
+  const projectsDir = join(spec, 'projects');
   mkdirSync(projectsDir, { recursive: true });
   const projectYamlPath = join(projectsDir, `${projectName}.yaml`);
   if (!existsSync(projectYamlPath)) {
-    writeFileSync(projectYamlPath, `name: ${projectName}\npath: .\nstatus: active\n`);
+    // path 相对于 specDir，跨平台可寻址
+    writeFileSync(projectYamlPath, `name: ${projectName}\npath: ${projectDir}\nstatus: active\n`);
   }
 
-  // 创建 .sillyspec/docs/<projectName>/scan/ 子目录（代码扫描结果）
-  const scanDir = join(projectDir, '.sillyspec', 'docs', projectName, 'scan');
+  // 创建 docs/<projectName>/scan/ 子目录（代码扫描结果）
+  const scanDir = join(spec, 'docs', projectName, 'scan');
   mkdirSync(scanDir, { recursive: true });
   const gitkeepPath = join(scanDir, '.gitkeep');
   if (!existsSync(gitkeepPath)) writeFileSync(gitkeepPath, '');
 
-  // 复制 workflow 模板到 .sillyspec/workflows/
-  const workflowsDir = join(projectDir, '.sillyspec', 'workflows');
+  // 复制 workflow 模板到 workflows/
+  const workflowsDir = join(spec, 'workflows');
   const templatesDir = join(__dirname, '..', 'templates', 'workflows');
   if (existsSync(templatesDir)) {
     mkdirSync(workflowsDir, { recursive: true });
@@ -142,11 +147,11 @@ async function doInstall(projectDir, tools, subprojects = []) {
   }
 
   // 创建 shared/workspace 目录
-  mkdirSync(join(projectDir, '.sillyspec', 'shared'), { recursive: true });
-  mkdirSync(join(projectDir, '.sillyspec', 'workspace'), { recursive: true });
+  mkdirSync(join(spec, 'shared'), { recursive: true });
+  mkdirSync(join(spec, 'workspace'), { recursive: true });
 
   // 创建知识库骨架
-  const knowledgeDir = join(projectDir, '.sillyspec', 'knowledge');
+  const knowledgeDir = join(spec, 'knowledge');
   mkdirSync(knowledgeDir, { recursive: true });
   const indexPath = join(knowledgeDir, 'INDEX.md');
   if (!existsSync(indexPath)) {
@@ -157,29 +162,33 @@ async function doInstall(projectDir, tools, subprojects = []) {
     writeFileSync(uncatPath, `# 未分类知识\n\n> execute/quick 执行中发现的坑暂存于此，用户审阅后归类到对应文件并更新 INDEX.md。\n`);
   }
 
-  // 创建 .sillyspec/.runtime/ 目录结构（全局状态）
-  const runtimeDir = join(projectDir, '.sillyspec', '.runtime');
+  // 创建 .runtime/ 目录结构（全局状态）
+  const runtimeDir = join(spec, '.runtime');
   for (const sub of ['artifacts', 'history', 'logs', 'templates']) {
     mkdirSync(join(runtimeDir, sub), { recursive: true });
   }
 
-  // 初始化 SQLite 数据库（创建 DB + 建表 + 写入 project 行 + user-inputs.md）
-  const pm = new ProgressManager();
+  // 初始化 SQLite 数据库
+  const pm = new ProgressManager({ specDir: spec });
   await pm.init(projectDir);
 
-  const gitignorePath = join(projectDir, '.gitignore');
-  const ignoreRules = ['.sillyspec/codebase/SCAN-RAW.md', '.sillyspec/local.yaml', '.sillyspec/.runtime/'];
-  if (existsSync(gitignorePath)) {
-    const content = readFileSync(gitignorePath, 'utf8');
-    let updated = content.trimEnd();
-    for (const rule of ignoreRules) {
-      if (!updated.includes(rule)) {
-        updated += '\n' + rule;
+  // .gitignore 只在 specDir 在项目内时才修改
+  const isExternalSpec = specDir && resolve(spec) !== resolve(projectDir, '.sillyspec');
+ if (!isExternalSpec) {
+    const gitignorePath = join(projectDir, '.gitignore');
+    const ignoreRules = ['.sillyspec/codebase/SCAN-RAW.md', '.sillyspec/local.yaml', '.sillyspec/.runtime/'];
+    if (existsSync(gitignorePath)) {
+      const content = readFileSync(gitignorePath, 'utf8');
+      let updated = content.trimEnd();
+      for (const rule of ignoreRules) {
+        if (!updated.includes(rule)) {
+          updated += '\n' + rule;
+        }
       }
+      writeFileSync(gitignorePath, updated + '\n');
+    } else {
+      writeFileSync(gitignorePath, ignoreRules.join('\n') + '\n');
     }
-    writeFileSync(gitignorePath, updated + '\n');
-  } else {
-    writeFileSync(gitignorePath, ignoreRules.join('\n') + '\n');
   }
 
   // 注入指令文件（codex/gemini/opencode）
@@ -218,7 +227,7 @@ async function doInstall(projectDir, tools, subprojects = []) {
 
 // ── 安装完成总结 ──
 
-function showSummary(version, tools) {
+function showSummary(version, tools, specDir) {
   const toolLabels = tools.map(t => TOOL_LABELS[t] || t);
 
   console.log('');
@@ -227,7 +236,7 @@ function showSummary(version, tools) {
   console.log(chalk.green('  ═══════════════════════════════════════'));
   console.log('');
   console.log(`  已安装工具: ${chalk.cyan(toolLabels.join(', '))}`);
-  console.log('  📁 .sillyspec/ — 项目规范目录');
+  console.log(`  📁 规范目录: ${chalk.cyan(specDir || '.sillyspec')}`);
   console.log('');
   console.log('  下一步：使用 AI 技能开始工作');
   console.log('    OpenClaw:    ' + chalk.bold('/sillyspec:brainstorm'));
@@ -251,8 +260,9 @@ export function getVersion() {
 // ── 主命令 ──
 
 export async function cmdInit(projectDir, options = {}) {
-  const { tool, interactive } = options;
+  const { tool, interactive, specDir } = options;
   const version = getVersion();
+  const resolvedSpecDir = specDir ? resolve(specDir) : null;
 
   // ── 交互式模式（--interactive 或 -i）──
   if (interactive && isTTY()) {
@@ -350,8 +360,8 @@ export async function cmdInit(projectDir, options = {}) {
     }
 
     console.log('');
-    await doInstall(projectDir, selectedTools, subprojects);
-    showSummary(version, selectedTools);
+    await doInstall(projectDir, selectedTools, subprojects, resolvedSpecDir);
+    showSummary(version, selectedTools, resolvedSpecDir);
     return;
   }
 
@@ -369,12 +379,13 @@ export async function cmdInit(projectDir, options = {}) {
     tools = detectTools(projectDir);
   }
 
-  await doInstall(projectDir, tools);
+  await doInstall(projectDir, tools, [], resolvedSpecDir);
 
   console.log('');
   console.log(chalk.green(`  ✅ SillySpec v${version} 安装完成！`));
   console.log('');
-  console.log('  📁 .sillyspec/ — 项目规范目录');
+  const specDisplay = resolvedSpecDir || '.sillyspec';
+  console.log(`  📁 规范目录: ${chalk.cyan(specDisplay)}`);
   console.log('');
   console.log('  下一步：使用 AI 技能开始工作');
   console.log(`    OpenClaw:    ${chalk.bold('/sillyspec:brainstorm')}`);

package/src/progress.js

@@ -15,8 +15,10 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync, unlinkS
 import { join, basename } from 'path';
 import { DB } from './db.js';
 
-const RUNTIME_DIR = '.sillyspec/.runtime';
-const CHANGES_DIR = '.sillyspec/changes';
+// 默认规范目录名（相对于 cwd）
+const SPEC_DIR_NAME = '.sillyspec';
+const RUNTIME_SUBDIR = '.runtime';
+const CHANGES_SUBDIR = 'changes';
 const GLOBAL_FILE = 'global.json';
 const CURRENT_VERSION = 3;
 const VALID_STAGES = ['scan', 'brainstorm', 'propose', 'plan', 'execute', 'verify', 'archive', 'quick', 'explore'];
@@ -50,14 +52,27 @@ function makeInitialGlobal(project) {
 // ── ProgressManager ──
 
 export class ProgressManager {
+  /**
+   * @param {object} [opts]
+   * @param {string} [opts.specDir] - 规范目录绝对路径（默认 cwd/.sillyspec）
+   */
+  constructor(opts = {}) {
+    this._customSpecDir = opts.specDir || null;
+  }
+
   // ── 路径工具 ──
 
+  /** 获取 specDir（优先自定义，否则 cwd/.sillyspec） */
+  _getSpecDir(cwd) {
+    return this._customSpecDir || join(cwd, SPEC_DIR_NAME);
+  }
+
   _runtimePath(cwd, ...parts) {
-    return join(cwd, RUNTIME_DIR, ...parts);
+    return join(this._getSpecDir(cwd), RUNTIME_SUBDIR, ...parts);
   }
 
   _changePath(cwd, changeName, ...parts) {
-    return join(cwd, CHANGES_DIR, changeName, ...parts);
+    return join(this._getSpecDir(cwd), CHANGES_SUBDIR, changeName, ...parts);
   }
 
   _ensureRuntimeDir(cwd) {
@@ -1207,6 +1222,8 @@ export class ProgressManager {
   }
 
   _ensureGitignore(cwd) {
+    // 外部 specDir 不需要修改项目 .gitignore
+    if (this._customSpecDir) return;
     const gitignorePath = join(cwd, '.gitignore');
     const rule = '.sillyspec/.runtime/';
     if (existsSync(gitignorePath)) {