mumuspec 0.1.0

package/README.md

@@ -0,0 +1,83 @@
+# MumuSpec CLI
+
+AI Coding 企业 Spec 驱动开发工具链。一条命令生成 Spec、校验 Spec、联动 Spec。
+
+## 安装
+
+```bash
+npm install -g mumuspec
+```
+
+或直接用 npx：
+
+```bash
+npx mumuspec create my-project
+npx create-mumuspec my-project
+```
+
+## 命令
+
+### 项目初始化
+
+```bash
+mumuspec create <name>       # 生成 Spec 项目骨架（14 份文档 + AGENTS.md）
+mumuspec console [dir]       # 生成 Spec 可视化控制台 HTML
+mumuspec status [dir]        # 查看项目整体状态
+```
+
+### Spec 内容生成 — 五轮工作流
+
+```bash
+mumuspec elicit              # R1·采集 — 原始素材 → 02 需求采集
+mumuspec propose             # R2·提案 — 03 立项提案 + 04 PRD
+mumuspec anchor              # R3·锚定 — 05 用户故事 ↔ 09 API 契约
+mumuspec design              # R4·设计 — 06 FSD + 07 NFR + 08+10+11
+mumuspec close               # R5·收口 — 12 实施计划 + 13 测试策略 + 14 RTM
+```
+
+### 维护与校验
+
+```bash
+mumuspec validate            # 门禁校验 — AC/TC 追溯、字段完整性、文档一致性
+mumuspec impact <spec-id>    # 变更影响分析 — 改这份会波及哪些文档
+mumuspec sync <spec-id>      # 变更联动 — 自动更新关联文档
+mumuspec freeze              # 版本冻结 — 打 Git tag + 锁定 Spec
+```
+
+### 角色视图
+
+```bash
+mumuspec view --role pm      # 产品经理视角 (02-06)
+mumuspec view --role dev     # 开发者视角 (05-06-09-10-12)
+mumuspec view --role qa      # QA 视角 (05-06-09-13-14)
+mumuspec view --role arch    # 架构师视角 (01-07-08-11)
+```
+
+## 典型工作流
+
+```bash
+# 1. 创建项目
+mumuspec create ecommerce-promo
+cd ecommerce-promo
+
+# 2. 按五轮工作流生成 Spec（每轮将 Prompt 复制到 AI 工具执行）
+mumuspec elicit     # → AI 生成 02
+mumuspec propose    # → AI 生成 03-04
+mumuspec anchor     # → AI 生成 05、09
+mumuspec design     # → AI 生成 06-07-08-10-11
+mumuspec close      # → AI 生成 12-13-14
+
+# 3. 校验
+mumuspec validate
+
+# 4. 可视化
+mumuspec console
+
+# 5. 冻结
+mumuspec freeze
+```
+
+## 更多
+
+- [mumucoding.com](https://mumucoding.com)
+- [GitHub](https://github.com/lvzhaobo/mumu-coding)

package/bin/create-mumuspec.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../src/commands/create')(process.argv.slice(2));

package/bin/mumuspec.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+const cmd = process.argv[2];
+
+const HELP = `
+  MumuSpec — AI Coding 企业 Spec 驱动开发工具链
+
+  用法:
+    mumuspec <命令> [参数]
+
+  项目初始化:
+    create <name>            生成 Spec 项目骨架（14 份文档 + AGENTS.md）
+    console [dir] [out]      生成 Spec 可视化控制台 HTML
+    status [dir]             查看 Spec 项目状态
+
+  Spec 内容生成（四轮工作流）:
+    elicit [dir]             R1·采集 — 原始素材 → 02 需求采集
+    propose [dir]            R2·提案 — 03 立项提案 + 04 PRD
+    anchor [dir]             R3·锚定 — 05 用户故事 ↔ 09 API 契约
+    design [dir]             R4·设计 — 06 FSD + 07 NFR + 08+10+11
+    close [dir]              R5·收口 — 12 实施计划 + 13 测试策略 + 14 RTM
+
+  维护与校验:
+    validate [dir]           门禁校验 — AC/TC 追溯、字段完整性、冻结状态
+    impact <spec-id> [dir]   变更影响分析 — 改这份会波及哪些文档
+    sync <spec-id> [dir]     变更联动 — 更新关联文档
+    freeze [dir]             版本冻结 — 打 Git tag + 锁定 Spec
+
+  角色视图:
+    view --role <role> [dir] 按角色查看 Spec（pm|dev|qa|arch）
+
+  示例:
+    mumuspec create my-project
+    mumuspec propose
+    mumuspec validate
+    mumuspec view --role dev
+`;
+const CMDS = ['create','console','status','elicit','propose','anchor','design','close','validate','impact','sync','freeze','view','lint'];
+
+if (!cmd || cmd === '--help' || cmd === '-h') { console.log(HELP); process.exit(0); }
+if (cmd === '--version' || cmd === '-v') { console.log('mumuspec v'+require('../package.json').version); process.exit(0); }
+if (!CMDS.includes(cmd)) { console.log(`未知命令: ${cmd}\n${HELP}`); process.exit(1); }
+
+require(`../src/commands/${cmd}`)(process.argv.slice(3));

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "mumuspec",
+  "version": "0.1.0",
+  "description": "MumuSpec CLI — AI Coding 企业 Spec 驱动开发工具链。一条命令生成 Spec、校验 Spec、联动 Spec。",
+  "keywords": ["spec", "ai-coding", "spec-driven", "cli", "mumuspec"],
+  "license": "MIT",
+  "author": "MumuLab",
+  "repository": "https://github.com/lvzhaobo/mumu-coding",
+  "bin": {
+    "mumuspec": "./bin/mumuspec.js",
+    "create-mumuspec": "./bin/create-mumuspec.js"
+  },
+  "engines": { "node": ">=16" }
+}

package/src/commands/anchor.js

@@ -0,0 +1,43 @@
+// R3·锚定 — 05 用户故事 ↔ 09 API 契约 双向对齐
+const { resolveDir, readSpec } = require('../utils');
+const path = require('path');
+
+module.exports = function(args) {
+  const dir = resolveDir(args[0]);
+  const s04 = readSpec(dir, 4);
+
+  console.log('📋 R3·锚定 — 生成 05 用户故事 + 09 API 契约（双向对齐）');
+  console.log('');
+  console.log('输入: 04 PRD');
+  console.log('输出: ' + path.join(dir, '05-user-stories.md'));
+  console.log('      ' + path.join(dir, '09-api-spec.md'));
+  console.log('');
+  console.log('请将以下 Prompt 复制到 AI 编码工具中执行：');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log(`你是需求分析 + 接口设计专家。请根据 04-PRD，同时生成 05-用户故事 和 09-API契约，确保两者字段级对齐。
+
+## 第一步：生成 05-用户故事
+- 按角色拆分用户故事（作为[角色]，我想要[功能]，以便[价值]）
+- 每个故事附带 AC（验收条件）
+- 用 MoSCoW 排序（Must/Should/Could/Won't）
+- 标注故事间的依赖关系
+
+## 第二步：生成 09-API契约
+- 为每个用户故事推导 API 端点
+- 列出每个端点的请求/响应格式（JSON）
+- 错误码和错误响应格式
+- 标注每个端点关联的用户故事和 AC
+
+## 关键约束：双向对齐
+- 05 中的每个 AC → 09 中必须有对应的 API 端点或字段
+- 09 中的每个端点 → 05 中必须有对应的用户故事
+- AC 中的字段名 = API 中的字段名（不允许不一致）
+
+格式：中文描述 + JSON 示例，Markdown 表格
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+  if (s04) { console.log('📎 04-PRD（已加载）: ' + s04.length + ' 字符'); }
+  else { console.log('⚠️  04-PRD 内容为空。建议先运行 mumuspec propose'); }
+  console.log('');
+  console.log('💡 生成后保存为 05-user-stories.md 和 09-api-spec.md');
+};

package/src/commands/close.js

@@ -0,0 +1,45 @@
+// R5·收口 — 12 实施计划 + 13 测试策略 + 14 RTM
+const { resolveDir, readSpec } = require('../utils');
+const path = require('path');
+
+module.exports = function(args) {
+  const dir = resolveDir(args[0]);
+
+  console.log('📋 R5·收口 — 生成 12 实施计划 + 13 测试策略 + 14 追溯矩阵');
+  console.log('');
+  console.log('输入: 全部已完成 Spec (01-11)');
+  console.log('输出:');
+  console.log('  ' + path.join(dir, '12-implementation-plan.md'));
+  console.log('  ' + path.join(dir, '13-test-strategy.md'));
+  console.log('  ' + path.join(dir, '14-traceability-matrix.md'));
+  console.log('');
+  console.log('请将以下 Prompt 复制到 AI 编码工具中执行：');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log(`你是项目经理 + QA 专家。请根据项目全部 Spec 文档，生成以下三份收口文档：
+
+## 12-实施计划
+里程碑（含交付物和验收标准）、WBS 任务分解（含负责人和预估工时）、依赖关系、风险矩阵、回滚方案
+
+## 13-测试策略
+五层测试策略（单元/集成/E2E/性能/安全）、测试范围、通过标准（准入+准出）、自动化策略、追溯（每个测试用例关联 AC 和 API）
+
+## 关键：14-RTM 追溯矩阵
+遍历全部已写 Spec 文档：
+- 从 04-PRD 提取功能列表
+- 从 05-用户故事 提取 US 编号和 AC 编号
+- 从 06-FSD 提取对应的章节
+- 从 09-API 提取对应的端点
+- 从 10-数据模型 提取对应的表
+- 从 13-测试策略 提取对应的测试用例
+- 填满一条完整的追溯链：需求→PRD→US→FSD→API→数据→测试
+- 统计覆盖率，标注缺口
+
+格式：中文 + Markdown 巨型表格
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+  console.log('');
+  const counts = [];
+  for (let i = 3; i <= 11; i++) { const c = readSpec(dir, i); if (c) counts.push('0'+i+': '+c.length+' 字符'); }
+  if (counts.length) console.log('📎 已加载文档: ' + counts.join(', '));
+  console.log('💡 建议先生成 12+13，最后生成 14（需要遍历全部文档）');
+};

package/src/commands/console.js

@@ -0,0 +1,49 @@
+// mumuspec console — 生成 Spec 可视化控制台 HTML
+const fs = require('fs');
+const path = require('path');
+const { resolveDir, readSpec } = require('../utils');
+
+module.exports = function(args) {
+  const specDir = resolveDir(args[0] || 'specs');
+  const outputPath = path.resolve(args[1] || 'spec-console.html');
+
+  if (!fs.existsSync(specDir)) { console.error('❌ 目录不存在: ' + specDir); process.exit(1); }
+
+  const docs = [];
+  for (let i = 1; i <= 14; i++) {
+    const content = readSpec(specDir, i);
+    const titleMatch = content ? content.match(/^#\s*\d*\s*[—\-−]\s*(.+)/m) : null;
+    docs.push({ num: i, title: titleMatch ? titleMatch[1].trim() : '—', status: content ? (content.replace(/#.*\n?/g,'').replace(/>.*\n?/g,'').trim().length > 50 ? 'filled' : 'empty') : 'missing' });
+  }
+  const filled = docs.filter(d => d.status === 'filled').length;
+
+  const html = `<!DOCTYPE html><html lang="zh-CN">
+<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1.0"><title>Spec Console — ${path.basename(path.resolve(specDir))}</title>
+<style>
+*{margin:0;padding:0;box-sizing:border-box}body{font-family:"PingFang SC",-apple-system,sans-serif;color:#1a1a1a;background:#f8f8f5;line-height:1.6}
+.topbar{position:sticky;top:0;z-index:10;background:rgba(248,248,245,0.88);backdrop-filter:blur(10px);border-bottom:1px solid #e4e4e0;padding:14px 32px;display:flex;align-items:center;justify-content:space-between}
+.topbar h1{font-size:16px;font-weight:650;color:#111}.topbar .badge{font-size:12px;padding:4px 10px;border-radius:12px;background:#e8f5e8;color:#3a8a3a}
+.page{max-width:1200px;margin:0 auto;padding:32px}
+.progress-wrap{margin-bottom:32px;background:#fff;border:1px solid #e4e4e0;border-radius:8px;padding:20px 24px;display:flex;align-items:center;gap:20px}
+.progress-bar{flex:1;height:8px;background:#f0f0ed;border-radius:4px;overflow:hidden}.progress-fill{height:100%;background:#d94f4f;border-radius:4px;transition:width .5s}
+.progress-text{font-size:14px;font-weight:650;color:#111;white-space:nowrap}
+.doc-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:2px;background:#e4e4e0;border:1px solid #e4e4e0;border-radius:8px;overflow:hidden}
+.doc-card{background:#fff;padding:18px 20px}.doc-card h3{font-size:13px;font-weight:650;color:#111;margin-bottom:4px}
+.dc-status{font-size:10px;padding:2px 6px;border-radius:3px;font-weight:600;display:inline-block;margin-bottom:6px}
+.dc-status.filled{background:#e8f5e8;color:#3a8a3a}.dc-status.empty{background:#fef3f3;color:#d94f4f}.dc-status.missing{background:#f5f5f5;color:#ccc}
+.footer{text-align:center;padding:40px 0;border-top:1px solid #e4e4e0;margin-top:32px}.footer p{font-size:11px;color:#ccc}
+@media(max-width:768px){.doc-grid{grid-template-columns:1fr}}
+</style></head>
+<body>
+<nav class="topbar"><h1>Spec Console</h1><span class="badge">${filled}/14 份已填写</span></nav>
+<div class="page">
+<div class="progress-wrap"><div class="progress-bar"><div class="progress-fill" style="width:${Math.round(filled/14*100)}%"></div></div><div class="progress-text">${filled}/14</div></div>
+<div class="doc-grid">
+${docs.map(d => `<div class="doc-card"><h3>${String(d.num).padStart(2,'0')} — ${d.title}</h3><span class="dc-status ${d.status}">${d.status==='filled'?'✅ 已填写':d.status==='empty'?'⚠️ 内容空':'❌ 文件缺失'}</span></div>`).join('')}
+</div></div>
+<footer class="footer"><p>Generated by MumuSpec CLI · <a href="https://mumucoding.com" style="color:#aaa">mumucoding.com</a></p></footer>
+</body></html>`;
+  fs.writeFileSync(outputPath, html, 'utf-8');
+  console.log('✨ Spec Console 已生成: ' + outputPath);
+  console.log('📊 ' + filled + '/14 份已填写');
+};

package/src/commands/create.js

@@ -0,0 +1,58 @@
+// mumuspec create — 生成 Spec 项目骨架
+const fs = require('fs');
+const path = require('path');
+
+const TEMPLATES = require('../templates');
+
+module.exports = function(args) {
+  const name = args[0];
+  if (!name) { console.log('用法: mumuspec create <项目名>\n示例: mumuspec create my-project'); process.exit(1); }
+
+  const root = path.resolve(name);
+  if (fs.existsSync(root)) { console.error('❌ 目录已存在: ' + name); process.exit(1); }
+
+  const specsDir = path.join(root, 'specs');
+  fs.mkdirSync(specsDir, { recursive: true });
+
+  let count = 0;
+  Object.entries(TEMPLATES).forEach(([filename, content]) => {
+    fs.writeFileSync(path.join(specsDir, filename), content.trim() + '\n', 'utf-8'); count++;
+  });
+
+  const agentsMd = `# AGENTS.md — AI 编码助手角色定义
+
+## 角色
+你是本项目的 AI 编程助手。你的唯一输入是本项目的 Spec 文档（specs/ 目录）。
+
+## 工作流程
+1. 接到任务 → 先读取相关的 Spec 文档（03-13）
+2. 理解需求 → 基于 Spec 中的 AC 确认验收标准
+3. 生成代码 → 严格按 Spec 定义的 API 契约和数据模型
+4. 自检 → 生成后对照 Spec 逐条验证 AC
+5. 提交 PR → PR 描述中关联 Spec 编号
+
+## 行为边界
+- ✅ 可以：读写 src/ 目录下的代码文件
+- ✅ 可以：运行测试和 Lint
+- ❌ 禁止：直接修改 main/master 分支
+- ❌ 禁止：删除未 git tracked 的文件
+- ❌ 禁止：执行需要人工确认的系统命令`;
+  fs.writeFileSync(path.join(root, 'AGENTS.md'), agentsMd.trim() + '\n', 'utf-8');
+
+  fs.writeFileSync(path.join(root, '.gitignore'), 'node_modules/\n.env\n.DS_Store\nspecs/*.local.md\n', 'utf-8');
+
+  console.log('');
+  console.log('✨ MumuSpec 项目已创建: ' + name + '/');
+  console.log('   specs/        — ' + count + ' 份 Spec 模板 (01-14)');
+  console.log('   AGENTS.md    — AI 编码助手角色定义');
+  console.log('');
+  console.log('🚀 下一步:');
+  console.log('   cd ' + name);
+  console.log('   mumuspec elicit     # R1: 需求采集');
+  console.log('   mumuspec propose    # R2: 立项提案');
+  console.log('   mumuspec anchor     # R3: 锚定对齐');
+  console.log('   mumuspec design     # R4: 设计生成');
+  console.log('   mumuspec close      # R5: 收口');
+  console.log('   mumuspec validate   # 门禁校验');
+  console.log('');
+};

package/src/commands/design.js

@@ -0,0 +1,47 @@
+// R4·设计 — 06 FSD + 07 NFR + 08 架构 + 10 数据 + 11 安全
+const { resolveDir, readSpec } = require('../utils');
+const path = require('path');
+
+module.exports = function(args) {
+  const dir = resolveDir(args[0]);
+  const s05 = readSpec(dir, 5);
+  const s09 = readSpec(dir, 9);
+
+  console.log('📋 R4·设计 — 生成功能规格 + 非功能需求 + 架构 + 数据 + 安全');
+  console.log('');
+  console.log('输入: 05 用户故事 + 09 API 契约');
+  console.log('输出:');
+  console.log('  ' + path.join(dir, '06-fsd.md'));
+  console.log('  ' + path.join(dir, '07-nfr.md'));
+  console.log('  ' + path.join(dir, '08-architecture.md'));
+  console.log('  ' + path.join(dir, '10-data-model.md'));
+  console.log('  ' + path.join(dir, '11-security.md'));
+  console.log('');
+  console.log('请将以下 Prompt 复制到 AI 编码工具中执行：');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log(`你是全栈技术专家。请根据 05-用户故事 和 09-API契约，生成以下五份文档：
+
+## 06-FSD 功能规格
+每个功能：交互流程（步骤级）、界面说明（布局+组件）、异常处理（场景+提示）、状态机（如有）、边界条件
+
+## 07-NFR 非功能需求
+性能（响应时间/吞吐量/并发）、可用性（SLA/容灾）、安全（认证/授权）、兼容性、可维护性
+
+## 08-架构选型
+技术栈选型对比、ADR（架构决策记录）、部署架构、依赖关系
+
+## 10-数据模型
+ER 图（Mermaid）、表结构（字段/类型/约束）、索引策略、数据流
+
+## 11-安全设计
+攻击面分析、权限模型、数据加密、安全控制措施、审计日志、合规映射
+
+格式：中文 + Mermaid 图 + Markdown 表格。所有技术决策要写理由。
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+  if (s05) console.log('📎 05-用户故事: ' + s05.length + ' 字符');
+  if (s09) console.log('📎 09-API契约: ' + s09.length + ' 字符');
+  if (!s05 && !s09) console.log('⚠️  输入文档为空。建议先运行 mumuspec anchor');
+  console.log('');
+  console.log('💡 建议分步生成：先 06+07，再 08+10，最后 11');
+};

package/src/commands/elicit.js

@@ -0,0 +1,49 @@
+// mumuspec elicit — R1 采集：原始素材 → 02 需求采集
+const fs = require('fs');
+const path = require('path');
+const { resolveDir } = require('../utils');
+
+const PROMPT = `你是需求分析专家。请根据以下原始素材，生成 02-需求采集文档。
+
+生成的文档应包含以下章节：
+## 1. 需求来源 — 列出需求的来源方、类型和优先级
+## 2. 干系人清单 — 每个干系人的角色、核心诉求、决策权限
+## 3. 业务背景 — 为什么这个需求重要，不做的后果
+## 4. 初步假设 — 当前对需求的假设，需后续验证
+
+格式要求：
+- 用中文撰写
+- 表格用 Markdown 表格格式
+- 不确定的内容标注 [待确认]
+- 不要编造素材中不存在的信息`;
+
+module.exports = function elicit(args) {
+  const dir = resolveDir(args[0]);
+  const filePath = path.join(dir, '02-elicitation.md');
+
+  console.log('📋 R1·采集 — 生成 02 需求采集');
+  console.log('');
+
+  // Read existing raw materials if any
+  const rawFiles = fs.readdirSync(process.cwd()).filter(f => f.endsWith('.md') && f !== '02-elicitation.md');
+  const rawContent = rawFiles.map(f => {
+    const content = fs.readFileSync(path.join(process.cwd(), f), 'utf-8');
+    return `### ${f}\n${content.substring(0, 3000)}`;
+  }).join('\n\n');
+
+  console.log('📄 已读取项目中的素材文件作为输入。');
+  console.log('');
+  console.log('请将以下 Prompt 复制到 AI 编码工具中执行：');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log(PROMPT);
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('');
+  if (rawContent) {
+    console.log('📎 上下文素材（已自动附加）:');
+    console.log(rawContent.substring(0, 500));
+    if (rawContent.length > 500) console.log('...(已截断)');
+  }
+  console.log('');
+  console.log('💡 提示：将 Prompt + 上下文素材一起发给 AI，让它生成 02-elicitation.md');
+  console.log('   生成后保存到: ' + filePath);
+};

package/src/commands/freeze.js

@@ -0,0 +1,28 @@
+// mumuspec freeze — 版本冻结
+const { execSync } = require('child_process');
+const { resolveDir } = require('../utils');
+
+module.exports = function(args) {
+  const dir = resolveDir(args[0]);
+  const tag = args[1] || 'spec-v' + new Date().toISOString().slice(0,10).replace(/-/g,'');
+
+  console.log('🔒 版本冻结 — 锁定当前 Spec');
+  console.log('');
+  console.log('  Spec 目录: ' + dir);
+  console.log('  Tag 名称:  ' + tag);
+  console.log('');
+  console.log('请执行以下操作完成冻结:');
+  console.log('');
+  console.log('  1. 确认所有 Spec 文档已通过校验: mumuspec validate');
+  console.log('  2. 提交当前版本:');
+  console.log('     git add ' + dir + '/');
+  console.log('     git commit -m "freeze: ' + tag + '"');
+  console.log('     git tag ' + tag);
+  console.log('  3. 推送:');
+  console.log('     git push origin main --tags');
+  console.log('');
+  console.log('  冻结后:');
+  console.log('  - 代码生成必须以冻结版 Spec 为准');
+  console.log('  - 变更需求必须先解锁 → 更新 Spec → 重新冻结');
+  console.log('  - PR 必须关联 Spec 编号');
+};

package/src/commands/impact.js

@@ -0,0 +1,43 @@
+// mumuspec impact — 变更影响分析
+const { resolveDir, readSpec, findSpec } = require('../utils');
+
+const DEPENDENCIES = {
+  '01': [], '02': ['01'], '03': ['02'], '04': ['03'],
+  '05': ['04'], '06': ['05','04'], '07': ['04'],
+  '08': ['07'], '09': ['05','06'], '10': ['08','09'],
+  '11': ['07','08'], '12': ['08','09','10'],
+  '13': ['05','06','09','10','11','12'],
+  '14': ['01','02','03','04','05','06','07','08','09','10','11','12','13']
+};
+const REVERSE = {};
+Object.entries(DEPENDENCIES).forEach(([k, deps]) => deps.forEach(d => { if (!REVERSE[d]) REVERSE[d] = []; REVERSE[d].push(k); }));
+
+module.exports = function(args) {
+  const dir = resolveDir(args[1]);
+  const specId = args[0];
+  if (!specId) { console.log('用法: mumuspec impact <spec-id> [dir]\n示例: mumuspec impact 05'); process.exit(1); }
+
+  const pureId = specId.replace(/^0+/,'');
+  const downstream = REVERSE[pureId] || [];
+
+  console.log('💥 变更影响分析 — Spec ' + (String(pureId).padStart(2,'0')));
+  console.log('');
+  if (downstream.length === 0) {
+    console.log('  ✅ 无下游依赖文档。此文档变更不影响其他 Spec。');
+  } else {
+    console.log('  📋 受影响的文档（需同步更新）:');
+    const affected = [];
+    function collect(id, depth) { if (!affected.includes(id)) { affected.push(id); (REVERSE[id]||[]).forEach(d => collect(d, depth+1)); } }
+    downstream.forEach(d => collect(d, 1));
+
+    affected.forEach(id => {
+      const f = findSpec(dir, id);
+      const status = f ? '存在' : '缺失';
+      console.log('    ' + String(id).padStart(2,'0') + ' — ' + status + (f ? '' : ' ⚠️'));
+    });
+    console.log('');
+    console.log(`  总计 ${affected.length} 份文档受影响`);
+  }
+  console.log('');
+  console.log('💡 运行 mumuspec sync ' + specId + ' 自动更新关联文档');
+};

package/src/commands/propose.js

@@ -0,0 +1,41 @@
+// R2·提案 — 03 立项提案 + 04 PRD
+const { resolveDir, readSpec, findSpec } = require('../utils');
+const path = require('path');
+
+module.exports = function(args) {
+  const dir = resolveDir(args[0]);
+  const s02 = readSpec(dir, 2);
+
+  console.log('📋 R2·提案 — 生成 03 立项提案 + 04 PRD');
+  console.log('');
+  console.log('输入: 02 需求采集');
+  console.log('输出: ' + path.join(dir, '03-proposal.md'));
+  console.log('      ' + path.join(dir, '04-prd.md'));
+  console.log('');
+  console.log('请将以下 Prompt 复制到 AI 编码工具中执行：');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log(`你是产品需求专家。请根据以下 02-需求采集文档，生成两份文档：
+
+## 第一步：生成 03-立项提案
+包含章节：执行摘要、问题陈述、方案概述、范围界定（含/不含）、成功标准（可度量指标）、时间线与里程碑、风险评估、干系人签批
+
+## 第二步：生成 04-产品需求 PRD
+包含章节：产品概述、用户画像（2-3个角色）、功能清单（ID/描述/优先级）、用户旅程（主流程+边缘场景）、业务规则、数据需求、集成点、验收标准
+
+格式要求：
+- 中文撰写，Markdown 表格
+- 成功标准必须是可度量的（数字或明确的是/否判断）
+- 用户故事用"作为[角色]，我想要[功能]，以便[价值]"格式
+- 不要编造素材中不存在的信息，不确定的标注 [待确认]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+  if (s02) {
+    console.log('📎 02-需求采集（已自动附加）:');
+    console.log(s02.substring(0, 800));
+    if (s02.length > 800) console.log('...(已截断，完整内容见文件)');
+  } else {
+    console.log('⚠️  02-需求采集 内容为空或不存在。建议先运行 mumuspec elicit');
+  }
+  console.log('');
+  console.log('💡 生成后保存为 03-proposal.md 和 04-prd.md');
+};

package/src/commands/status.js

@@ -0,0 +1,34 @@
+// mumuspec status — 项目状态
+const fs = require('fs');
+const { resolveDir, readSpec } = require('../utils');
+
+module.exports = function(args) {
+  const dir = resolveDir(args[0]);
+  const phases = [
+    { name:'Meta', docs:[1,2] },
+    { name:'Proposal', docs:[3,4] },
+    { name:'Spec', docs:[5,6,7] },
+    { name:'Design', docs:[8,9,10,11] },
+    { name:'Plan & Test', docs:[12,13] },
+    { name:'Trace', docs:[14] }
+  ];
+
+  console.log('📊 MumuSpec 项目状态');
+  console.log('   Spec 目录: ' + dir);
+  console.log('');
+
+  let total = 0, filled = 0;
+  phases.forEach(p => {
+    const d = p.docs.map(n => { const c = readSpec(dir, n); const ok = c && c.replace(/#.*\n?/g,'').replace(/>.*\n?/g,'').trim().length > 50; total++; if(ok) filled++; return {n,ok}; });
+    const pFilled = d.filter(x=>x.ok).length;
+    const bar = '█'.repeat(pFilled) + '░'.repeat(d.length - pFilled);
+    console.log('  ' + p.name.padEnd(12) + ' ' + bar + ' ' + pFilled + '/' + d.length);
+  });
+
+  console.log('');
+  console.log('  总计: ' + filled + '/' + total + ' 份已填写');
+  console.log('  进度: ' + Math.round(filled/total*100) + '%');
+  if (filled === 14) console.log('  ✅ 全部就绪，可以冻结了: mumuspec freeze');
+  else if (filled >= 8) console.log('  📝 进度过半，继续加油');
+  else console.log('  🚀 刚开始，可以先跑 mumuspec elicit → propose → anchor');
+};

package/src/commands/sync.js

@@ -0,0 +1,21 @@
+// mumuspec sync — 变更联动
+const { resolveDir } = require('../utils');
+
+module.exports = function(args) {
+  const dir = resolveDir(args[1]);
+  const specId = args[0];
+  if (!specId) { console.log('用法: mumuspec sync <spec-id> [dir]\n示例: mumuspec sync 04'); process.exit(1); }
+
+  console.log('🔄 变更联动 — Spec ' + specId);
+  console.log('');
+  console.log('此命令将分析 ' + specId + ' 的变更内容，并更新与之关联的下游文档。');
+  console.log('');
+  console.log('💡 在 AI 编码工具中执行以下 Prompt：');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log(`我修改了 Spec-${specId}。请读取这份文档的最新内容，然后遍历所有依赖它的下游 Spec 文档，逐一检查是否需要更新。
+
+更新原则：只修改受影响的字段和章节，保留其他内容不变。每个修改标注理由。
+
+修改完成后运行 mumuspec validate 验证一致性。`);
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+};

package/src/commands/validate.js

@@ -0,0 +1,52 @@
+// mumuspec validate — 门禁校验
+const fs = require('fs');
+const { resolveDir, findSpec, readSpec } = require('../utils');
+
+function checkAC(d05) { return (d05.match(/AC-\d+/gi) || []).length; }
+function checkTrace(d05, d09) { const ac = d05.match(/AC-\d+/gi) || []; const api = d09.match(/US-\d+/gi) || []; return ac.length > 0 && api.length > 0; }
+function checkSize(content) { const body = content.replace(/#.*\n?/g,'').replace(/>.*\n?/g,'').trim(); return body.length; }
+
+module.exports = function(args) {
+  const dir = resolveDir(args[0]);
+  console.log('🔍 MumuSpec 门禁校验');
+  console.log('');
+
+  const checks = [
+    { id: '01', label: '写作总则', fn: (c) => checkSize(c) > 80 },
+    { id: '02', label: '需求采集', fn: (c) => checkSize(c) > 50 },
+    { id: '03', label: '立项提案', fn: (c) => checkSize(c) > 100 },
+    { id: '04', label: '产品需求 PRD', fn: (c) => checkSize(c) > 100 },
+    { id: '05', label: '用户故事', fn: (c) => checkSize(c) > 80 && checkAC(c) >= 3 },
+    { id: '06', label: '功能规格 FSD', fn: (c) => checkSize(c) > 80 },
+    { id: '07', label: '非功能需求', fn: (c) => checkSize(c) > 50 },
+    { id: '08', label: '架构选型', fn: (c) => checkSize(c) > 50 },
+    { id: '09', label: 'API 契约', fn: (c) => checkSize(c) > 80 },
+    { id: '10', label: '数据模型', fn: (c) => checkSize(c) > 50 },
+    { id: '11', label: '安全设计', fn: (c) => checkSize(c) > 50 },
+    { id: '12', label: '实施计划', fn: (c) => checkSize(c) > 50 },
+    { id: '13', label: '测试策略', fn: (c) => checkSize(c) > 50 },
+    { id: '14', label: '追溯矩阵', fn: (c) => checkSize(c) > 50 },
+  ];
+
+  let pass = 0, fail = 0;
+  checks.forEach(ch => {
+    const c = readSpec(dir, parseInt(ch.id));
+    const ok = c && ch.fn(c);
+    console.log((ok ? '  ✅' : '  ❌') + ' ' + ch.id.padStart(2,' ') + ' ' + ch.label + (!c ? ' (文件缺失)' : ok ? '' : ' (内容不足)'));
+    ok ? pass++ : fail++;
+  });
+
+  // Cross-doc checks
+  const s05 = readSpec(dir, 5) || '';
+  const s09 = readSpec(dir, 9) || '';
+  const s14 = readSpec(dir, 14) || '';
+  const acCount = checkAC(s05);
+  let crossOk = true;
+  if (acCount > 0 && s09 && !checkTrace(s05, s09)) { console.log('  ⚠️  AC-API 追溯: 05 有 AC 但 09 未关联 US 编号'); crossOk = false; }
+  if (s14.length < 50 && acCount > 0) { console.log('  ⚠️  RTM 追溯: 05 有 AC 但 14 追溯矩阵为空'); crossOk = false; }
+
+  console.log('');
+  if (pass === 14 && crossOk) { console.log('✅ 全部 14 份文档通过门禁校验'); }
+  else { console.log(`📊 通过 ${pass}/14，未通过 ${fail}/14`); }
+  process.exit(pass === 14 ? 0 : 1);
+};

package/src/commands/view.js

@@ -0,0 +1,38 @@
+// mumuspec view — 角色视图
+const { resolveDir, readSpec } = require('../utils');
+
+const ROLE_DOCS = {
+  pm:    { label:'产品经理', docs:[2,3,4,5,6], desc:'需求采集→立项→PRD→用户故事→FSD' },
+  dev:   { label:'开发者', docs:[5,6,9,10,12], desc:'用户故事→FSD→API→数据→实施计划' },
+  qa:    { label:'QA', docs:[5,6,9,13,14], desc:'用户故事→FSD→API→测试策略→RTM' },
+  arch:  { label:'架构师', docs:[1,7,8,11], desc:'写作总则→NFR→架构→安全' },
+};
+
+module.exports = function(args) {
+  const roleArg = args.indexOf('--role') > -1 ? args[args.indexOf('--role')+1] : null;
+  let dir = process.cwd();
+  for (const a of args) { if (!a.startsWith('--') && a !== roleArg) { dir = require('../utils').resolveDir(a); break; } }
+
+  if (!roleArg || !ROLE_DOCS[roleArg]) {
+    console.log('用法: mumuspec view --role <pm|dev|qa|arch> [dir]');
+    console.log('  pm   — 产品经理视角 (02-06)');
+    console.log('  dev  — 开发者视角 (05-06-09-10-12)');
+    console.log('  qa   — QA 视角 (05-06-09-13-14)');
+    console.log('  arch — 架构师视角 (01-07-08-11)');
+    process.exit(1);
+  }
+
+  const role = ROLE_DOCS[roleArg];
+  console.log('👤 ' + role.label + '视角');
+  console.log('   ' + role.desc);
+  console.log('');
+
+  role.docs.forEach(n => {
+    const c = readSpec(dir, n);
+    const status = c ? (c.replace(/#.*\n?/g,'').replace(/>.*\n?/g,'').trim().length > 50 ? '✅' : '⚠️') : '❌';
+    const file = (require('../utils').findSpec(dir, n) || '').replace(dir+'/','');
+    console.log('  ' + status + ' ' + String(n).padStart(2,'0') + '  ' + (file || '(缺失)'));
+  });
+  console.log('');
+  console.log('💡 用 AI 工具打开上述文件，让 AI 基于这些文档开始工作');
+};

package/src/templates.js

@@ -0,0 +1,16 @@
+module.exports = {
+  '01-writing-guidelines.md': '# 01 — 写作总则\n\n> 文档编号：SPEC-01 | 阶段：Meta | 优先级：P1\n\n## 1. 目的\n定义本套 Spec 的书写规范、术语和格式约定。\n\n## 2. 受众\n| 角色 | 如何使用本套 Spec |\n|------|------------------|\n| 产品经理 | 编写 02-06 号文档 |\n| 架构师 | 编写 07-08、11 号文档 |\n| 开发者 | 依据 06、09、10 号文档进行开发 |\n| QA | 依据 05、13、14 号文档设计测试 |\n\n## 3. 术语表\n| 术语 | 定义 |\n|------|------|\n| | |\n\n## 4. 格式规范\n- 文件名: `XX-document-name.md`\n- 文档版本: 在文档元数据区标注\n- 编号规则: 01-14 固定编号，不可重复\n\n## 5. 版本控制\n- 每份文档有独立的版本号\n- 冻结后打 Git tag\n- 变更记录写在文档末尾\n\n## 6. AI 辅助规范\n- AI 编码工具应读取本套 Spec 作为上下文\n- Spec 冻结后禁止 AI 修改 Spec 文档\n',
+  '02-elicitation.md': '# 02 — 需求采集\n\n> 文档编号：SPEC-02 | 阶段：Meta | 优先级：P2\n\n## 1. 需求来源\n| 来源 | 描述 | 优先级 |\n|------|------|--------|\n| | | |\n\n## 2. 干系人清单\n| 姓名 | 角色 | 核心诉求 | 决策权限 |\n|------|------|---------|---------|\n| | | | |\n\n## 3. 业务背景\n_为什么这个需求重要？不做的后果是什么？_\n\n## 4. 初步假设\n_当前对需求的假设（需后续验证）_\n',
+  '03-proposal.md': '# 03 — 立项提案\n\n> 文档编号：SPEC-03 | 阶段：Proposal | 优先级：P0\n\n## 1. 执行摘要\n_一段话说明项目内容和价值_\n\n## 2. 问题陈述\n_当前的问题是什么，影响多大？_\n\n## 3. 方案概述\n_高层级的解决思路_\n\n## 4. 范围界定\n### 4.1 包含范围\n### 4.2 不包含范围\n\n## 5. 成功标准\n| 指标 | 目标值 | 度量方式 |\n|------|--------|---------|\n| | | |\n\n## 6. 时间线与里程碑\n| 里程碑 | 目标日期 | 交付物 |\n|--------|---------|--------|\n| | | |\n\n## 7. 风险评估\n| 风险 | 可能性 | 影响 | 缓解措施 |\n|------|--------|------|---------|\n| | | | |\n\n## 8. 干系人签批\n| 姓名 | 角色 | 审批意见 | 日期 |\n|------|------|---------|------|\n| | | | |\n',
+  '04-prd.md': '# 04 — 产品需求文档 (PRD)\n\n> 文档编号：SPEC-04 | 阶段：Proposal | 优先级：P1\n\n## 1. 产品概述\n_产品/功能是什么？为谁服务？_\n\n## 2. 用户画像\n| 画像 | 描述 | 核心目标 |\n|------|------|---------|\n| | | |\n\n## 3. 功能清单\n| ID | 功能 | 描述 | 优先级 | 状态 |\n|----|------|------|--------|------|\n| | | | | |\n\n## 4. 用户旅程\n### 4.1 主流程\n### 4.2 边缘场景\n\n## 5. 业务规则\n| ID | 规则 | 触发条件 | 执行动作 |\n|----|------|---------|---------|\n| | | | |\n\n## 6. 数据需求\n## 7. 集成点\n## 8. 验收标准（高层）\n',
+  '05-user-stories.md': '# 05 — 用户故事与验收标准\n\n> 文档编号：SPEC-05 | 阶段：Spec | 优先级：P0\n\n## 1. 故事清单\n| ID | 作为[角色] | 我想要[功能] | 以便[价值] | 优先级 |\n|----|-----------|-------------|-----------|--------|\n| US-001 | | | | |\n\n## 2. 验收条件 (AC)\n### US-001\n| AC-ID | 验收条件 | 验证方式 |\n|-------|---------|---------|\n| AC-001 | | |\n\n## 3. 优先级排序（MoSCoW）\n## 4. 故事依赖关系\n',
+  '06-fsd.md': '# 06 — 功能规格说明 (FSD)\n\n> 文档编号：SPEC-06 | 阶段：Spec | 优先级：P0\n\n## 1. 功能概述\n## 2. 交互流程\n## 3. 界面说明\n## 4. 异常处理\n| 异常场景 | 处理方式 | 用户提示 |\n|---------|---------|---------|\n| | | |\n\n## 5. 状态机\n## 6. 边界条件\n',
+  '07-nfr.md': '# 07 — 非功能需求 (NFR)\n\n> 文档编号：SPEC-07 | 阶段：Spec | 优先级：P1\n\n## 1. 性能要求\n| 指标 | 目标 | 度量方式 |\n|------|------|---------|\n| | | |\n\n## 2. 可用性要求\n## 3. 安全性要求\n## 4. 兼容性要求\n## 5. 可维护性要求\n',
+  '08-architecture.md': '# 08 — 系统架构与技术选型\n\n> 文档编号：SPEC-08 | 阶段：Design | 优先级：P1\n\n## 1. 架构概述\n## 2. 技术选型\n## 3. 架构决策记录 (ADR)\n## 4. 部署架构\n## 5. 依赖关系\n## 6. 风险与权衡\n',
+  '09-api-spec.md': '# 09 — API 契约\n\n> 文档编号：SPEC-09 | 阶段：Design | 优先级：P0\n\n## 1. API 概览\n| 属性 | 值 |\n|------|-----|\n| Base URL | |\n| 版本 | v1 |\n| 认证方式 | |\n| 数据格式 | JSON |\n\n## 2. 端点列表\n\n## 3. 通用数据模型\n## 4. 错误响应格式\n```json\n{ "error": { "code": "string", "message": "string" } }\n```\n',
+  '10-data-model.md': '# 10 — 数据模型与存储规格\n\n> 文档编号：SPEC-10 | 阶段：Design | 优先级：P0\n\n## 1. 实体关系图 (ER)\n## 2. 表结构\n## 3. 索引策略\n## 4. 数据流\n## 5. 迁移方案\n',
+  '11-security.md': '# 11 — 安全设计\n\n> 文档编号：SPEC-11 | 阶段：Design | 优先级：P2\n\n## 1. 攻击面分析\n## 2. 权限模型\n## 3. 数据安全\n## 4. 安全控制措施\n## 5. 审计与日志\n## 6. 合规映射\n',
+  '12-implementation-plan.md': '# 12 — 实施计划与里程碑\n\n> 文档编号：SPEC-12 | 阶段：Plan | 优先级：P2\n\n## 1. 里程碑\n| 里程碑 | 目标日期 | 交付物 | 验收标准 |\n|--------|---------|--------|---------|\n| | | | |\n\n## 2. 任务分解 (WBS)\n## 3. 依赖关系\n## 4. 风险矩阵\n## 5. 回滚方案\n',
+  '13-test-strategy.md': '# 13 — 测试策略与质量门禁\n\n> 文档编号：SPEC-13 | 阶段：Test | 优先级：P0\n\n## 1. 测试范围\n## 2. 测试策略\n| 层级 | 范围 | 工具 | 覆盖率目标 |\n|------|------|------|-----------|\n| | | | |\n\n## 3. 测试环境\n## 4. 通过标准\n## 5. 自动化策略\n## 6. 追溯\n',
+  '14-traceability-matrix.md': '# 14 — 需求追溯矩阵 (RTM)\n\n> 文档编号：SPEC-14 | 阶段：Trace | 优先级：P2\n\n## 1. 完整追溯矩阵\n| 需求 ID | PRD 功能 | 用户故事 | FSD 章节 | API 端点 | 数据模型 | 测试用例 | 状态 |\n|---------|---------|---------|---------|---------|---------|---------|------|\n| | | | | | | | |\n\n## 2. 覆盖率汇总\n## 3. 缺口与风险\n## 4. 变更日志\n',
+};

package/src/utils.js

@@ -0,0 +1,29 @@
+const fs = require('fs');
+const path = require('path');
+
+function resolveDir(arg) {
+  if (arg) return path.resolve(arg);
+  // Check common Spec directories
+  for (const d of ['specs', 'spec', 'Specs', 'Spec']) {
+    if (fs.existsSync(d)) return path.resolve(d);
+  }
+  return process.cwd();
+}
+
+function findSpec(dir, num) {
+  const prefix = String(num).padStart(2,'0');
+  const files = fs.readdirSync(dir).filter(f => f.startsWith(prefix) && f.endsWith('.md'));
+  return files[0] ? path.join(dir, files[0]) : null;
+}
+
+function readSpec(dir, num) {
+  const f = findSpec(dir, num);
+  return f ? fs.readFileSync(f, 'utf-8') : null;
+}
+
+function specExists(dir, num) {
+  const content = readSpec(dir, num);
+  return !!(content && content.replace(/#.*\n?/g,'').replace(/>.*\n?/g,'').trim().length > 50);
+}
+
+module.exports = { resolveDir, findSpec, readSpec, specExists };