@whyshu/argent-engine 0.0.0-stage → 0.6.0

package/engine/scripts/validate-preset-schema.mjs

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+/**
+ * validate-preset-schema.mjs — 校验 preset 行配置与插件配置 schema 的一致性
+ *
+ * 由来（2026-09-10 事故）：`@deepseek-ai/dsh-persona` 的 Config 里 `prefix` 必填，
+ * 而阿根廷 14 个 preset 把 persona 文本写在 `text:` 下 ⇒ 该行**从未真正挂载**。
+ * 旧版 dsh 容忍 preset 挂载失败（静默），0.1.5 起挂载失败会让 session resume 直接失败，
+ * 才暴露出来。本脚本把"行 × schema 必填键"的核对固化为门禁。
+ *
+ * 判据：
+ *   1. 缺必填键 —— 若**官方 standard preset 的同名行同样未给**该键，视为"加载期注入"→ 豁免（仅提示）；
+ *      否则判失败（hard）。
+ *   2. 未知键（schema 里没有的键）—— 同样按官方行对照豁免，否则只警告（zod 默认剥离未知键，不必然报错）。
+ *
+ * 用法：
+ *   node scripts/validate-preset-schema.mjs                 # 校验仓库 presets/
+ *   node scripts/validate-preset-schema.mjs --runtime       # 追加校验 ~/.dsh/.agent-presets/
+ *   node scripts/validate-preset-schema.mjs --json          # 机器可读输出
+ * 退出码：0 全部通过；1 存在 hard 失败。
+ */
+import { readFileSync, existsSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { homedir } from 'node:os'
+import { requireDshScope } from './lib/dsh-scope.mjs'
+import { MECHANISM, detectPresetMechanism, mechanismNote } from './lib/preset-mechanism.mjs'
+import { REQUIRED_KEY_DEFAULTS } from './lib/preset-compat.mjs'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const REPO = join(__dirname, '..')
+// 2026-09-28：env 覆盖之外再补自动探测（客户机没设 DSH_SCOPE 时不再假红）。
+// 0.6.0 F1 修复批（2026-10-14）：preset 机制判的是**宿主树**（`detectPresetMechanism(SCOPE)`）⇒
+// 拿不到 scope 就是**探测失败**（≠"没有 preset"）⇒ 响亮失败，⛔ 不用假路径把机制静默判成 unknown。
+let SCOPE
+try { SCOPE = requireDshScope({ what: 'preset schema 门禁（validate-preset-schema）' }) }
+catch (e) { console.error(`  ❌ ${e.message}`); process.exit(1) }
+const PROFILE_NM = join(homedir(), '.dsh', 'profiles', 'node_modules')
+// 官方参考 preset 的**位置随版本变化**（2026-09-28）：
+//   0.1.5：`dsh-agent-presets/presets/standard/agent.cordis.yml`（目录式）
+//   0.1.7：`dsh-web-app/presets/standard.patch.yml`（行式；dsh-agent-presets 已删除）
+const OFFICIAL_015 = join(SCOPE, 'dsh-agent-presets', 'presets', 'standard', 'agent.cordis.yml')
+const OFFICIAL_017 = join(SCOPE, 'dsh-web-app', 'presets', 'standard.patch.yml')
+const OFFICIAL = existsSync(OFFICIAL_015) ? OFFICIAL_015 : (existsSync(OFFICIAL_017) ? OFFICIAL_017 : OFFICIAL_015)
+const MECHANISM_NOW = detectPresetMechanism(SCOPE)
+const RUNTIME_PRESETS = join(homedir(), '.dsh', '.agent-presets')
+/** 行式产物（生成器输出）：也要校验——它才是 0.1.7 上真正被加载的那份。 */
+const ROWS_BUNDLE = join(REPO, 'plugins', 'argent-presets')
+
+const argv = process.argv.slice(2)
+const asJson = argv.includes('--json')
+const withRuntime = argv.includes('--runtime')
+const explicitDirs = argv.filter((a) => !a.startsWith('--'))
+
+const roots = explicitDirs.length
+  ? explicitDirs
+  : [join(REPO, 'presets'), ...(withRuntime ? [RUNTIME_PRESETS] : [])]
+
+/** 从行式 patch 文件里抽出 `config.plugins` 子行（去掉 10 空格前缀），交给同一个解析器。 */
+function rowsFromPatch(file) {
+  const text = readFileSync(file, 'utf8')
+  const i = text.indexOf('        plugins:\n')
+  if (i === -1) return []
+  const body = text.slice(i + '        plugins:\n'.length).split('\n')
+    .map((l) => (l.startsWith(' '.repeat(10)) ? l.slice(10) : l))
+    .join('\n')
+  const tmp = `${file}.rows.tmp`
+  writeFileSync(tmp, body)
+  try { return parseRows(tmp) } finally { rmSync(tmp, { force: true }) }
+}
+
+// ── 解析：preset 文件 → 行 [{id, name, keys}] ─────────────────────────────
+function parseRows(file) {
+  const lines = readFileSync(file, 'utf8').split('\n')
+  const rows = []
+  let cur = null
+  for (const raw of lines) {
+    const s = raw.trim()
+    if (s.startsWith('- id:')) {
+      if (cur) rows.push(cur)
+      cur = { id: s.slice(5).trim().replace(/^['"]|['"]$/g, ''), name: null, keys: [], inCfg: false }
+      continue
+    }
+    if (!cur) continue
+    if (s.startsWith('name:') && cur.name === null) {
+      cur.name = s.slice(5).trim().replace(/^['"]|['"]$/g, '')
+    } else if (/^config:\s*$/.test(s)) {
+      cur.inCfg = true
+    } else if (cur.inCfg && /^[A-Za-z_][\w]*:/.test(s)) {
+      cur.keys.push(s.split(':')[0])
+    } else if (cur.inCfg && s && !raw.startsWith(' ') && !raw.startsWith('\t')) {
+      cur.inCfg = false
+    }
+  }
+  if (cur) rows.push(cur)
+  return rows.filter((r) => r.name)
+}
+
+// ── 解析：包的 `const Config = z.object({...})` → { 必填键[], 全部键[] } ──
+function schemaOf(pkg) {
+  const dir = [join(SCOPE, pkg.replace('@deepseek-ai/', '')), join(PROFILE_NM, pkg.replace('@deepseek-ai/', ''))]
+    .find((d) => existsSync(d))
+  if (!dir) return null
+  const entry = join(dir, 'lib', 'index.js')
+  if (!existsSync(entry)) return null
+  const src = readFileSync(entry, 'utf8')
+  const m = /const Config = z\.object\(\{/.exec(src)
+  if (!m) return { all: [], required: [] }
+  let depth = 0
+  let j = m.index + m[0].length - 1
+  const start = j
+  for (; j < src.length; j++) {
+    if (src[j] === '{') depth++
+    else if (src[j] === '}') {
+      depth--
+      if (depth === 0) { j++; break }
+    }
+  }
+  const body = src.slice(start, j)
+  const all = []
+  const required = []
+  for (const km of body.matchAll(/\n\t([A-Za-z_][\w]*):\s*([^\n]*)/g)) {
+    all.push(km[1])
+    if (!/\.default\(|\.optional\(\)/.test(km[2])) required.push(km[1])
+  }
+  return { all, required }
+}
+
+// ── 官方 standard preset 的同名行（豁免基准）──────────────────────────────
+const official = existsSync(OFFICIAL) ? parseRows(OFFICIAL) : []
+const officialByPkg = new Map()
+// 官方参考：目录式读 agent.cordis.yml；行式读 patch 文件（抽 plugins 子行）
+if (MECHANISM_NOW === MECHANISM.ROWS && existsSync(OFFICIAL_017)) {
+  for (const r of rowsFromPatch(OFFICIAL_017)) {
+    if (!r.keys.length || !r.name) continue
+    if (!officialByPkg.has(r.name)) officialByPkg.set(r.name, [])
+    officialByPkg.get(r.name).push(r)
+  }
+}
+for (const r of official) {
+  if (!officialByPkg.has(r.name)) officialByPkg.set(r.name, [])
+  officialByPkg.get(r.name).push(r)
+}
+
+const findings = []
+let checkedRows = 0
+let checkedFiles = 0
+
+// 说明（2026-09-28）：**不再**对生成的 patch 文件做二次 schema 解析 —— 嵌套行列表解析容易
+// 串行（实测报出 "未知键 undefined"）。产物的正确性由两条更强的判据保证：
+//   ① 生成器保证"与作者格式逐行等价"（preset-mechanism.test.mjs 断言）；
+//   ② 0.1.7 隔离试跑真挂载 13/13（注册表 broken 诊断会点名任何行问题）。
+
+for (const root of roots) {
+  if (!existsSync(root)) continue
+  const dirs = readdirSync(root).filter((d) => {
+    try { return statSync(join(root, d)).isDirectory() } catch { return false }
+  })
+  for (const d of dirs) {
+    const file = join(root, d, 'agent.cordis.yml')
+    if (!existsSync(file)) continue
+    checkedFiles++
+    for (const row of parseRows(file)) {
+      if (!row.keys.length) continue
+      const schema = schemaOf(row.name)
+      if (!schema) continue
+      checkedRows++
+      const offRows = officialByPkg.get(row.name) || []
+      const offKeys = new Set(offRows.flatMap((r) => r.keys))
+      for (const k of schema.required) {
+        if (row.keys.includes(k)) continue
+        // 兼容层会在**生成行式产物时**补齐的键：作者格式缺它不算失败，但如实说明（附官方出处）。
+        // 0.1.5（客户机/作者格式实际生效的版本）上这些键本就不必填，故不影响现网判定。
+        const auto = (REQUIRED_KEY_DEFAULTS[row.name] || {})[k]
+        if (auto) {
+          findings.push({ level: 'info', preset: d, id: row.id, pkg: row.name, kind: 'auto-filled', key: k,
+            note: `兼容层生成时补 ${auto.value}（出处：${auto.source}）` })
+          continue
+        }
+        const exempt = offRows.length > 0 && !offKeys.has(k)   // 官方同样未给 → 加载期注入
+        findings.push({ level: exempt ? 'info' : 'fail', preset: d, id: row.id, pkg: row.name, kind: 'missing-required', key: k, exempt })
+      }
+      for (const k of row.keys) {
+        if (schema.all.includes(k)) continue
+        const exempt = offKeys.has(k)
+        findings.push({ level: exempt ? 'info' : 'warn', preset: d, id: row.id, pkg: row.name, kind: 'unknown-key', key: k, exempt })
+      }
+    }
+  }
+}
+
+const fails = findings.filter((f) => f.level === 'fail')
+const warns = findings.filter((f) => f.level === 'warn')
+
+if (asJson) {
+  console.log(JSON.stringify({ files: checkedFiles, rows: checkedRows, fails, warns, findings }, null, 2))
+} else {
+  const verbose = argv.includes('--verbose')
+  console.log(`preset-schema 校验：${checkedFiles} 个 preset 文件 / ${checkedRows} 个带 config 的行`)
+  for (const f of (verbose ? findings : findings.filter((x) => x.level !== 'info'))) {
+    const tag = f.level === 'fail' ? '❌' : f.level === 'warn' ? '⚠️ ' : 'ℹ️ '
+    console.log(`  ${tag} ${f.preset} :: ${f.id} (${f.pkg}) ${f.kind === 'missing-required' ? '缺必填键' : '未知键'} ${f.key}${f.level === 'info' ? '（官方同样未给 → 加载期注入，豁免）' : ''}`)
+  }
+  const infos = findings.filter((f) => f.level === 'info')
+  if (!findings.length) console.log('  ✅ 未发现问题')
+  else if (!verbose && infos.length) console.log(`  ℹ️  另有 ${infos.length} 项按官方 preset 对照豁免（加载期注入；--verbose 查看）`)
+  console.log(`\n结果: ${fails.length ? `❌ FAIL ${fails.length} 项` : '✅ PASS'}${warns.length ? `（另有 ${warns.length} 项警告）` : ''}`)
+}
+process.exit(fails.length ? 1 : 0)

package/engine/scripts/vertical-init.mjs

@@ -0,0 +1,323 @@
+#!/usr/bin/env node
+/**
+ * vertical-init —— 业务线脚手架（P1，2026-09-29）
+ *
+ * 目标：**不看引擎源码就能开一条新业务线**。生成物必须一次通过 `vertical-lint.mjs`
+ * （脚手架与门禁同源同规矩，见测试 `scripts/tests/vertical-lint.test.mjs`：
+ * 它对生成结果直接跑 lint —— 脚手架自己不合格就别指望别人合格）。
+ *
+ * 生成的骨架默认是**安全态**：`trigger.wake = off`（不唤醒角色）、`mode = shadow`（不真实写入）、
+ * 流程门内判据留 TODO。要把一条线跑起来，按生成文件里的注释逐项填。
+ *
+ * 用法：
+ *   node scripts/vertical-init.mjs --id customer-order --title "客单系统" \
+ *        [--flow intake] [--role clerk] [--skill intake] \
+ *        [--from-preset argent-general] [--root <dir>] [--force]
+ */
+import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const DEFAULT_ROOT = join(HERE, '..')
+const argOf = (name, dflt = null) => {
+  const i = process.argv.indexOf(name)
+  return i > -1 ? process.argv[i + 1] ?? dflt : dflt
+}
+
+const ROOT = argOf('--root', DEFAULT_ROOT)
+const ID = argOf('--id')
+const TITLE = argOf('--title')
+const FLOW = argOf('--flow', 'main')
+const ROLE = argOf('--role', 'clerk')
+const SKILL = argOf('--skill', FLOW)
+const FROM_PRESET = argOf('--from-preset', 'argent-general')
+const FORCE = process.argv.includes('--force')
+const ID_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/
+
+const die = (m) => { console.error(`✗ ${m}`); process.exit(2) }
+if (!ID) die('必须给 --id（小写 kebab-case，如 customer-order）')
+if (!ID_RE.test(ID)) die(`--id 不合法：${ID}（只允许小写字母/数字/连字符）`)
+for (const [k, v] of [['--flow', FLOW], ['--role', ROLE], ['--skill', SKILL]]) {
+  if (!ID_RE.test(v)) die(`${k} 不合法：${v}（只允许小写字母/数字/连字符）`)
+}
+const VDIR = join(ROOT, 'verticals', ID)
+if (existsSync(VDIR) && !FORCE) die(`业务线已存在：verticals/${ID}/（要覆盖加 --force）`)
+
+const roleId = `argent-${ID}-${ROLE}`
+const flowId = `${ID}.${FLOW}`
+const skillId = `${ID}-${SKILL}`
+const capId = `${ID}.${FLOW}`
+const pauseSwitch = `verticals/${ID}/PAUSE.${FLOW}`
+const envFile = `verticals/${ID}/env/example.env`
+const promptTpl = `verticals/${ID}/prompts/${FLOW}.md`
+
+const written = []
+const put = (rel, content) => {
+  const p = join(VDIR, rel)
+  mkdirSync(dirname(p), { recursive: true })
+  writeFileSync(p, content)
+  written.push(`verticals/${ID}/${rel}`)
+}
+
+// ── manifest ────────────────────────────────────────────────────
+put('manifest.json', JSON.stringify({
+  id: ID,
+  version: '0.1.0',
+  title: TITLE || ID,
+  _note: '业务线元数据（唯一真源）。requires 声明可用的 argent/dsh 区间；verifiedOn 记录**已实测**过的版本（装机时据此判断能否装到目标机器）。',
+  requires: { argent: '>=0.2 <0.3', dsh: '>=0.1.5 <0.2' },
+  verifiedOn: { argent: [], dsh: [] },
+  ports: {
+    _note: '该线用到哪些底座端口（实现名见 verticals/README.md）。新增实现时同步更新 vertical-lint 的 KNOWN_PORTS。',
+    source: 'feishu-base',
+    transport: 'feishu',
+    notify: 'feishu-card',
+    actor: 'none',
+    identity: 'env',
+  },
+  capabilities: [{ id: capId, minPlan: 'pro', title: `${TITLE || ID} · ${FLOW}` }],
+  roles: [roleId],
+  skills: [skillId],
+  flows: [flowId],
+  billing: 'billing.json',
+  preflight: 'preflight.py',
+}, null, 2) + '\n')
+
+// ── flows（局部 id，合并后 = <id>.<flow>）────────────────────────
+put('flows.json', JSON.stringify({
+  vertical: ID,
+  _note: '局部 id 不带点；合并后规范 id = `<vertical>.<local>`。冲突由 flow_registry.py 判定（冲突即 fail）。',
+  aliases: { [FLOW]: flowId },
+  flows: {
+    [FLOW]: {
+      title: `${TITLE || ID} · ${FLOW}`,
+      role: `${ID}-${ROLE}`,
+      // D2（2026-10-03）：流程 → 技能目录的**单一真源**（`argent sop` 只认它，不用 role 拼路径）。
+      // 门禁 vertical-lint 要求：必须 ∈ manifest#skills 且 `skills/<名>/SKILL.md` 存在 —— 下面已生成。
+      skill: skillId,
+      source: {
+        _gateNote: 'TODO 门内判据：什么算待办。三个原语：equals（必须等于）/ excludeEquals（排除已完成）/ excludeAllPresent（多项都在=人工已完成）。',
+        pick: { equals: { 'TODO 状态列': 'TODO 值' } },
+        envFile,
+        baseEnv: 'TODO_BASE_TOKEN',
+        tableEnv: 'TODO_TABLE_ID',
+        identityEnv: 'TODO_LARK_PROFILE',
+      },
+      routing: { routeBy: '', match: '' },
+      trigger: {
+        intervalSec: 300,
+        jitterSec: 45,
+        wake: 'off',
+        mode: 'shadow',
+        pauseSwitch,
+        log: `flow-trigger-${ID}-${FLOW}.log`,
+        promptTemplate: promptTpl,
+        dispatch: { preset: roleId, cwd: '~' },
+      },
+      concurrency: { max: 1, leaseMin: 20 },
+      guards: { dryRunDefault: true, backup: true, audit: true, writeFields: [] },
+      required: [],
+      failures: { enabled: false },
+      capability: capId,
+      notes: [
+        '由 scripts/vertical-init.mjs 生成的骨架：默认 wake=off / mode=shadow，先只读跑通再接写路径。',
+        '上线顺序：填门内判据 → 只读跑通（triage/claim 干跑）→ 接执行器 → 开 mode=real → 开 wake=session。',
+      ],
+    },
+  },
+  capabilities: {
+    [FLOW]: {
+      _note: '能力级共享规则（同一能力的多条流程必须共享这里，差异只能写在 flow.overrides 并被门禁检查）。',
+      gate: { equals: { 'TODO 状态列': 'TODO 值' } },
+      writeFields: [],
+      stateFields: [],
+      gapPolicy: 'TODO：缺口回填口径（哪些缺口该落卡等人、哪些只记错误信息）',
+    },
+  },
+  billing: { units: {} },
+}, null, 2) + '\n')
+
+// ── 提示词 / env / 计费 / 预检 / 测试 ────────────────────────────
+put(`prompts/${FLOW}.md`, `# ${TITLE || ID} · ${FLOW} 派发提示词
+
+你是「${TITLE || ID}」业务线的执行角色。本轮任务：
+
+- 流程：\`${flowId}\`
+- 范围：{{TICKETS}}（由引擎按门内判据挑选后传入）
+
+## 必做
+
+1. 先读技能 \`${skillId}\`（口径与踩坑都在那里）。
+2. 逐条处理，**每条都要有终态**（完成/需人工/失败分类），不许留半成品。
+3. 写路径遵守白名单（见注册表 \`guards.writeFields\`）；写前备份、写后读回验收。
+
+## 红线
+
+- 不碰本业务线以外的数据与文件。
+- 不确认的信息**落卡问人**，不要猜。
+`)
+
+put('env/example.env', `# ${TITLE || ID} 业务线环境（**命名空间隔离**：只在本线可见）
+# 复制为 verticals/${ID}/env/<name>.env 并填真实值；权限 600。
+# 变量名建议带业务线前缀，避免两条线同机时互相覆盖。
+
+${ID.replace(/-/g, '_').toUpperCase()}_BASE_TOKEN=
+${ID.replace(/-/g, '_').toUpperCase()}_TABLE_ID=
+${ID.replace(/-/g, '_').toUpperCase()}_LARK_PROFILE=
+`)
+
+put('billing.json', JSON.stringify({
+  _why: '本业务线的计费单位（口径沿用平台规则：只算成功 / 一票一结 / 证据可核）。rateYuan 是占位，定价改这里，脚本不写死金额。',
+  units: {
+    [`${FLOW}-item`]: {
+      unit: 'TODO 计价单位（如：件 / 单 / 店·月）',
+      rateYuan: 0,
+      humanMinutes: 0,
+      evidence: ['TODO 证据标记（正则）：能在产物/留言里核到的完成标记'],
+    },
+  },
+}, null, 2) + '\n')
+
+put('preflight.py', `#!/usr/bin/env python3
+"""${TITLE || ID} 业务线的验收检查段（由 customer-preflight 汇总）。
+
+规矩（与平台其它预检一致）：
+  · 只读探测，**不写**客户数据；
+  · 每条检查给出 ok/warn/fail 与**可执行的修复建议**；
+  · 缺凭据/缺权限要能区分"没配"与"配了但没权限"（历史踩坑：笼统报 91403 会误导）。
+"""
+from __future__ import annotations
+
+
+def checks(env: dict) -> list[tuple[str, str, str, str]]:
+    """返回 [(名称, 级别 ok|warn|fail, 说明, 修复建议)]。"""
+    out: list[tuple[str, str, str, str]] = []
+    # 示例（把 TODO 换成真实探测）：
+    # base = env.get('${ID.replace(/-/g, '_').toUpperCase()}_BASE_TOKEN')
+    # if not base:
+    #     out.append(('${ID}.creds', 'fail', '缺 ${ID.replace(/-/g, '_').toUpperCase()}_BASE_TOKEN', '填 verticals/${ID}/env/<name>.env'))
+    out.append(('${ID}.todo', 'warn', '预检段尚未实现（脚手架占位）', '实现 checks() 后接入 customer-preflight'))
+    return out
+
+
+if __name__ == '__main__':
+    for name, level, msg, fix in checks({}):
+        print(f'[{level}] {name}: {msg} → {fix}')
+`)
+
+put('tests/README.md', `# ${TITLE || ID} · 测试
+
+放本业务线自己的测试与夹具（**只在本线内**，不引用别的业务线）：
+
+- \`*.test.mjs\` / \`*.test.py\`：会被 \`scripts/tests/run-all-tests.sh\` 收集执行；
+- 夹具只落本目录或临时目录，**不要**放进仓库根或别的线；
+- 端到端夹具建议从测试数据源复制一份（脱敏），不要直连生产表。
+`)
+
+put('README.md', `# 业务线：${TITLE || ID}（\`${ID}\`）
+
+由 \`node scripts/vertical-init.mjs\` 生成。**待办清单**（按顺序做，做完一项勾一项）：
+
+1. [ ] 填 \`manifest.json\`：\`requires\` / \`verifiedOn\` / \`ports\`（实现名见 \`verticals/README.md\`）
+2. [ ] 填 \`flows.json\` 的门内判据（\`source.pick\` 与 \`capabilities.<c>.gate\` 保持一致）
+3. [ ] 复制 \`env/example.env\` 为真实 env（600）并填值；\`source.*Env\` 指向这些变量名
+4. [ ] 写 \`prompts/${FLOW}.md\` 的派发提示词（现在是骨架）
+5. [ ] 写技能 \`skills/${skillId}/SKILL.md\` 的口径与踩坑（**这是交付物的一部分**）
+6. [ ] 角色：\`presets/${roleId}/\`（脚手架已从 \`${FROM_PRESET}\` 复制，改 persona 与技能清单）
+7. [ ] 执行器与适配器：\`<flow>_runner.py\` + \`adapters/<system>/\`（人工门、错误词表、可执行计划）
+8. [ ] 预检：实现 \`preflight.py#checks\` 并接入 \`customer-preflight\`
+9. [ ] 门禁：\`node scripts/vertical-lint.mjs\` + \`node scripts/tests/run-all-tests.sh\`
+10. [ ] 打包与授权：\`capabilities\` 的 \`minPlan\`、\`billing.json\` 的计价单位
+11. [ ] 上线顺序：\`wake=off/mode=shadow\` 只读跑通 → \`mode=real\` → \`wake=session\`
+`)
+
+// ── 角色 preset（从底座角色复制，改 persona 与说明）─────────────
+const srcPreset = join(ROOT, 'presets', FROM_PRESET)
+if (!existsSync(srcPreset)) {
+  die(`底座角色不存在：presets/${FROM_PRESET}/（用 --from-preset 指定一个已存在的角色）`)
+}
+const dstPreset = join(ROOT, 'presets', roleId)
+mkdirSync(dirname(dstPreset), { recursive: true })
+cpSync(srcPreset, dstPreset, { recursive: true })
+
+// preset.yml：名称与描述换成新角色
+const presetYml = join(dstPreset, 'preset.yml')
+if (existsSync(presetYml)) {
+  const t = readFileSync(presetYml, 'utf8')
+  const out = t
+    .replace(/^name:.*$/m, `name: ${TITLE || ID} · ${ROLE}`)
+    .replace(/^description:.*$/m, `description: ${TITLE || ID} 业务线角色（${roleId}）—— 由 vertical-init 生成，请改写为真实职责说明。`)
+  writeFileSync(presetYml, out)
+}
+
+// agent.cordis.yml：persona 块的 prefix 文本换成新角色（保留其余行集合不动）
+const cordis = join(dstPreset, 'agent.cordis.yml')
+if (existsSync(cordis)) {
+  const lines = readFileSync(cordis, 'utf8').split('\n')
+  const out = []
+  let inPersona = false
+  let skipping = false
+  for (const line of lines) {
+    if (/^- id:\s*persona\s*$/.test(line)) { inPersona = true; out.push(line); continue }
+    if (inPersona && /^- id:/.test(line)) { inPersona = false; skipping = false }
+    if (inPersona && /^\s*prefix:\s*>?-?\s*$/.test(line)) {
+      out.push(line)
+      out.push(`      你是「${TITLE || ID}」业务线的执行角色（${roleId}），运行在 DeepSeek Harness 上（Argent）。`)
+      out.push('      先读本业务线的技能再动手；不确定的信息落卡问人，不要猜。')
+      out.push('      只操作本业务线的数据与文件。工作目录：{{cwd}}。模型：{{model}}。')
+      skipping = true
+      continue
+    }
+    if (skipping) {
+      if (/^\s{7,}\S/.test(line)) continue   // 丢弃原 persona 文本行（缩进比键更深的续行）
+      skipping = false
+    }
+    out.push(line)
+  }
+  writeFileSync(cordis, out.join('\n'))
+}
+
+// ── 技能（kebab-case name + description，门禁 fix-skill-frontmatter 的判据）──
+const skDir = join(ROOT, 'skills', skillId)
+mkdirSync(skDir, { recursive: true })
+writeFileSync(join(skDir, 'SKILL.md'), `---
+name: ${skillId}
+description: ${TITLE || ID} 业务线的 ${FLOW} 流程口径、操作步骤与踩坑（由 vertical-init 生成，待补全）。
+---
+
+# ${TITLE || ID} · ${FLOW}
+
+## 何时用
+
+处理 \`${flowId}\` 时**先读本技能**：口径、步骤、踩坑都在这里，不要凭常识猜。
+
+## 口径（必须写死，避免每次口述）
+
+- 什么算待办：
+- 什么算完成（终态）：
+- 什么算人工已办（**防止重复派发**）：
+- 缺口怎么办（哪些落卡等人、哪些只记错误信息）：
+
+## 操作步骤
+
+1. TODO
+2. TODO
+
+## 踩坑
+
+- TODO（每踩一次坑就在这里加一条：现象 → 根因 → 正确做法）
+`)
+
+console.log(`✅ 已生成业务线 \`${ID}\`（${written.length} 个文件）：`)
+for (const f of written) console.log(`   ${f}`)
+console.log(`   presets/${roleId}/（从 presets/${FROM_PRESET}/ 复制）`)
+console.log(`   skills/${skillId}/SKILL.md`)
+console.log(`
+下一步：
+  1) 填 verticals/${ID}/README.md 里的待办清单
+  2) node scripts/vertical-lint.mjs          # 门禁（命名空间/跨线引用/manifest 自洽）
+  3) python3 scripts/flow_registry.py --check # 合并与冲突
+  4) node scripts/gen-preset-rows.mjs         # 生成 0.1.7 行式 preset（改了角色后必跑）
+  5) node scripts/validate-preset-schema.mjs --runtime && node scripts/plugin-bootcheck.mjs
+`)