openone-workflow-kit 0.1.0

package/bin/init-workspace.cjs

@@ -0,0 +1,966 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const KIT_ROOT = path.resolve(__dirname, '..');
+const SUPPORTED_TOOLS = ['codex', 'claude', 'cursor', 'copilot', 'codebuddy', 'kiro', 'trae'];
+const TOOL_ALIASES = {
+  trea: 'trae',
+  claude_code: 'claude',
+  'claude-code': 'claude',
+  github_copilot: 'copilot',
+  'github-copilot': 'copilot'
+};
+const GENERATED_BY = 'openone-workflow-kit 0.1.0';
+
+const STAGES = [
+  ['init-workspace', '初始化工作区', '扫描本地资料、生成 team-profile、缺资料提问，并生成当前工具 adapter。'],
+  ['new-feature', '初始化功能工作流', '创建 features/{feature}/ 容器、状态文件和截图目录，并完成 S/M/L 复杂度分级。'],
+  ['01-需求讨论', '需求讨论', '澄清业务目标、边界、验收口径和待确认项。'],
+  ['澄清', '澄清', '每轮不超过 5 个针对性问题消融语义歧义，答案写回文档并清理待澄清标记。'],
+  ['02-产品文档', '产品文档', '输出 PRD、业务规则、高层 UI 方向、非功能需求和验收口径。'],
+  ['02B-UI设计', 'UI 设计', '在产品文档后输出可被实现遵循的信息架构、关键流程、页面清单、组件规范、平台适配、可访问性和 04A 交接规范。'],
+  ['03-技术架构', '技术架构', '识别项目族、影响仓库、调用链、分支基线和实现准入风险。'],
+  ['03-06-研发准备', '研发准备编排', '在已有 PRD 和必要的 02B UI 设计基线后串联生成 03 到 06 的研发准备文档；不授权代码实现。'],
+  ['04-代码实现', '代码实现总览', '在准入通过后记录后端、前端、配置、数据和发布影响的真实改动。'],
+  ['04A-前端代码实现', '前端代码实现', '记录页面、组件、接口、状态、回显和前端验证。'],
+  ['04B-后端代码实现', '后端代码实现', '记录接口、服务、数据、事务、消息、配置和后端验证。'],
+  ['05-代码审查', '代码审查', '以问题优先方式审查真实 diff、发布边界、PRD 一致性和残余风险。'],
+  ['06-测试用例', '测试用例', '以风险驱动方式输出覆盖矩阵，每条用例可绑定为完成合同的验收 Oracle。'],
+  ['定义完成', '定义完成', '把 01-06 结论编译成完成合同，通过 Definition Lint 后经用户确认冻结。'],
+  ['一致性检查', '一致性检查', '实现前对合同与各阶段文档做只读交叉检查，逮住冲突、漂移和覆盖缺口。'],
+  ['交付至完成', '交付至完成', '合同冻结后在范围内自主循环实现-验证-修复，直到 blocking Oracle 全绿或精确阻塞。'],
+  ['07-测试执行', '测试执行', '记录真实执行结果与证据，翻转完成合同的 Oracle 状态。'],
+  ['08-发布准备', '发布准备', '完成个人项目的本地集成、版本号、tag、发布清单、回滚点和渠道材料。'],
+  ['09-发布执行', '发布执行', '在用户明确授权后执行远程 push、release、商店/平台发布或部署，并记录证据。'],
+  ['10-复盘总结', '复盘总结', '沉淀项目结论、可复用规则、知识库更新和下一轮改进项。'],
+  ['new-product', '初始化商业化工作流', '创建 business/{product}/ 容器、商业化状态文件和素材目录。'],
+  ['B1-业务定位', '业务定位', '基于产品服务盘点、市场调研和竞争对手分析形成定位陈述与细分选择。'],
+  ['B1-B8-商业化准备', '商业化准备编排', '在容器初始化后串联生成 B1 到 B8 的商业化文档；不授权对外投放。'],
+  ['B2-商业模式', '商业模式', '梳理价值主张、收入与定价假设、成本结构、单位经济和关键假设。'],
+  ['B3-PMF与客户画像', 'PMF 与客户画像', '验证产品市场匹配度，确定理想客户画像 ICP 和负面画像。'],
+  ['B4-场景与购买旅程', '场景与购买旅程', '深挖客户使用场景（JTBD）和付费购买旅程、异议与流失点。'],
+  ['B5-渠道漏斗映射', '渠道漏斗映射', '明确线上线下各渠道在转化漏斗中的位置、作用、成本和 ICP 匹配度。'],
+  ['B6-营销获客策略', '营销获客策略', '制定总体营销/获客策略：阶段目标、主攻渠道、信息一致性和内容支柱。'],
+  ['B7-营销预算', '营销预算', '确定金钱与时间双预算、渠道分配、CAC 目标和止损线。'],
+  ['B8-渠道执行策略', '渠道执行策略', '制定 SEO 及其他已选渠道的执行 playbook，并把营销工程需求回流研发轨。'],
+  ['B9-策略复盘', '策略复盘', '按周期复盘漏斗数据、渠道 ROI 和假设判定，输出渠道加码/保持/降配/砍掉决策。'],
+  ['workflow-status', '工作流状态', '汇总 features 与 business 下所有需求和产品的阶段状态、阻塞和下一步。']
+];
+
+const REQUIRED_SOURCES = [
+  {
+    key: 'business_intro',
+    label: '业务介绍',
+    question: '请提供业务介绍或产品概览文件路径',
+    match: /(业务介绍|业务概览|产品介绍|company|business|overview|readme)/i
+  },
+  {
+    key: 'project_docs',
+    label: '项目资料',
+    question: '请提供项目资料、PRD、需求或架构文档目录',
+    match: /(项目资料|需求|prd|product|docs|architecture|spec)/i
+  },
+  {
+    key: 'ui_specs',
+    label: 'UI 设计文件',
+    question: '请提供 UI 规范、设计稿、原型或设计系统文件路径',
+    match: /(ui|design|figma|prototype|mockup|原型|设计|视觉|规范)/i
+  },
+  {
+    key: 'frontend_rules',
+    label: '前端开发规范',
+    question: '请提供前端开发规范目录或文件路径',
+    match: /(frontend|front-end|前端|web.*规范|ui.*规范)/i
+  },
+  {
+    key: 'backend_rules',
+    label: '后端开发规范',
+    question: '请提供后端开发规范目录或文件路径',
+    match: /(backend|back-end|server|后端|服务端)/i
+  },
+  {
+    key: 'testing_rules',
+    label: '测试规范',
+    question: '请提供测试规范、测试用例或 QA 资料路径',
+    match: /(test|testing|qa|测试|用例|验收)/i
+  },
+  {
+    key: 'market_research',
+    label: '市场与竞品资料',
+    question: '请提供市场调研、竞品分析、用户访谈或渠道数据资料路径（商业化轨 B1-B9 使用；暂缺可跳过）',
+    match: /(市场|竞品|调研|访谈|获客|营销|渠道|定价|market|competitor|research|gtm|marketing|pricing|persona|icp)/i
+  }
+];
+
+const SKIP_DIRS = new Set([
+  '.git',
+  'node_modules',
+  'dist',
+  'build',
+  'target',
+  '.idea',
+  '.vscode',
+  '_worktrees',
+  'open-workflow-kit',
+  'openone-workflow-kit',
+  'workflow'
+]);
+
+const CAPABILITY_FILES = [
+  'branch-gatekeeper.md',
+  'release-safety-checker.md',
+  'prd-code-diff-checker.md',
+  'contract-tracer.md',
+  'worktree-isolator.md',
+  'repo-baseline-scanner.md',
+  'impact-scope-analyzer.md',
+  'security-reviewer.md',
+  'verify-app.md',
+  'ci-cd-automation-governor.md',
+  'personal-git-operator.md',
+  'personal-release-checklist.md',
+  'knowledge-capture-maintainer.md',
+  'deployment-readiness-checker.md',
+  'runtime-evidence-triage.md',
+  'data-change-safety-checker.md',
+  'protocol-state-machine-checker.md',
+  'test-evidence-reviewer.md',
+  'ui-baseline-reviewer.md',
+  'memory-curator.md',
+  'rule-extractor.md',
+  'market-evidence-grader.md',
+  'channel-experiment-tracker.md',
+  'definition-lint.md',
+  'acceptance-oracle-tracker.md'
+];
+
+if (require.main === module) {
+  main().catch((error) => {
+    console.error(error && error.stack ? error.stack : String(error));
+    process.exit(1);
+  });
+}
+
+module.exports = { toPortablePath };
+
+// Paths persisted in generated workflow artifacts are workspace-relative
+// identifiers, not host-OS paths. Keep them stable across Windows/macOS/Linux.
+function toPortablePath(value) {
+  return String(value).replace(/\\/g, '/');
+}
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const target = path.resolve(options.target || process.cwd());
+  if (!fs.existsSync(target) || !fs.statSync(target).isDirectory()) {
+    throw new Error(`目标目录不存在: ${target}`);
+  }
+
+  const detectedTools = detectTools(target);
+  let enabledTools = options.tools ? normalizeTools(options.tools) : detectedTools;
+  const interactive = process.stdin.isTTY && process.stdout.isTTY && !options.yes && !options.dryRun;
+
+  if (!enabledTools.length && interactive) {
+    const answer = await promptLine(
+      `请选择 AI 工具（${SUPPORTED_TOOLS.join(', ')}）。留空会生成全部薄 adapter: `
+    );
+    enabledTools = normalizeTools(answer || SUPPORTED_TOOLS.join(','));
+  }
+  if (!enabledTools.length) enabledTools = SUPPORTED_TOOLS.slice();
+
+  const repos = scanRepos(target);
+  const sources = scanRequiredSources(target);
+  const missing = REQUIRED_SOURCES.filter((item) => sources[item.key].status === 'missing');
+
+  const profile = {
+    target,
+    enabledTools,
+    detectedTools,
+    repos,
+    sources,
+    missing
+  };
+
+  if (interactive && missing.length) {
+    for (const item of missing) {
+      const answer = await promptLine(`${item.question} (optional, comma separated): `);
+      if (answer.trim()) {
+        sources[item.key] = {
+          status: 'provided_by_user',
+          paths: answer.split(',').map((v) => v.trim()).filter(Boolean)
+        };
+      }
+    }
+    profile.missing = REQUIRED_SOURCES.filter((item) => sources[item.key].status === 'missing');
+  }
+
+  const plannedWrites = buildInstallPlan(target, profile, options);
+  if (options.dryRun) {
+    printDryRun(target, profile, plannedWrites);
+    return;
+  }
+
+  for (const write of plannedWrites) {
+    writeManagedFile(write.file, write.content, options);
+  }
+
+  console.log(`已在 ${target} 初始化 agent 工作流`);
+  console.log(`启用工具: ${enabledTools.join(', ')}`);
+  if (profile.missing.length) {
+    console.log('部分必要资料未找到，请查看 workflow/INITIALIZATION_QUESTIONS.md。');
+  }
+}
+
+function parseArgs(argv) {
+  const options = { target: '', tools: '', yes: false, force: false, upgrade: false, dryRun: false };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--target') options.target = argv[++i] || '';
+    else if (arg === '--tools') options.tools = argv[++i] || '';
+    else if (arg === '--yes' || arg === '-y') options.yes = true;
+    else if (arg === '--force') options.force = true;
+    else if (arg === '--upgrade') options.upgrade = true;
+    else if (arg === '--dry-run') options.dryRun = true;
+    else if (arg === '--help' || arg === '-h') {
+      printHelp();
+      process.exit(0);
+    }
+    else throw new Error(`未知参数: ${arg}`);
+  }
+  return options;
+}
+
+function printHelp() {
+  console.log(`用法: node bin/init-workspace.cjs [options]
+
+选项:
+  --target <dir>       目标工作区根目录，默认是当前目录。
+  --tools <list>       逗号分隔的工具列表: ${SUPPORTED_TOOLS.join(', ')}。
+  --yes, -y            非交互模式，缺失资料会写入问题清单。
+  --force              覆盖已生成的入口文件。
+  --upgrade            刷新生成文件；存在 team-profile.yaml 时按当前策略处理。
+  --dry-run            只展示计划写入的文件，不修改磁盘。
+  --help, -h           显示帮助。
+
+该初始化命令不会执行远程 Git 操作、push 代码、触发构建部署或数据库写入。
+个人工作流允许后续 agent 在明确任务范围内执行本地分支命名、创建、commit、tag 和本地 merge；远程 push、release、部署和生产配置写入仍需要用户明确授权。`);
+}
+
+function normalizeTools(value) {
+  const raw = Array.isArray(value) ? value : String(value).split(',');
+  const normalized = [];
+  for (const item of raw) {
+    const input = item.trim().toLowerCase();
+    const tool = TOOL_ALIASES[input] || input;
+    if (!tool) continue;
+    if (!SUPPORTED_TOOLS.includes(tool)) {
+      throw new Error(`不支持的工具: ${tool}。支持的工具: ${SUPPORTED_TOOLS.join(', ')}`);
+    }
+    if (!normalized.includes(tool)) normalized.push(tool);
+  }
+  return normalized;
+}
+
+function promptLine(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer);
+    });
+  });
+}
+
+function detectTools(root) {
+  const hits = [];
+  const exists = (rel) => fs.existsSync(path.join(root, rel));
+  if (exists('.codex') || exists('AGENTS.md')) hits.push('codex');
+  if (exists('.claude') || exists('CLAUDE.md')) hits.push('claude');
+  if (exists('.cursor')) hits.push('cursor');
+  if (exists('.github/copilot-instructions.md') || exists('.github/prompts')) hits.push('copilot');
+  if (exists('.codebuddy')) hits.push('codebuddy');
+  if (exists('.kiro')) hits.push('kiro');
+  if (exists('.trae')) hits.push('trae');
+  return hits;
+}
+
+function scanRepos(root) {
+  const repos = [];
+  const seen = new Set();
+
+  function visit(dir, depth) {
+    if (depth > 2) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+
+    const rel = toPortablePath(path.relative(root, dir)) || '.';
+    const marker = detectRepoMarker(dir);
+    if (marker && !seen.has(rel)) {
+      seen.add(rel);
+      repos.push({
+        path: rel,
+        marker,
+        tech_stack: detectTechStack(dir)
+      });
+      return;
+    }
+
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (SKIP_DIRS.has(entry.name) || entry.name.startsWith('.')) continue;
+      visit(path.join(dir, entry.name), depth + 1);
+    }
+  }
+
+  visit(root, 0);
+  return repos.sort((a, b) => a.path.localeCompare(b.path));
+}
+
+function detectRepoMarker(dir) {
+  const markers = [
+    ['.git', 'git'],
+    ['package.json', 'node'],
+    ['pom.xml', 'maven'],
+    ['build.gradle', 'gradle'],
+    ['go.mod', 'go'],
+    ['Cargo.toml', 'rust'],
+    ['pyproject.toml', 'python'],
+    ['requirements.txt', 'python']
+  ];
+  for (const [file, marker] of markers) {
+    if (fs.existsSync(path.join(dir, file))) return marker;
+  }
+  return '';
+}
+
+function detectTechStack(dir) {
+  const stack = [];
+  const has = (file) => fs.existsSync(path.join(dir, file));
+  if (has('pom.xml')) stack.push('java-maven');
+  if (has('build.gradle')) stack.push('java-gradle');
+  if (has('package.json')) {
+    stack.push('node');
+    try {
+      const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
+      const deps = Object.assign({}, pkg.dependencies || {}, pkg.devDependencies || {});
+      if (deps.vue) stack.push('vue');
+      if (deps.react) stack.push('react');
+      if (deps.next) stack.push('nextjs');
+      if (deps.vite) stack.push('vite');
+      if (deps.typescript) stack.push('typescript');
+    } catch {
+      stack.push('package-json-unreadable');
+    }
+  }
+  if (has('go.mod')) stack.push('go');
+  if (has('pyproject.toml') || has('requirements.txt')) stack.push('python');
+  return stack.length ? stack : ['unknown'];
+}
+
+function scanRequiredSources(root) {
+  const candidates = [];
+  walkFiles(root, 4, (file) => {
+    const ext = path.extname(file).toLowerCase();
+    if (!['.md', '.txt', '.docx', '.pdf', '.yaml', '.yml', '.json'].includes(ext)) return;
+    candidates.push(toPortablePath(path.relative(root, file)));
+  });
+
+  const result = {};
+  for (const source of REQUIRED_SOURCES) {
+    const matches = candidates.filter((rel) => source.match.test(rel)).slice(0, 20);
+    result[source.key] = matches.length
+      ? { status: 'detected', paths: matches }
+      : { status: 'missing', paths: [] };
+  }
+  return result;
+}
+
+function walkFiles(root, maxDepth, visitor) {
+  function visit(dir, depth) {
+    if (depth > maxDepth) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (SKIP_DIRS.has(entry.name) || entry.name.startsWith('.')) continue;
+        visit(full, depth + 1);
+      } else {
+        visitor(full);
+      }
+    }
+  }
+  visit(root, 0);
+}
+
+function buildInstallPlan(target, profile, options) {
+  const writes = [];
+  const add = (rel, content) => writes.push({ file: path.join(target, rel), content });
+
+  add('workflow/team-profile.yaml', makeTeamProfileYaml(profile));
+  add('workflow/README.md', makeWorkflowReadme());
+  add('workflow/core/README.md', readKitFile('workflow/core/README.md'));
+  add('workflow/core/commands/README.md', readKitFile('workflow/core/commands/README.md'));
+  add('workflow/core/templates/README.md', readKitFile('workflow/core/templates/README.md'));
+  add('workflow/core/templates/00-workflow-status.md', readKitFile('workflow/core/templates/00-workflow-status.md'));
+  add('workflow/core/templates/stage-document.md', readKitFile('workflow/core/templates/stage-document.md'));
+  add('workflow/core/templates/00-business-status.md', readKitFile('workflow/core/templates/00-business-status.md'));
+  add('workflow/core/templates/business-stage-document.md', readKitFile('workflow/core/templates/business-stage-document.md'));
+  add('workflow/core/templates/completion-contract.md', readKitFile('workflow/core/templates/completion-contract.md'));
+  add('workflow/core/templates/constitution.template.md', readKitFile('workflow/core/templates/constitution.template.md'));
+  add('workflow/core/templates/living-spec.md', readKitFile('workflow/core/templates/living-spec.md'));
+  add('workflow/constitution.md', readKitFile('workflow/core/templates/constitution.template.md'));
+  add('workflow/standards/README.md', makeStandardsReadme());
+  add('specs/README.md', makeSpecsReadme());
+  add('workflow/core/templates/team-profile.template.yaml', readKitFile('workflow/core/templates/team-profile.template.yaml'));
+  add('workflow/core/capabilities/README.md', readKitFile('workflow/core/capabilities/README.md'));
+  for (const name of CAPABILITY_FILES) {
+    add(`workflow/core/capabilities/${name}`, readKitFile(`workflow/core/capabilities/${name}`));
+  }
+  add('workflow/adapters/README.md', readKitFile('workflow/adapters/README.md'));
+  add('workflow/INSTALL_REPORT.md', makeInstallReport(profile, options));
+  if (profile.missing.length) add('workflow/INITIALIZATION_QUESTIONS.md', makeQuestions(profile));
+
+  for (const [id, title, description] of STAGES) {
+    const rel = `workflow/core/commands/${id}.md`;
+    add(rel, readKitFileIfExists(rel, makeCoreCommand(id, title, description)));
+  }
+
+  // AGENTS.md is the tool-neutral entry document and the full usage guide.
+  // Generate it regardless of selected tools so every adapter can point to it.
+  add('AGENTS.md', makeAgentsEntry(profile));
+  if (profile.enabledTools.includes('codex')) {
+    for (const [id] of STAGES) add(`.codex/prompts/${id}.md`, makePrompt(id));
+  }
+  if (profile.enabledTools.includes('claude')) {
+    add('CLAUDE.md', '先读取 AGENTS.md，再遵循 workflow/core 和 workflow/team-profile.yaml。.claude/commands 下的工具命令只是薄 adapter。\n');
+    for (const [id] of STAGES) add(`.claude/commands/${id}.md`, makeThinCommand('Claude Code', id));
+  }
+  if (profile.enabledTools.includes('cursor')) {
+    add('.cursor/rules/agent-workflow-core.mdc', makeCursorRule());
+    // Cursor 1.6+ supports custom slash commands from .cursor/commands/*.md.
+    for (const [id] of STAGES) add(`.cursor/commands/${id}.md`, makeThinCommand('Cursor', id));
+  }
+  if (profile.enabledTools.includes('copilot')) {
+    add('.github/copilot-instructions.md', makeGenericInstructions('GitHub Copilot'));
+  }
+  if (profile.enabledTools.includes('codebuddy')) {
+    add('.codebuddy/instructions.md', makeGenericInstructions('CodeBuddy'));
+  }
+  if (profile.enabledTools.includes('kiro')) {
+    add('.kiro/instructions.md', makeGenericInstructions('Kiro'));
+  }
+  if (profile.enabledTools.includes('trae')) {
+    add('.trae/instructions.md', makeGenericInstructions('Trae'));
+  }
+
+  return writes;
+}
+
+function readKitFile(rel) {
+  return fs.readFileSync(path.join(KIT_ROOT, rel), 'utf8');
+}
+
+function readKitFileIfExists(rel, fallback) {
+  const file = path.join(KIT_ROOT, rel);
+  return fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : fallback;
+}
+
+function writeManagedFile(file, content, options) {
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  if (fs.existsSync(file) && !options.force) {
+    const current = fs.readFileSync(file, 'utf8');
+    if (current === content) {
+      console.log(`unchanged ${path.relative(process.cwd(), file)}`);
+      return;
+    }
+    const next = file + '.agent-workflow-new';
+    fs.writeFileSync(next, content);
+    console.log(`exists ${path.relative(process.cwd(), file)} -> wrote ${path.relative(process.cwd(), next)}`);
+    return;
+  }
+  fs.writeFileSync(file, content);
+  console.log(`wrote ${path.relative(process.cwd(), file)}`);
+}
+
+function printDryRun(target, profile, writes) {
+  console.log(`Dry run 目标目录: ${target}`);
+  console.log(`已识别工具: ${profile.detectedTools.join(', ') || '(无)'}`);
+  console.log(`启用工具: ${profile.enabledTools.join(', ')}`);
+  console.log(`已识别仓库: ${profile.repos.length}`);
+  console.log(`缺失资料组: ${profile.missing.map((item) => item.key).join(', ') || '(无)'}`);
+  console.log('计划写入:');
+  for (const write of writes) console.log(`- ${path.relative(target, write.file)}`);
+}
+
+function makeTeamProfileYaml(profile) {
+  const lines = [];
+  lines.push('schema_version: "1.0"');
+  lines.push(`generated_at: "${new Date().toISOString()}"`);
+  lines.push(`generated_by: "${GENERATED_BY}"`);
+  lines.push('');
+  lines.push('team:');
+  lines.push('  name: "<TODO: 团队名称>"');
+  lines.push('  business_definition: "<TODO: 简短业务描述>"');
+  lines.push('  target_users: []');
+  lines.push('');
+  lines.push('enabled_tools:');
+  for (const tool of profile.enabledTools) lines.push(`  - ${tool}`);
+  lines.push('');
+  lines.push('detected_tools:');
+  if (profile.detectedTools.length) for (const tool of profile.detectedTools) lines.push(`  - ${tool}`);
+  else lines.push('  []');
+  lines.push('');
+  lines.push('source_materials:');
+  for (const item of REQUIRED_SOURCES) {
+    const source = profile.sources[item.key];
+    lines.push(`  ${item.key}:`);
+    lines.push(`    label: ${yamlString(item.label)}`);
+    lines.push(`    status: ${yamlString(source.status)}`);
+    lines.push('    paths:');
+    if (source.paths.length) for (const p of source.paths) lines.push(`      - ${yamlString(p)}`);
+    else lines.push('      []');
+  }
+  lines.push('');
+  lines.push('repos:');
+  if (profile.repos.length) {
+    for (const repo of profile.repos) {
+      lines.push(`  - path: ${yamlString(repo.path)}`);
+      lines.push(`    marker: ${yamlString(repo.marker)}`);
+      lines.push('    tech_stack:');
+      for (const tech of repo.tech_stack) lines.push(`      - ${yamlString(tech)}`);
+      lines.push('    family: "<TODO: 项目族分类>"');
+      lines.push('    role: "<TODO: 服务或产品角色>"');
+    }
+  } else {
+    lines.push('  []');
+  }
+  lines.push('');
+  lines.push('branch_model:');
+  lines.push('  type: "personal-prod-main-feature"');
+  lines.push('  production_branch: "prod"');
+  lines.push('  integration_branch: "main"');
+  lines.push('  feature_branch_rule: "agent may create feature/<short-name> or fix/<short-name> from prod when the target repo is personal and the working tree is clean"');
+  lines.push('  worktree_dir: "_worktrees"');
+  lines.push('');
+  lines.push('risk_policy:');
+  lines.push('  local_git_operations: "agent-allowed-after-scope-check"');
+  lines.push('  branch_creation: "agent-allowed-for-personal-repos"');
+  lines.push('  commit_tag_local_merge: "agent-allowed-after-verification"');
+  lines.push('  remote_git_operations: "explicit-user-authorization-required"');
+  lines.push('  push_and_release: "explicit-user-authorization-required"');
+  lines.push('  outbound_marketing_actions: "explicit-user-authorization-required"');
+  lines.push('  paid_ad_spend: "manual-only"');
+  lines.push('  database_writes: "manual-only"');
+  lines.push('  config_writes: "manual-only"');
+  lines.push('  high_risk_files:');
+  lines.push('    - "ci/**"');
+  lines.push('    - "cd/**"');
+  lines.push('    - "deploy/**"');
+  lines.push('    - "*.env*"');
+  lines.push('    - "application*.yml"');
+  lines.push('    - "application*.yaml"');
+  lines.push('    - "bootstrap*.yml"');
+  lines.push('    - "bootstrap*.yaml"');
+  lines.push('    - "pom.xml"');
+  lines.push('    - "package.json"');
+  lines.push('    - "lockfiles"');
+  lines.push('');
+  lines.push('workflow:');
+  lines.push('  features_dir: "features"');
+  lines.push('  business_dir: "business"');
+  lines.push('  specs_dir: "specs"');
+  lines.push('  standards_dir: "workflow/standards"');
+  lines.push('  constitution: "workflow/constitution.md"');
+  lines.push('  core_dir: "workflow/core"');
+  lines.push('  adapters_dir: "workflow/adapters"');
+  lines.push('  require_stage_gate_for_code: true');
+  lines.push('  require_feature_branch_for_code: true');
+  lines.push('  complexity_tiers: "S/M/L"');
+  lines.push('  definition_gate: "frozen-contract-with-lint-required-for-m-l; starred-mini-contract-for-s"');
+  lines.push('  done_verdict: "all-blocking-oracles-pass-or-user-waived"');
+  lines.push('  same_repo_parallel_policy: "worktree-required-after-implementation-stage"');
+  lines.push('  business_review_cadence: "weekly-metrics, monthly-strategy, quarterly-positioning"');
+  lines.push('');
+  return lines.join('\n');
+}
+
+function yamlString(value) {
+  return JSON.stringify(String(value));
+}
+
+function makeWorkflowReadme() {
+  return `# Workflow
+
+本目录由 ${GENERATED_BY} 生成，用于个人开发者项目。
+
+- \`team-profile.yaml\`: 当前个人项目或个人工作区的本地配置（事实与路径）。
+- \`constitution.md\`: 工作区宪法——跨需求不可协商的原则。
+- \`standards/\`: 从既有代码库提取的个人规范层。
+- \`core/\`: 工具无关的工作流规则、命令、模板和能力。
+- \`adapters/\`: 支持工具的 adapter 说明。
+- \`INITIALIZATION_QUESTIONS.md\`: 缺少必要本地资料时生成的问题清单。
+
+研发轨判定核心是《完成合同》（\`features/<feature>/00-完成合同.md\`）：\`/定义完成\` 编译并冻结合同，宣布完成 = blocking Oracle 全 PASS；工作区级 \`specs/\` 沉淀已发布行为的 living specs。
+
+默认使用简体中文展示工作流沟通、阶段产物、状态摘要、审查结论、测试记录、发布记录和复盘；专有名词、产品名、代码标识符、命令、文件路径、分支名、API、SDK、框架、协议、标准、错误信息和官方英文术语保留原文。
+
+工作流分两条轨道：研发轨阶段产物放在工作区级 \`features/<feature>/\` 下，商业化轨（业务定位、商业模式、PMF、渠道与营销策略）阶段产物放在工作区级 \`business/<product>/\` 下，都不写入目标代码仓库。目标代码仓库只保留源码、代码相关配置、运行或构建必需资产，以及最小必要的代码侧 \`README\` 内容。
+
+商业化轨只产出文档和清单：对外发布内容、投放广告、cold outreach、联系合作方需要用户明确授权或自行执行；营销工程需求（landing page、SEO 页面、埋点）通过 \`/new-feature\` 回流研发轨。
+
+\`/02B-UI设计\` 是前端实现的设计闸门；个人小改动可以记录范围有限的设计豁免，但必须说明影响面和补齐计划。
+
+个人工作流允许 agent 在明确任务范围内执行本地 git 分支命名、创建、commit、tag 和本地 merge。远程 push、GitHub release、商店发布、部署和生产配置写入需要用户明确授权。
+
+不要把凭证、真实客户秘密或私有 URL 写入通用 core 文件。项目知识应保留在 \`team-profile.yaml\`、\`features/<feature>/\` 或本地资料中。
+`;
+}
+
+function makeStandardsReadme() {
+  return `# 个人规范层（standards）
+
+本目录存放**从既有代码库提取的可复用规范**：命名、目录结构、错误处理、依赖选型、提交信息等模式。原则放 \`workflow/constitution.md\`，事实与路径放 \`workflow/team-profile.yaml\`，本目录只放"怎么写代码"的规范。
+
+- 来源：\`/03-技术架构\` 阶段从现有代码中提取；\`/10-复盘总结\` 沉淀新规则。
+- 用法：\`/定义完成\` 的影响边界、\`/04\` 实现和 \`/05\` 审查都以本目录为基准；已有规范直接引用，不重复发明。
+- 格式：每个主题一个 Markdown 文件（例：\`naming.md\`、\`error-handling.md\`），写清规则、正例、反例和适用范围。
+- 空目录是正常状态：规范应随真实需求逐步沉淀，不要一次性凭空编写。
+`;
+}
+
+function makeSpecsReadme() {
+  return `# Living Specs（行为真相层）
+
+本目录存放**当前已实现并已发布**的行为规格，是存量项目（brownfield）需求定义的起点。
+
+- 与 \`features/\` 的关系：features 是变更流水（做过什么），specs 是当前状态（现在是什么）。
+- 读：\`/01-需求讨论\`、\`/定义完成\`、\`/06-测试用例\`（回归范围）、\`/一致性检查\` 都先读本目录；触碰已有行为的需求必须显式声明改变哪几条行为编号。
+- 写：只有 \`/10-复盘总结\` 在发布后把已验证的行为增量合并进来；未发布的计划不进本目录。
+- 格式：每个领域/模块一个文件，按 \`workflow/core/templates/living-spec.md\` 组织（EARS 句式行为清单 + 数据模型 + 对外契约 + 边界）。
+- 空目录是正常状态：首个需求发布后开始沉淀。
+`;
+}
+
+function makeInstallReport(profile, options) {
+  return `# 安装报告
+
+- 生成器: ${GENERATED_BY}
+- 生成时间: ${new Date().toISOString()}
+- 启用工具: ${profile.enabledTools.join(', ')}
+- 已识别工具: ${profile.detectedTools.join(', ') || '(无)'}
+- 已识别仓库: ${profile.repos.length}
+- 强制覆盖: ${options.force ? '是' : '否'}
+- 升级模式: ${options.upgrade ? '是' : '否'}
+
+## 缺失资料组
+
+${profile.missing.length ? profile.missing.map((item) => `- ${item.label} (${item.key})`).join('\n') : '- 无'}
+
+## 安全边界
+
+初始化器没有执行远程 Git 命令、创建分支、push 代码、触发构建 / 部署任务，也没有执行数据库写入。
+`;
+}
+
+function makeQuestions(profile) {
+  return `# 初始化待补资料
+
+初始化器未找到全部必要本地资料。请补充路径后重新运行初始化器，或手动更新 \`workflow/team-profile.yaml\`。
+
+${profile.missing.map((item) => `## ${item.label}\n\n${item.question}\n\n- path: <TODO>\n`).join('\n')}
+`;
+}
+
+function makeCoreCommand(id, title, description) {
+  const codeStage = id === '04-代码实现' || id === '04A-前端代码实现' || id === '04B-后端代码实现';
+  const reviewStage = id === '05-代码审查';
+  const prepStage = id === '03-06-研发准备';
+  const businessStage = id === 'new-product' || /^B\d/.test(id);
+  const containerDir = businessStage ? 'business/{product}' : 'features/{feature}';
+  const statusFile = businessStage ? '00-商业化状态.md' : '00-工作流状态.md';
+  return `# /${id}
+
+## 目标
+
+${title}: ${description}
+
+## 必要输入
+
+- \`AGENTS.md\`
+- \`workflow/team-profile.yaml\`
+- \`workflow/constitution.md\`
+- \`${containerDir}/\` 下的前序阶段文档
+- team-profile 中登记的本地代码、本地文档和用户提供资料
+
+## 执行规则
+
+- 先读取本地事实，再写结论。
+- 区分已验证事实、设计意图、假设和缺失证据。
+- 未真实执行的测试、构建、截图、部署或审查，不得写成已通过。
+- 个人项目允许 agent 在范围明确且工作树已检查后执行本地分支命名、创建、commit、tag 和本地 merge；远程 push、release、部署、数据库写入和生产配置写入需要用户明确授权。
+${codeStage ? '- 只有功能分支闸门、实现阶段闸门和同仓并行闸门全部通过后，才允许修改业务代码。' : '- 本阶段不授权修改业务代码；除非当前命令是实现命令且所有闸门已通过。'}
+${prepStage ? '- 本编排命令只准备 03 到 06 文档，不授权代码实现。' : ''}
+${businessStage ? '- 商业化结论必须做证据分级（一手/二手/推断）并注明来源和日期，不得编造市场数据；对外发布、投放和 outreach 需要用户明确授权；营销工程需求通过 /new-feature 回流研发轨。' : ''}
+${reviewStage ? '- 审查输出以问题优先，按严重级别排序，并引用文件、diff、测试或运行证据。' : ''}
+
+## 必要输出
+
+- 更新或创建 \`${containerDir}/\` 下对应阶段文件。
+- 阶段状态变化时更新 \`${containerDir}/${statusFile}\`。
+- 明确记录未解决问题和证据缺口。
+`;
+}
+
+function makeCommandTable() {
+  const header = '| 命令 | 阶段 | 作用 |\n| --- | --- | --- |';
+  const rows = STAGES.map(
+    ([id, title, description]) => `| \`/${id}\` | ${title} | ${description} |`
+  );
+  return [header, ...rows].join('\n');
+}
+
+function makeToolUsage(profile) {
+  const tools = profile.enabledTools;
+  const blocks = [];
+
+  if (tools.includes('claude')) {
+    blocks.push(`### Claude Code
+
+- 阶段命令来自 \`.claude/commands/\`，可直接输入，例如 \`/04-代码实现 <feature>\`。
+- 多文件或复杂改动先进入 plan mode，再执行。
+- 每个命令文件都是薄 adapter，最终都指向 \`workflow/core/commands/\`。`);
+  }
+
+  if (tools.includes('codex')) {
+    blocks.push(`### Codex
+
+- Codex 会自动读取本 \`AGENTS.md\`。
+- 阶段 prompt 位于 \`.codex/prompts/\`。可以调用阶段 prompt，或要求 Codex 按 \`workflow/core/commands/<stage>.md\` 执行。`);
+  }
+
+  if (tools.includes('cursor')) {
+    blocks.push(`### Cursor
+
+- 本 kit 会在 \`.cursor/commands/\` 生成 Cursor 自定义斜杠命令（Cursor 1.6+）。在 Agent 输入框输入 \`/\`，选择 \`/04-代码实现\` 等阶段，再描述功能。
+- \`.cursor/rules/agent-workflow-core.mdc\` 会自动应用到每次请求。
+- 兜底方式：直接 @ 阶段契约，例如 \`@workflow/core/commands/04-代码实现.md\`。
+- agent 会读取阶段契约、\`workflow/team-profile.yaml\` 和前序 \`features/<feature>/\` 文档，再写阶段产物。
+- 硬闸门仍然生效：实现必须先通过功能分支闸门和阶段闸门。`);
+  }
+
+  if (tools.includes('copilot')) {
+    blocks.push(`### GitHub Copilot
+
+- \`.github/copilot-instructions.md\` 会自动生效。
+- 执行阶段时，在 chat 中引用 \`workflow/core/commands/<stage>.md\` 并描述功能。`);
+  }
+
+  for (const [tool, label] of [['codebuddy', 'CodeBuddy'], ['kiro', 'Kiro'], ['trae', 'Trae']]) {
+    if (tools.includes(tool)) {
+      blocks.push(`### ${label}
+
+- \`.${tool}/instructions.md\` 会自动生效。
+- 执行阶段时，在 chat 中引用 \`workflow/core/commands/<stage>.md\` 并描述功能。`);
+    }
+  }
+
+  if (!blocks.length) {
+    blocks.push(`未选择特定工具 adapter。请直接读取并执行 \`workflow/core/commands/<stage>.md\`。`);
+  }
+
+  return blocks.join('\n\n');
+}
+
+function makeAgentsEntry(profile) {
+  return `# Agent Workflow
+
+本工作区使用 ${GENERATED_BY} 生成的工具无关个人开发者 agent 工作流。它包含两条共享同一套闸门口径的轨道：研发轨把一个需求从澄清、完成合同冻结推进到实现、发布和复盘；商业化轨把一个产品从业务定位、商业模式、PMF 验证推进到渠道策略、预算和策略复盘。判定核心是《完成合同》：宣布完成 = blocking Oracle 全 PASS 的机器判定，不是"感觉做完了"。不同 AI 工具共享同一套 workflow core，每个工具只生成薄 adapter；体验会随工具能力增强或降级，但流程口径一致。
+
+## 快速开始
+
+1. 先读取 \`workflow/team-profile.yaml\`（事实与路径）、\`workflow/constitution.md\`（不可协商原则）；存量项目再读工作区级 \`specs/\`（已实现行为真相）。
+2. 研发轨：用 \`/new-feature <name>\` 初始化需求并完成 S/M/L 复杂度分级。M/L 档推荐顺序：\`/01-需求讨论\` ->（\`/澄清\`）-> \`/02-产品文档\` -> \`/02B-UI设计\` -> \`/03-技术架构\` -> \`/06-测试用例\` -> \`/定义完成\`（编译完成合同，Definition Lint 通过后经用户确认冻结）-> \`/一致性检查\` -> \`/交付至完成\`（或手动 \`/04-代码实现\` -> \`/05-代码审查\` -> \`/07-测试执行\`）-> \`/08-发布准备\` -> \`/09-发布执行\` -> \`/10-复盘总结\`。S 档压缩为：\`/定义完成\`（迷你合同）-> 实现 -> 验证。
+3. 商业化轨：用 \`/new-product <name>\` 初始化产品商业化容器 \`business/<name>/\`；首次可用 \`/B1-B8-商业化准备\` 一次性串联生成 \`/B1-业务定位\` -> \`/B2-商业模式\` -> \`/B3-PMF与客户画像\` -> \`/B4-场景与购买旅程\` -> \`/B5-渠道漏斗映射\` -> \`/B6-营销获客策略\` -> \`/B7-营销预算\` -> \`/B8-渠道执行策略\`；上线后按周期执行 \`/B9-策略复盘\`。
+4. 两轨衔接：\`/01\`、\`/02\` 读取商业化基线（定位、ICP、场景、商业模式），完成合同记录北极星挂钩；\`/08\`、\`/09\` 对照 B5/B8 准备发布营销材料和分发清单；\`/10\` 的增长信号回流 \`/B9\`，行为增量回写 \`specs/\`；B8 的营销工程需求（landing、SEO 页面、埋点）通过 \`/new-feature\` 进入研发轨。
+5. 每个阶段都必须读取所在容器（\`features/<name>/\` 或 \`business/<name>/\`）下的前序文档，并把本阶段产物写回同目录。
+6. 随时可执行 \`/workflow-status\` 汇总两轨全部需求和产品的阶段、合同与 Oracle 进度、阻塞和下一步。
+
+不同工具触发阶段的方式不同，见下方“工具使用方式”。
+
+## 工作流命令
+
+${makeCommandTable()}
+
+## 任务描述模板
+
+启动阶段时，尽量用三段描述任务，保证 agent 有足够上下文：
+
+- **目标**：完成后必须达成什么。
+- **约束**：哪些内容不能改，例如公开 API、数据库结构、鉴权链路、无关模块。
+- **验收**：如何证明正确，例如测试、脚本、API 调用、浏览器检查、截图。
+
+## 单一事实源
+
+- 工作流规则：\`workflow/core/\`
+- 工作区配置（事实与路径）：\`workflow/team-profile.yaml\`
+- 工作区宪法（不可协商原则）：\`workflow/constitution.md\`
+- 个人规范层：\`workflow/standards/\`
+- 行为真相层（living specs）：工作区级 \`specs/\`
+- 可复用检查能力：\`workflow/core/capabilities/\`
+- 需求产物与完成合同：工作区级 \`features/<feature>/\`（合同为 \`00-完成合同.md\`）
+- 商业化产物：工作区级 \`business/<product>/\`
+- 工具 adapter：仅作为生成的薄入口
+
+## 硬闸门
+
+- 产品和工作流文档默认与代码仓库分开；如果个人项目需要公开 \`README\`、\`CHANGELOG\`、release notes、商店文案或隐私政策，可以在发布阶段明确记录为代码侧/公开侧材料。
+- 功能分支闸门和实现阶段闸门通过前，禁止修改业务代码。
+- \`/02B-UI设计\` 是前端实现的设计闸门；\`/04A-前端代码实现\` 必须读取并遵循工作区级 \`features/<feature>/02B-UI设计.md\`，缺失时先补齐 02B，除非用户明确给出范围有限的设计豁免。
+- \`/03-06-研发准备\` 以及 01/02/02B/03 阶段只授权分析和工作流文档。
+- 个人项目允许 agent 在目标仓库工作树干净、范围明确、测试计划明确时执行本地分支命名、创建、commit、tag 和本地 merge。
+- 远程 push、GitHub release、商店发布、部署、数据库写入、生产配置写入和公开发布动作必须有用户明确授权。
+- 同仓多需求进入实现阶段后，必须使用独立 worktree。
+- 商业化轨（\`/new-product\`、\`/B1\` 到 \`/B9\`）只产出文档和清单：对外发布内容、投放广告、发送 cold email、联系 influencer 或合作伙伴必须有用户明确授权或由用户自行执行；付费投放支出由用户手动执行。
+- 商业化结论必须做证据分级（一手/二手/推断）并注明来源和日期，不得编造市场数据、用户评价或竞品价格。
+- 营销工程需求（landing page、SEO 页面、埋点、A/B 测试）必须通过 \`/new-feature\` 进入研发轨并遵守其全部闸门，不在 B 阶段直接修改代码。
+- **完成合同闸门**：M/L 档需求进入实现（\`/04\` 或 \`/交付至完成\`）前，\`features/<feature>/00-完成合同.md\` 必须已冻结且 Definition Lint 通过；S 档必须有 ★ 必填节完整的迷你合同。冻结需用户明确确认。
+- **合同不可静默修改**：冻结后的标准、阈值、blocking 标记只能走修订记录并经用户再次确认；改测试换通过按高危问题处理。
+- **完成判定**：宣布完成 = blocking Oracle 全部 PASS（或用户书面确认 WAIVED）；Oracle 状态只能由 \`/交付至完成\` 或 \`/07-测试执行\` 翻转且必须附证据；PASS 后代码再变更置 STALE 必须复验。
+- \`workflow/constitution.md\` 在所有阶段不可协商；与需求冲突时先经用户确认修订宪法，不得绕过。
+
+## 工具能力策略
+
+workflow core 是共享的。工具 adapter 可按当前工具能力增强或降级：
+
+- L0：文档规则
+- L1：prompt 和命令模板
+- L2：工具原生规则或 slash commands
+- L3：hooks 或前置检查
+- L4：subagents 或多 agent 路由
+
+不要承诺所有工具体验完全一致。只能使用当前工具自己的 adapter。
+
+## 工具使用方式
+
+${makeToolUsage(profile)}
+
+## 已启用工具
+
+${profile.enabledTools.map((tool) => `- ${tool}`).join('\n')}
+
+## 参考文件
+
+- \`workflow/README.md\`：工作流总览。
+- \`workflow/core/commands/\`：各阶段契约。
+- \`workflow/core/capabilities/README.md\`：可复用检查能力及工具适配方式。
+- \`workflow/core/templates/completion-contract.md\`：完成合同模板（可用 \`openone-workflow-check-contract\` 校验结构）。
+- \`workflow/constitution.md\`：工作区宪法；\`workflow/standards/\`：个人规范层；\`specs/\`：living specs。
+- \`workflow/team-profile.yaml\`：当前工作区配置和资料扫描结果。
+
+## 开始
+
+先读取 \`workflow/team-profile.yaml\`，再按用户请求的阶段读取 \`workflow/core/commands/\`。
+`;
+}
+
+function makeThinCommand(toolName, id) {
+  return `# ${toolName} adapter for /${id}
+
+这是薄 adapter。执行时必须按顺序读取：
+
+1. \`AGENTS.md\`
+2. \`workflow/team-profile.yaml\`
+3. \`workflow/core/commands/${id}.md\`
+
+不得加入与 workflow/core 冲突的工具特定行为。
+`;
+}
+
+function makePrompt(id) {
+  return `# ${id}
+
+读取 \`AGENTS.md\`、\`workflow/team-profile.yaml\` 和 \`workflow/core/commands/${id}.md\`。
+
+优先使用本地证据。必要资料缺失时，更新 \`workflow/INITIALIZATION_QUESTIONS.md\` 或向用户索要缺失路径。
+`;
+}
+
+function makeCursorRule() {
+  return `---
+description: "个人开发者 agent 工作流：分阶段交付、审查、测试、发布和复盘。"
+alwaysApply: true
+---
+
+# Agent Workflow (Cursor)
+
+本工作区使用工具无关的分阶段工作流。本规则会自动应用到每次请求。
+完整使用说明见 \`AGENTS.md\`。
+
+## 在 Cursor 中执行阶段
+
+本 kit 会在 \`.cursor/commands/\` 生成 Cursor 自定义 slash commands（Cursor 1.6+）。
+在 Agent 输入框输入 \`/\`，选择阶段，再描述功能。例如：
+
+- \`/01-需求讨论\` 开始一个新需求
+- \`/04-代码实现\` 对指定需求进入实现阶段
+
+兜底方式：可以直接 @ 阶段契约，例如
+\`@workflow/core/commands/04-代码实现.md\`.
+
+agent 随后读取阶段契约、\`workflow/team-profile.yaml\` 和前序
+\`features/<feature>/\` 文档，并把阶段产物写入 \`features/<feature>/\`。
+
+## 阶段顺序
+
+研发轨（M/L 档）：
+new-feature（S/M/L 分级）-> 01-需求讨论 ->（澄清）-> 02-产品文档 -> 02B-UI设计 -> 03-技术架构 ->
+06-测试用例 -> 定义完成（冻结完成合同）-> 一致性检查 -> 交付至完成（或 04 -> 05 -> 07）->
+08-发布准备 -> 09-发布执行 -> 10-复盘总结；S 档：定义完成（迷你合同）-> 实现 -> 验证
+
+商业化轨：
+new-product -> B1-业务定位 -> B2-商业模式 -> B3-PMF与客户画像 -> B4-场景与购买旅程 ->
+B5-渠道漏斗映射 -> B6-营销获客策略 -> B7-营销预算 -> B8-渠道执行策略 -> B9-策略复盘（周期执行）
+
+查看全部需求和产品状态时，执行 \`workflow/core/commands/workflow-status.md\`。
+
+## 任务描述
+
+每个任务尽量写清目标、约束和验收方式。
+
+## 事实源
+
+- 工作流规则：\`workflow/core/\`
+- 工作区配置：\`workflow/team-profile.yaml\`
+- 可复用检查能力：\`workflow/core/capabilities/\`
+- 完整使用说明：\`AGENTS.md\`
+
+## 硬闸门
+
+- 功能分支闸门和实现阶段闸门通过前，禁止修改业务代码。
+- M/L 档需求进入实现前，完成合同必须已冻结且 Definition Lint 通过；宣布完成 = blocking Oracle 全 PASS。
+- 有 UI 或前端工作的需求必须先完成 \`/02B-UI设计\`，\`/04A-前端代码实现\` 必须遵循对应设计基线。
+- 本地分支命名、创建、commit、tag 和本地 merge 可由 agent 在个人项目中执行；远程 push、release、部署、数据库写入和生产配置写入需要用户明确授权。
+- 同仓并行实现进入实现阶段后必须使用独立 worktree。
+- 商业化轨（B1-B9）只产出文档；对外发布、投放和 outreach 需用户明确授权，营销工程需求通过 \`/new-feature\` 回流研发轨。
+`;
+}
+
+function makeGenericInstructions(toolName) {
+  return `# ${toolName} 工作流说明
+
+先读取 AGENTS.md，再按用户请求的阶段读取 workflow/team-profile.yaml 和 workflow/core/commands。
+
+本文件是薄 adapter，不得覆盖 workflow/core 的硬闸门。
+`;
+}