@dawipong/opcflow 0.5.0 → 0.7.0

package/dist/cli.mjs

@@ -66,6 +66,7 @@ var init_config = __esm({
       moduleMapping: {},
       feedbackHalfLifeDays: 15,
       gates: { approvalMode: "warn", writeGate: "observe" },
+      taskPreconditions: [{ role: "qa", type: "qa", requiresSiblingRoleCompleted: "developer" }],
       git: { taskTrailer: "off", trailerKey: "Task" },
       legacyDb: "tasks/task.db",
       dataDir: ".workbench",
@@ -409,6 +410,13 @@ var init_events = __esm({
 });
 
 // core/platforms.ts
+var platforms_exports = {};
+__export(platforms_exports, {
+  PLATFORM_IDS: () => PLATFORM_IDS,
+  getAdapter: () => getAdapter,
+  resolveModel: () => resolveModel,
+  resolvePlatforms: () => resolvePlatforms
+});
 import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync } from "node:fs";
 import { dirname as dirname2, join as join4 } from "node:path";
 import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
@@ -500,6 +508,12 @@ var init_platforms = __esm({
       hooksScanDir: ".claude/hooks",
       defaultModel: "opus",
       memoryBlock: (role, lang) => claudeMemory(role, lang),
+      projectDirEnvVar: "CLAUDE_PROJECT_DIR",
+      parseHookInput: (raw) => ({
+        filePath: raw?.tool_input?.file_path ?? raw?.tool_input?.filePath
+      }),
+      respondBlocked: (msg) => ({ exitCode: 2, stderr: msg }),
+      formatModel: (_providerId, modelId) => modelId,
       notes: [],
       agentFile: (role) => `${role}.md`,
       renderAgent: (spec) => yamlFrontmatter(
@@ -543,6 +557,12 @@ var init_platforms = __esm({
       hooksScanDir: null,
       defaultModel: "gpt-5.1-codex",
       memoryBlock: (_role, lang) => agentsMdMemory("Codex", lang),
+      projectDirEnvVar: "CODEX_PROJECT_DIR",
+      parseHookInput: (raw) => ({
+        filePath: raw?.arguments?.file_path ?? raw?.arguments?.filePath
+      }),
+      respondBlocked: (msg) => ({ exitCode: 2, stderr: msg }),
+      formatModel: (_providerId, modelId) => modelId,
       notes: [
         'Codex:\u9879\u76EE\u7EA7 .codex/* \u4EC5\u5F53\u9879\u76EE\u88AB\u6807\u8BB0 trusted \u624D\u52A0\u8F7D \u2014\u2014 \u5728 ~/.codex/config.toml \u91CC\u4E3A\u672C\u9879\u76EE\u8BBE trust_level="trusted"',
         "Codex:skill \u8D70 .agents/skills/(\u975E .codex/skills)"
@@ -583,6 +603,12 @@ var init_platforms = __esm({
       hooksScanDir: null,
       defaultModel: "anthropic/claude-opus-4-8",
       memoryBlock: (_role, lang) => agentsMdMemory("OpenCode", lang),
+      projectDirEnvVar: "OPENCODE_PROJECT_DIR",
+      parseHookInput: (raw) => ({
+        filePath: raw?.args?.file_path ?? raw?.args?.filePath
+      }),
+      respondBlocked: (msg) => ({ exitCode: 2, stderr: msg }),
+      formatModel: (providerId, modelId) => `${providerId}/${modelId}`,
       notes: [
         "OpenCode:\u6A21\u578B\u4E32\u662F provider/model \u683C\u5F0F(\u89C1 models.dev);API key \u5EFA\u8BAE\u8D70\u73AF\u5883\u53D8\u91CF\u6216 {env:...}"
       ],
@@ -651,6 +677,15 @@ export const opcflow = async () => ({
       hooksScanDir: null,
       defaultModel: "claude-opus-4-8",
       memoryBlock: (_role, lang) => cursorMemory(lang),
+      projectDirEnvVar: "CURSOR_PROJECT_DIR",
+      parseHookInput: (raw) => ({
+        filePath: raw?.file_path ?? raw?.filePath
+      }),
+      respondBlocked: (msg) => ({
+        exitCode: 0,
+        stdout: JSON.stringify({ permission: "deny", userMessage: msg, agentMessage: msg })
+      }),
+      formatModel: (_providerId, modelId) => modelId,
       notes: [
         "Cursor:\u4E3B agent \u6A21\u578B\u7531 UI \u9009,--model \u53EA\u4F5C\u7528\u4E8E\u751F\u6210\u7684 subagent(.cursor/agents/*.md)"
       ],
@@ -700,6 +735,7 @@ __export(kind_exports, {
   expandPattern: () => expandPattern,
   getKindRegistry: () => getKindRegistry,
   inferKind: () => inferKind,
+  kindPathTemplate: () => kindPathTemplate,
   kindSpec: () => kindSpec,
   normalizeModule: () => normalizeModule
 });
@@ -731,6 +767,14 @@ function contractKinds(config) {
 function expandPattern(pattern, config) {
   return pattern.replace("{prd}", config.docs.prd).replace("{architecture}", config.docs.architecture).replace("{design}", config.docs.design).replace("{acceptance}", config.docs.acceptance);
 }
+function kindPathTemplate(config, kind, lang) {
+  const spec = getKindRegistry(config)[kind];
+  if (!spec?.coords || !spec.pathPatterns?.[0]) return null;
+  const prefix = expandPattern(spec.pathPatterns[0], config);
+  const ext = spec.ext ?? "md";
+  const segs = spec.coords.split("/").map((s) => lang === "zh" ? COORD_LABELS_ZH[s] ?? s : s);
+  return `${prefix}${segs.join("/")}.${ext}`;
+}
 function inferKind(relPath, config) {
   const p = relPath.replace(/\\/g, "/");
   const registry = getKindRegistry(config);
@@ -748,7 +792,7 @@ function normalizeModule(module, config) {
   if (!module) return null;
   return config.moduleMapping[module] ?? module;
 }
-var DEFAULT_KIND_REGISTRY, META_KINDS, PM_KINDS, KIND_TIERS;
+var DEFAULT_KIND_REGISTRY, META_KINDS, PM_KINDS, KIND_TIERS, COORD_LABELS_ZH;
 var init_kind = __esm({
   "core/kind.ts"() {
     "use strict";
@@ -770,7 +814,7 @@ var init_kind = __esm({
       "api-doc": { level: "module", approval: "human", parents: ["module-prd", "db-doc"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{architecture}/api/"], coords: "{module}", defaultEndpoint: "service" },
       "design-system": { level: "endpoint", approval: "human", parents: ["baseline"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{design}/systems/"], coords: "{endpoint}" },
       "design-prompt": { level: "page", approval: "none", parents: ["page-prd", "api-doc", "design-system"], drivesStale: false, hashMode: "text-normalize", retrieval: "summary", pathPatterns: ["{design}/prompts/"], coords: "{endpoint}/{module}/{page}" },
-      prototype: { level: "page", approval: "thumbs", parents: ["design-prompt", "design-system"], drivesStale: true, hashMode: "text-normalize", retrieval: "summary", pathPatterns: ["{design}/prototypes/"], coords: "{endpoint}/{module}/{page}" },
+      prototype: { level: "page", approval: "thumbs", parents: ["design-prompt", "design-system"], drivesStale: true, hashMode: "text-normalize", retrieval: "summary", pathPatterns: ["{design}/prototypes/"], coords: "{endpoint}/{module}/{page}", ext: "html" },
       acceptance: { level: "page", approval: "human", parents: ["page-prd", "prototype"], drivesStale: true, hashMode: "text-normalize", retrieval: "full", pathPatterns: ["{acceptance}/"], coords: "{endpoint}/{module}/{page}" },
       code: { level: "module", approval: "machine", parents: ["baseline", "api-doc", "prototype"], drivesStale: false, hashMode: "directory", retrieval: "semantic" },
       doc: { level: "module", approval: "none", parents: [], drivesStale: false, hashMode: "text-normalize", retrieval: "summary" }
@@ -789,6 +833,7 @@ var init_kind = __esm({
       ["prototype", "acceptance"],
       ["code"]
     ];
+    COORD_LABELS_ZH = { "{module}": "{\u6A21\u5757}", "{endpoint}": "{\u7AEF}", "{page}": "{\u9875\u9762}" };
   }
 });
 
@@ -992,20 +1037,27 @@ function requirementSatisfied(ctx, req, matched) {
     (a) => kindSpec(ctx.config, a.kind).approval === "thumbs" ? prototypeEndorsed(ctx.db, a) : reviewStatus(a) === "approved"
   );
 }
-function validateClaim(ctx, task) {
-  const warnings = [];
-  const inputs = /* @__PURE__ */ new Map();
-  const mode = ctx.config.gates.approvalMode;
-  if (task.role === "qa" && task.type === "qa") {
-    const dev = ctx.db.prepare(
+function siblingRoleBlocking(ctx, task) {
+  for (const rule of ctx.config.taskPreconditions ?? []) {
+    if (rule.role !== task.role) continue;
+    if (rule.type && rule.type !== task.type) continue;
+    const done = ctx.db.prepare(
       `SELECT COUNT(*) AS c FROM tasks
-         WHERE role = 'developer' AND status = 'completed' AND module IS ? AND endpoint IS ?
+         WHERE role = ? AND status = 'completed' AND module IS ? AND endpoint IS ?
            AND (? IS NULL OR page IS ?)`
-    ).get(task.module, task.endpoint, task.page, task.page);
-    if (dev.c === 0) {
-      throw new Error(`[\u524D\u7F6E\u6761\u4EF6] \u5BF9\u5E94\u7684 developer ${task.endpoint} \u4EFB\u52A1\u5C1A\u672A\u5B8C\u6210,\u65E0\u6CD5\u9886\u53D6 qa \u4EFB\u52A1\u3002`);
+    ).get(rule.requiresSiblingRoleCompleted, task.module, task.endpoint, task.page, task.page);
+    if (done.c === 0) {
+      return `\u5BF9\u5E94\u7684 ${rule.requiresSiblingRoleCompleted} ${task.endpoint ?? ""} \u4EFB\u52A1\u5C1A\u672A\u5B8C\u6210,\u65E0\u6CD5\u9886\u53D6 ${task.role} \u4EFB\u52A1\u3002`;
     }
   }
+  return null;
+}
+function validateClaim(ctx, task) {
+  const warnings = [];
+  const inputs = /* @__PURE__ */ new Map();
+  const mode = ctx.config.gates.approvalMode;
+  const blockMsg = siblingRoleBlocking(ctx, task);
+  if (blockMsg) throw new Error(`[\u524D\u7F6E\u6761\u4EF6] ${blockMsg}`);
   if (task.module && (task.type === "build" || task.type === "hotfix") && !moduleCleared(ctx.db, task.module)) {
     warnings.push(
       `[\u6E05\u7B97] \u6A21\u5757 ${task.module} \u672A\u6E05\u7B97(module-prd \u672A\u5BA1\u6279)\u3002\u5EFA\u8BAE\u5148\u5BF9\u8D26:${ctx.config.cli} audit --module=${task.module}`
@@ -1068,19 +1120,18 @@ function validateComplete(ctx, task, status, opts = {}) {
       warnings.push(msg);
     }
   }
-  if (task.role === "developer" || task.role === "architect") {
-    const violations = runProtocolLints(ctx, { role: task.role, endpoint: task.endpoint });
-    if (violations.length > 0) {
-      const detail = violations.slice(0, 10).map((v) => `  ${v.file}:${v.line} [${v.lint}] ${v.message}
+  const violations = runProtocolLints(ctx, { role: task.role, endpoint: task.endpoint });
+  if (violations.length > 0) {
+    const detail = violations.slice(0, 10).map((v) => `  ${v.file}:${v.line} [${v.lint}] ${v.message}
     ${v.text}`).join("\n");
-      throw new Error(
-        `[\u534F\u8BAE lint \u5931\u8D25] ${violations.length} \u5904\u8FDD\u4F8B,\u4FEE\u590D\u540E\u518D\u5B8C\u6210:
+    throw new Error(
+      `[\u534F\u8BAE lint \u5931\u8D25] ${violations.length} \u5904\u8FDD\u4F8B,\u4FEE\u590D\u540E\u518D\u5B8C\u6210:
 ${detail}${violations.length > 10 ? `
   ...\u7B49 ${violations.length} \u5904` : ""}`
-      );
-    }
+    );
   }
-  if (task.role === "developer" && task.endpoint && ctx.config.machineChecks.enabled) {
+  const producesMachineKind = producedKinds(ctx, task).some((k) => kindSpec(ctx.config, k).approval === "machine");
+  if (producesMachineKind && task.endpoint && ctx.config.machineChecks.enabled) {
     const cmds = ctx.config.machineChecks[task.endpoint];
     if (Array.isArray(cmds)) {
       for (const cmd of cmds) {
@@ -1125,7 +1176,7 @@ function taskBlocked(ctx, task) {
     validateClaim(ctx, task);
     return false;
   } catch (err) {
-    return err instanceof Error && err.message.includes("\u4E0D\u5B58\u5728");
+    return err instanceof Error && err.message.includes("[\u524D\u7F6E\u6761\u4EF6]");
   }
 }
 function coordHealth(ctx, artifacts, tasks) {
@@ -1206,6 +1257,7 @@ function buildTree(ctx, opts = {}) {
         eTasks.filter((t) => !t.page)
       );
       for (const child of pageNodes) health2 = worse(health2, child.health);
+      if (coordFailed(ctx, module, endpoint, null)) health2 = "failed";
       return {
         key: `${module}/${endpoint}`,
         title: endpoint,
@@ -1754,16 +1806,16 @@ function ownerRole(ctx, kind) {
   if (kind === "code") return "developer";
   return null;
 }
-function hasOpenReview(ctx, artifactId) {
-  const row = ctx.db.prepare(
-    `SELECT COUNT(*) AS c FROM tasks t
+function openReviewTargetKeys(ctx, artifactId) {
+  const rows = ctx.db.prepare(
+    `SELECT t.role, t.endpoint, t.module FROM tasks t
        JOIN task_inputs ti ON ti.task_id = t.id
        WHERE t.type = 'review' AND t.status IN ('pending', 'in_progress') AND ti.artifact_id = ?`
-  ).get(artifactId);
-  return row.c > 0;
+  ).all(artifactId);
+  return new Set(rows.map((r) => `${r.role}|${r.endpoint ?? ""}|${r.module ?? ""}`));
 }
 function spawnReviews(ctx, source, reason) {
-  if (hasOpenReview(ctx, source.id)) return 0;
+  const openKeys = openReviewTargetKeys(ctx, source.id);
   const registry = getKindRegistry(ctx.config);
   const downstream = ctx.db.prepare(`SELECT a.* FROM artifacts a JOIN artifact_edges e ON e.to_id = a.id WHERE e.from_id = ?`).all(source.id);
   const targets = /* @__PURE__ */ new Map();
@@ -1772,6 +1824,7 @@ function spawnReviews(ctx, source, reason) {
     const role = ownerRole(ctx, child.kind);
     if (!role) continue;
     const key = `${role}|${child.endpoint ?? ""}|${child.module ?? source.module ?? ""}`;
+    if (openKeys.has(key)) continue;
     targets.set(key, { role, endpoint: child.endpoint, module: child.module ?? source.module });
   }
   let spawned = 0;
@@ -1969,6 +2022,7 @@ function updateTask(ctx, { id, status, operator, force = false }) {
     throw new Error(`\u53EA\u6709\u6267\u884C\u4EBA\u624D\u80FD\u66F4\u65B0\u4EFB\u52A1\u72B6\u6001`);
   }
   const { warnings } = validateComplete(ctx, task, status, { force });
+  let followupQaId = null;
   const tx = ctx.db.transaction(() => {
     ctx.db.prepare("UPDATE tasks SET status = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?").run(status, id);
     logEvent(ctx.db, {
@@ -1981,15 +2035,15 @@ function updateTask(ctx, { id, status, operator, force = false }) {
       endpoint: task.endpoint,
       page: task.page
     });
+    if (task.type === "rework" && status === "completed") {
+      followupQaId = spawnFollowupQa(ctx, task);
+    }
   });
   tx();
+  if (followupQaId !== null) warnings.push(`[\u590D\u9A8C] \u5DF2\u81EA\u52A8\u6D3E\u65B0\u4E00\u8F6E qa \u4EFB\u52A1 #${followupQaId}`);
   if (task.type === "hotfix" && status === "completed") {
     warnings.push(...checkContractTouch(ctx, task, operator));
   }
-  if (task.type === "rework" && status === "completed") {
-    const qaId = spawnFollowupQa(ctx, task);
-    warnings.push(`[\u590D\u9A8C] \u5DF2\u81EA\u52A8\u6D3E\u65B0\u4E00\u8F6E qa \u4EFB\u52A1 #${qaId}`);
-  }
   if (status === "completed" && task.external_ref?.startsWith("gh#")) {
     const closed = closeLinkedIssue(ctx, task.external_ref, task.id);
     warnings.push(closed ? `[issue] \u5DF2\u5173\u95ED ${task.external_ref}` : `[issue] ${task.external_ref} \u5173\u95ED\u5931\u8D25(gh \u4E0D\u53EF\u7528),\u8BF7\u624B\u52A8\u5904\u7406`);
@@ -2938,6 +2992,8 @@ var init_retro_command = __esm({
 });
 
 // core/commands/plan.command.ts
+import { existsSync as existsSync10 } from "node:fs";
+import { join as join12 } from "node:path";
 function planModule(ctx, moduleRaw, creator = "product-manager") {
   const module = normalizeModule(moduleRaw, ctx.config);
   const summary = { created: [], skipped: 0, cancelled: 0, warnings: [] };
@@ -2961,7 +3017,7 @@ function planModule(ctx, moduleRaw, creator = "product-manager") {
     if (ctx.config.gates.approvalMode === "enforce") throw new Error(`[\u524D\u7F6E\u6761\u4EF6] ${msg}`);
     summary.warnings.push(msg);
   }
-  const pagePrds = byKind("page-prd").filter((a) => a.endpoint && a.page);
+  const pagePrds = byKind("page-prd").filter((a) => a.endpoint && a.page && existsSync10(join12(ctx.root, a.path)));
   const endpoints = [...new Set(pagePrds.map((a) => a.endpoint))];
   const desired = [
     { role: "architect", endpoint: "common", page: null, type: "build", assignee: "architect", content: `\u8BBE\u8BA1 ${module} \u6A21\u5757\u6570\u636E\u5E93` },
@@ -3041,11 +3097,11 @@ var init_plan_command = __esm({
 });
 
 // core/commands/install-hooks.command.ts
-import { chmodSync, existsSync as existsSync10, mkdirSync as mkdirSync5, writeFileSync as writeFileSync4 } from "node:fs";
-import { join as join12 } from "node:path";
+import { chmodSync, existsSync as existsSync11, mkdirSync as mkdirSync5, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join13 } from "node:path";
 function installGitHooks(ctx) {
-  const hooksDir = join12(ctx.root, ".git", "hooks");
-  if (!existsSync10(join12(ctx.root, ".git"))) throw new Error("\u4E0D\u662F git \u4ED3\u5E93");
+  const hooksDir = join13(ctx.root, ".git", "hooks");
+  if (!existsSync11(join13(ctx.root, ".git"))) throw new Error("\u4E0D\u662F git \u4ED3\u5E93");
   mkdirSync5(hooksDir, { recursive: true });
   const installed = [];
   const postCommit = `#!/bin/sh
@@ -3053,9 +3109,9 @@ function installGitHooks(ctx) {
 ${WORKBENCH_BIN} postcommit >/dev/null 2>&1 &
 exit 0
 `;
-  writeFileSync4(join12(hooksDir, "post-commit"), postCommit);
+  writeFileSync4(join13(hooksDir, "post-commit"), postCommit);
   try {
-    chmodSync(join12(hooksDir, "post-commit"), 493);
+    chmodSync(join13(hooksDir, "post-commit"), 493);
   } catch {
   }
   installed.push("post-commit(sync \u5BF9\u8D26)");
@@ -3069,9 +3125,9 @@ if [ -n "$WORKBENCH_TASK_ID" ] && [ "$2" != "merge" ]; then
 fi
 exit 0
 `;
-    writeFileSync4(join12(hooksDir, "prepare-commit-msg"), prepare);
+    writeFileSync4(join13(hooksDir, "prepare-commit-msg"), prepare);
     try {
-      chmodSync(join12(hooksDir, "prepare-commit-msg"), 493);
+      chmodSync(join13(hooksDir, "prepare-commit-msg"), 493);
     } catch {
     }
     installed.push(`prepare-commit-msg(${ctx.config.git.trailerKey} trailer \u6CE8\u5165)`);
@@ -3086,8 +3142,8 @@ var init_install_hooks_command = __esm({
 });
 
 // core/commands/gen-agents.command.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync6, readdirSync as readdirSync5, writeFileSync as writeFileSync5 } from "node:fs";
-import { dirname as dirname3, join as join13 } from "node:path";
+import { existsSync as existsSync12, mkdirSync as mkdirSync6, readFileSync as readFileSync6, readdirSync as readdirSync5, writeFileSync as writeFileSync5 } from "node:fs";
+import { dirname as dirname3, join as join14 } from "node:path";
 function expandPath(ctx, kind) {
   const spec = getKindRegistry(ctx.config)[kind];
   const raw = spec?.pathPatterns?.[0] ?? "";
@@ -3113,8 +3169,8 @@ function parseTemplate(rawInput) {
 function genAgents(ctx, templatesDir) {
   const lang = ctx.config.language;
   const blocks = SHARED[lang] ?? SHARED.zh;
-  const dir = templatesDir ?? join13(WORKBENCH_DIR, "templates/agents", lang);
-  if (!existsSync11(dir)) throw new Error(`\u6A21\u677F\u76EE\u5F55\u4E0D\u5B58\u5728: ${dir}`);
+  const dir = templatesDir ?? join14(WORKBENCH_DIR, "templates/agents", lang);
+  if (!existsSync12(dir)) throw new Error(`\u6A21\u677F\u76EE\u5F55\u4E0D\u5B58\u5728: ${dir}`);
   const cli = ctx.config.cli;
   const baseTokens = {
     CLI: cli,
@@ -3132,6 +3188,16 @@ function genAgents(ctx, templatesDir) {
     PATH_DESIGN_PROMPTS: expandPath(ctx, "design-prompt"),
     PATH_PROTOTYPES: expandPath(ctx, "prototype"),
     PATH_ACCEPTANCE: expandPath(ctx, "acceptance"),
+    // 路径投影:完整路径模板由 kind 注册表(前缀+coords 文法+ext)推导——
+    // 项目覆盖 coords 后重跑 gen-agents,agent 指示与 scan 解析自动同步(单一真相源)
+    TPL_FLOW: kindPathTemplate(ctx.config, "flow", lang) ?? "",
+    TPL_MODULE_PRD: kindPathTemplate(ctx.config, "module-prd", lang) ?? "",
+    TPL_PAGE_PRD: kindPathTemplate(ctx.config, "page-prd", lang) ?? "",
+    TPL_DB_DOC: kindPathTemplate(ctx.config, "db-doc", lang) ?? "",
+    TPL_DESIGN_SYSTEM: kindPathTemplate(ctx.config, "design-system", lang) ?? "",
+    TPL_DESIGN_PROMPT: kindPathTemplate(ctx.config, "design-prompt", lang) ?? "",
+    TPL_PROTOTYPE: kindPathTemplate(ctx.config, "prototype", lang) ?? "",
+    TPL_ACCEPTANCE: kindPathTemplate(ctx.config, "acceptance", lang) ?? "",
     ENDPOINTS: ctx.config.endpoints.join(" / "),
     PIPELINE: ctx.config.pipeline.join(" \u2192 "),
     CODE_ROOTS: ctx.config.endpoints.map((e) => `| ${e} | ${(ctx.config.codeRoots[e] ?? []).join(blocks.sep) || blocks.todo} |`).join("\n")
@@ -3151,7 +3217,7 @@ function genAgents(ctx, templatesDir) {
     if (!file.endsWith(".md")) continue;
     const role = file.replace(/\.md$/, "");
     if (!pipeline.has(role)) continue;
-    const tpl = parseTemplate(readFileSync6(join13(dir, file), "utf-8"));
+    const tpl = parseTemplate(readFileSync6(join14(dir, file), "utf-8"));
     for (const adapter of adapters) {
       const memory = adapter.memoryBlock(role, lang);
       const spec = {
@@ -3162,7 +3228,7 @@ function genAgents(ctx, templatesDir) {
         body: renderTokens(tpl.body, memory)
       };
       const rel = `${adapter.agentsDir}/${adapter.agentFile(role)}`;
-      const abs = join13(ctx.root, rel);
+      const abs = join14(ctx.root, rel);
       mkdirSync6(dirname3(abs), { recursive: true });
       writeFileSync5(abs, adapter.renderAgent(spec));
       written.push(rel);
@@ -3246,8 +3312,8 @@ When MCP is registered, prefer the \`wb_*\` typed tools (same source & transacti
 });
 
 // core/commands/audit.command.ts
-import { existsSync as existsSync12 } from "node:fs";
-import { join as join14 } from "node:path";
+import { existsSync as existsSync13 } from "node:fs";
+import { join as join15 } from "node:path";
 function auditModule(ctx, moduleRaw) {
   const module = normalizeModule(moduleRaw, ctx.config);
   const kinds = contractKinds(ctx.config);
@@ -3257,9 +3323,9 @@ function auditModule(ctx, moduleRaw) {
     path: a.path,
     status: reviewStatus(a),
     everApproved: everApproved(a),
-    onDisk: existsSync12(join14(ctx.root, a.path))
+    onDisk: existsSync13(join15(ctx.root, a.path))
   }));
-  const codeDirs = artifacts.filter((a) => a.kind === "code").map((a) => ({ path: a.path, endpoint: a.endpoint, onDisk: existsSync12(join14(ctx.root, a.path)) }));
+  const codeDirs = artifacts.filter((a) => a.kind === "code").map((a) => ({ path: a.path, endpoint: a.endpoint, onDisk: existsSync13(join15(ctx.root, a.path)) }));
   return {
     module,
     cleared: moduleCleared(ctx.db, module),
@@ -3323,28 +3389,28 @@ var init_intake_command = __esm({
 // core/commands/init.command.ts
 import {
   copyFileSync,
-  existsSync as existsSync13,
+  existsSync as existsSync14,
   mkdirSync as mkdirSync7,
   readFileSync as readFileSync7,
   readdirSync as readdirSync6,
   writeFileSync as writeFileSync6
 } from "node:fs";
-import { dirname as dirname4, join as join15 } from "node:path";
+import { dirname as dirname4, join as join16 } from "node:path";
 function deployPreset(root) {
   const deployed = [];
-  if (!existsSync13(PRESET_DIR)) return deployed;
+  if (!existsSync14(PRESET_DIR)) return deployed;
   const walk = (rel) => {
-    for (const ent of readdirSync6(join15(PRESET_DIR, rel), {
+    for (const ent of readdirSync6(join16(PRESET_DIR, rel), {
       withFileTypes: true
     })) {
-      const childRel = rel ? join15(rel, ent.name) : ent.name;
+      const childRel = rel ? join16(rel, ent.name) : ent.name;
       if (ent.isDirectory()) {
         walk(childRel);
       } else if (ent.isFile()) {
-        const dest = join15(root, childRel);
-        if (existsSync13(dest)) continue;
+        const dest = join16(root, childRel);
+        if (existsSync14(dest)) continue;
         mkdirSync7(dirname4(dest), { recursive: true });
-        copyFileSync(join15(PRESET_DIR, childRel), dest);
+        copyFileSync(join16(PRESET_DIR, childRel), dest);
         deployed.push(childRel);
       }
     }
@@ -3353,8 +3419,8 @@ function deployPreset(root) {
   return deployed;
 }
 function ensureRootTsx(root) {
-  const pkgPath = join15(root, "package.json");
-  if (!existsSync13(pkgPath)) return false;
+  const pkgPath = join16(root, "package.json");
+  if (!existsSync14(pkgPath)) return false;
   const pkg = JSON.parse(readFileSync7(pkgPath, "utf-8"));
   if (pkg.devDependencies?.tsx) return false;
   pkg.devDependencies = { ...pkg.devDependencies ?? {}, tsx: TSX_VERSION };
@@ -3362,8 +3428,8 @@ function ensureRootTsx(root) {
   return true;
 }
 function initProject(root, opts) {
-  const configPath = join15(root, CONFIG_FILENAME);
-  if (existsSync13(configPath)) {
+  const configPath = join16(root, CONFIG_FILENAME);
+  if (existsSync14(configPath)) {
     throw new Error(
       `${CONFIG_FILENAME} \u5DF2\u5B58\u5728,init \u53EA\u7528\u4E8E\u7A7A\u9879\u76EE\u5F15\u5BFC(\u6539\u914D\u7F6E\u8BF7\u76F4\u63A5\u7F16\u8F91\u8BE5\u6587\u4EF6)`
     );
@@ -3397,10 +3463,10 @@ function initProject(root, opts) {
   const scaffolded = [];
   if (opts.scaffold !== false) {
     for (const dir of DOC_DIRS) {
-      const abs = join15(root, dir);
-      if (!existsSync13(abs)) {
+      const abs = join16(root, dir);
+      if (!existsSync14(abs)) {
         mkdirSync7(abs, { recursive: true });
-        writeFileSync6(join15(abs, ".gitkeep"), "");
+        writeFileSync6(join16(abs, ".gitkeep"), "");
         scaffolded.push(dir);
       }
     }
@@ -3432,7 +3498,7 @@ function initProject(root, opts) {
   }
   const notes = adapters.flatMap((a) => a.notes);
   let hooks = [];
-  if (opts.gitHooks !== false && existsSync13(join15(root, ".git"))) {
+  if (opts.gitHooks !== false && existsSync14(join16(root, ".git"))) {
     try {
       hooks = installGitHooks(ctx);
     } catch {
@@ -3474,7 +3540,7 @@ var init_init_command = __esm({
       "docs/design/prototypes",
       "docs/acceptance"
     ];
-    PRESET_DIR = join15(WORKBENCH_DIR, "preset");
+    PRESET_DIR = join16(WORKBENCH_DIR, "preset");
     TSX_VERSION = "^4";
   }
 });
@@ -3532,6 +3598,7 @@ __export(core_exports, {
   initProject: () => initProject,
   installGitHooks: () => installGitHooks,
   intakeIssues: () => intakeIssues,
+  kindPathTemplate: () => kindPathTemplate,
   kindSpec: () => kindSpec,
   listArtifacts: () => listArtifacts,
   listEvents: () => listEvents,
@@ -3762,17 +3829,17 @@ __export(app_exports, {
 import fastifyCors from "@fastify/cors";
 import fastifyStatic from "@fastify/static";
 import Fastify from "fastify";
-import { existsSync as existsSync14, mkdirSync as mkdirSync8, readFileSync as readFileSync8, readdirSync as readdirSync7, statSync as statSync6 } from "node:fs";
-import { isAbsolute as isAbsolute2, join as join16, normalize, relative as relative2 } from "node:path";
+import { existsSync as existsSync15, mkdirSync as mkdirSync8, readFileSync as readFileSync8, readdirSync as readdirSync7, statSync as statSync6 } from "node:fs";
+import { isAbsolute as isAbsolute2, join as join17, normalize, relative as relative2 } from "node:path";
 function getArtifact(ctx, id) {
   const row = ctx.db.prepare("SELECT * FROM artifacts WHERE id = ?").get(id);
   if (!row) throw Object.assign(new Error(`artifact #${id} \u4E0D\u5B58\u5728`), { statusCode: 404 });
   return row;
 }
 function guardedAbsPath(ctx, artifact, rel) {
-  const base = normalize(join16(ctx.root, artifact.path));
+  const base = normalize(join17(ctx.root, artifact.path));
   if (!rel) return base;
-  const target = normalize(join16(base, rel));
+  const target = normalize(join17(base, rel));
   const r = relative2(base, target);
   if (r === "" || r === "." || r.startsWith("..") || isAbsolute2(r)) {
     throw Object.assign(new Error("\u8DEF\u5F84\u8D8A\u754C"), { statusCode: 403 });
@@ -3782,11 +3849,11 @@ function guardedAbsPath(ctx, artifact, rel) {
 async function createServer(ctx) {
   const app = Fastify({ logger: false });
   await app.register(fastifyCors, { origin: true });
-  const webDist = join16(WORKBENCH_DIR, "web/dist");
-  if (existsSync14(webDist)) {
+  const webDist = join17(WORKBENCH_DIR, "web/dist");
+  if (existsSync15(webDist)) {
     await app.register(fastifyStatic, { root: webDist });
   }
-  const protoRoot = join16(ctx.root, ctx.config.docs.design, "prototypes");
+  const protoRoot = join17(ctx.root, ctx.config.docs.design, "prototypes");
   mkdirSync8(protoRoot, { recursive: true });
   await app.register(fastifyStatic, { root: protoRoot, prefix: "/proto/", decorateReply: false });
   app.get("/api/meta", async () => ({
@@ -3821,7 +3888,7 @@ async function createServer(ctx) {
     let content = null;
     let isDirectory = false;
     let missing = false;
-    if (!existsSync14(abs)) {
+    if (!existsSync15(abs)) {
       missing = true;
     } else if (statSync6(abs).isDirectory()) {
       isDirectory = true;
@@ -3837,20 +3904,20 @@ async function createServer(ctx) {
     const walk = (dir, rel) => {
       for (const name of readdirSync7(dir).sort()) {
         if (name === "node_modules" || name.startsWith(".")) continue;
-        const full = join16(dir, name);
+        const full = join17(dir, name);
         const relPath = rel ? `${rel}/${name}` : name;
         const st = statSync6(full);
         if (st.isDirectory()) walk(full, relPath);
         else files.push({ rel: relPath, size: st.size });
       }
     };
-    if (existsSync14(base) && statSync6(base).isDirectory()) walk(base, "");
+    if (existsSync15(base) && statSync6(base).isDirectory()) walk(base, "");
     return { files };
   });
   app.get("/api/artifact/:id/file", async (req) => {
     const artifact = getArtifact(ctx, parseInt(req.params.id));
     const abs = guardedAbsPath(ctx, artifact, req.query.rel);
-    if (!existsSync14(abs) || statSync6(abs).isDirectory()) {
+    if (!existsSync15(abs) || statSync6(abs).isDirectory()) {
       throw Object.assign(new Error("\u6587\u4EF6\u4E0D\u5B58\u5728"), { statusCode: 404 });
     }
     if (statSync6(abs).size > MAX_INLINE_SIZE) {
@@ -3905,7 +3972,7 @@ data: {"cursor":${cursor2}}
       endpoint: a.endpoint,
       page: a.page,
       review_status: reviewStatus(a),
-      missing: !existsSync14(join16(ctx.root, a.path))
+      missing: !existsSync15(join17(ctx.root, a.path))
     }));
     const edges = ctx.db.prepare("SELECT id, from_id, to_id, source FROM artifact_edges").all().filter((e) => ids.has(e.from_id) && ids.has(e.to_id));
     return { nodes, edges };
@@ -3922,7 +3989,7 @@ data: {"cursor":${cursor2}}
       for (const name of readdirSync7(dir).sort()) {
         if (files.length >= 30) return;
         if (name.startsWith(".") || name === "node_modules" || name === "dist" || name === "build") continue;
-        const full = join16(dir, name);
+        const full = join17(dir, name);
         const relPath = rel ? `${rel}/${name}` : name;
         if (statSync6(full).isDirectory()) walk(full, relPath);
         else if (relPath.toLowerCase().includes(q) && !registered.has(relPath)) files.push(relPath);
@@ -4022,7 +4089,7 @@ data: {"cursor":${cursor2}}
   app.get("/api/artifact/:id/diff", async (req) => {
     const artifact = getArtifact(ctx, parseInt(req.params.id));
     const abs = guardedAbsPath(ctx, artifact);
-    const current = existsSync14(abs) && !statSync6(abs).isDirectory() ? readFileSync8(abs, "utf-8") : null;
+    const current = existsSync15(abs) && !statSync6(abs).isDirectory() ? readFileSync8(abs, "utf-8") : null;
     return { approved: approvedContent(ctx, artifact.id), current };
   });
   app.post(
@@ -4088,15 +4155,17 @@ function hookPlatform() {
   const arg = process.argv.find((a) => a.startsWith("--platform="));
   return arg ? arg.slice("--platform=".length) : "claude";
 }
-function extractFilePath(input) {
+function extractFilePath(input, adapter) {
+  const fromAdapter = adapter?.parseHookInput(input).filePath;
+  if (fromAdapter) return fromAdapter;
   return input?.tool_input?.file_path ?? // claude PreToolUse/PostToolUse
   input?.tool_input?.filePath ?? input?.file_path ?? // cursor afterFileEdit / 通用
   input?.filePath ?? input?.args?.file_path ?? // opencode tool 参数
   input?.args?.filePath ?? input?.arguments?.file_path ?? // codex 兜底
   input?.arguments?.filePath ?? input?.input?.file_path ?? void 0;
 }
-function hookProjectDir() {
-  return process.env.CLAUDE_PROJECT_DIR ?? process.env.CODEX_PROJECT_DIR ?? process.env.CURSOR_PROJECT_DIR ?? process.env.OPENCODE_PROJECT_DIR ?? process.env.WORKBENCH_PROJECT ?? void 0;
+function hookProjectDir(adapter) {
+  return (adapter && process.env[adapter.projectDirEnvVar]) ?? process.env.CLAUDE_PROJECT_DIR ?? process.env.CODEX_PROJECT_DIR ?? process.env.CURSOR_PROJECT_DIR ?? process.env.OPENCODE_PROJECT_DIR ?? process.env.WORKBENCH_PROJECT ?? void 0;
 }
 async function readStdinJson() {
   const chunks = [];
@@ -4120,14 +4189,16 @@ __export(hook_pretooluse_exports, {
 });
 async function writeGateHook(platform) {
   const input = await readStdinJson();
-  const filePath = extractFilePath(input);
+  const { getAdapter: getAdapter2, PLATFORM_IDS: PLATFORM_IDS2 } = await Promise.resolve().then(() => (init_platforms(), platforms_exports));
+  const adapter = PLATFORM_IDS2.includes(platform) ? getAdapter2(platform) : void 0;
+  const filePath = extractFilePath(input, adapter);
   if (!filePath) return;
   const { openWorkbench: openWorkbench2 } = await Promise.resolve().then(() => (init_db(), db_exports));
   const { normalizeRelPath: normalizeRelPath2 } = await Promise.resolve().then(() => (init_artifact_commands(), artifact_commands_exports));
   const { reviewStatus: reviewStatus2 } = await Promise.resolve().then(() => (init_derive(), derive_exports));
   const { contractKinds: contractKinds2 } = await Promise.resolve().then(() => (init_kind(), kind_exports));
   const { logEvent: logEvent2 } = await Promise.resolve().then(() => (init_events(), events_exports));
-  const ctx = openWorkbench2(hookProjectDir());
+  const ctx = openWorkbench2(hookProjectDir(adapter));
   const mode = ctx.config.gates.writeGate;
   if (mode === "off") return;
   const rel = normalizeRelPath2(ctx, filePath);
@@ -4154,12 +4225,10 @@ async function writeGateHook(platform) {
     const msg = `\u8BE5\u6587\u4EF6\u662F\u5DF2\u5BA1\u6279\u5951\u7EA6(${artifact.kind}): ${rel}\u3002
 \u4FEE\u6539\u524D\u8BF7\u5148\u9886\u53D6\u5BF9\u5E94\u4EFB\u52A1:${ctx.config.cli} list --module=${artifact.module ?? ""} --status=pending
 \u9886\u53D6\u540E\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF WORKBENCH_TASK_ID=<\u4EFB\u52A1id> \u518D\u4FEE\u6539;\u82E5\u5BF9\u5185\u5BB9\u672C\u8EAB\u6709\u5F02\u8BAE,\u7528 dispute \u547D\u4EE4\u7559\u75D5\u5E76\u505C\u6B62\u3002`;
-    if (platform === "cursor") {
-      process.stdout.write(JSON.stringify({ permission: "deny", userMessage: msg, agentMessage: msg }));
-      process.exit(0);
-    }
-    console.error(msg);
-    process.exit(2);
+    const resp = adapter?.respondBlocked(msg) ?? { exitCode: 2, stderr: msg };
+    if (resp.stdout) process.stdout.write(resp.stdout);
+    if (resp.stderr) console.error(resp.stderr);
+    process.exit(resp.exitCode);
   }
 }
 var init_hook_pretooluse = __esm({
@@ -4178,13 +4247,15 @@ var hook_refresh_exports = {};
 __export(hook_refresh_exports, {
   refreshHook: () => refreshHook
 });
-async function refreshHook(_platform) {
+async function refreshHook(platform) {
   const input = await readStdinJson();
-  const filePath = extractFilePath(input);
+  const { getAdapter: getAdapter2, PLATFORM_IDS: PLATFORM_IDS2 } = await Promise.resolve().then(() => (init_platforms(), platforms_exports));
+  const adapter = platform && PLATFORM_IDS2.includes(platform) ? getAdapter2(platform) : void 0;
+  const filePath = extractFilePath(input, adapter);
   if (!filePath) return;
   const { openWorkbench: openWorkbench2 } = await Promise.resolve().then(() => (init_db(), db_exports));
   const { refreshArtifact: refreshArtifact2, normalizeRelPath: normalizeRelPath2 } = await Promise.resolve().then(() => (init_artifact_commands(), artifact_commands_exports));
-  const ctx = openWorkbench2(hookProjectDir());
+  const ctx = openWorkbench2(hookProjectDir(adapter));
   const rel = normalizeRelPath2(ctx, filePath);
   const exact = ctx.db.prepare("SELECT id FROM artifacts WHERE path = ?").get(rel);
   if (exact) {
@@ -4284,7 +4355,6 @@ function printTaskDetail(ctx, id) {
   }
   console.log();
 }
-var ALL_PLATFORMS = ["claude", "codex", "opencode", "cursor"];
 var PRIORITY_PROVIDERS = [
   "anthropic",
   "openai",
@@ -4330,7 +4400,7 @@ async function promptInit() {
   const zh = language === "zh";
   const platform = await select({
     message: zh ? "\u5E73\u53F0" : "Platform",
-    choices: ALL_PLATFORMS.map((p) => ({ name: p, value: p })),
+    choices: PLATFORM_IDS.map((p) => ({ name: p, value: p })),
     default: "claude"
   });
   const platforms = [platform];
@@ -4358,14 +4428,14 @@ async function promptInit() {
       choices: prov.models.map((m) => ({ name: m.name, value: m.id })),
       pageSize: 12
     });
-    if (modelId) modelObj[p] = p === "opencode" ? `${provId}/${modelId}` : modelId;
+    if (modelId) modelObj[p] = getAdapter(p).formatModel(provId, modelId);
   }
   return { platforms, endpoints, model: Object.keys(modelObj).length ? modelObj : void 0, language };
 }
 async function runInit(root, a) {
-  const { existsSync: existsSync15 } = await import("node:fs");
-  const { join: join17 } = await import("node:path");
-  if (existsSync15(join17(root, "workbench.config.json"))) {
+  const { existsSync: existsSync16 } = await import("node:fs");
+  const { join: join18 } = await import("node:path");
+  if (existsSync16(join18(root, "workbench.config.json"))) {
     console.log(chalk.red("\u9519\u8BEF: workbench.config.json \u5DF2\u5B58\u5728,init \u53EA\u7528\u4E8E\u7A7A\u9879\u76EE\u5F15\u5BFC(\u6539\u914D\u7F6E\u8BF7\u76F4\u63A5\u7F16\u8F91\u8BE5\u6587\u4EF6)"));
     process.exit(1);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dawipong/opcflow",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Spec-anchored, drift-enforced execution layer for AI coding agents — artifact DAG, trust gates, multi-role pipeline; generates agents/MCP/hooks for Claude Code, Codex, OpenCode & Cursor.",
   "license": "MIT",
   "author": "Dawi",

package/templates/agents/en/architect.md

@@ -29,7 +29,7 @@ tech selection (language / framework / ORM / build), directory structure per end
 | Artifact | Path |
 | --- | --- |
 | Database model definition | Per approved TECH.md conventions (path/tech set by the baseline) |
-| Database docs | {{PATH_DB_DOCS}}{module}.md |
+| Database docs | {{TPL_DB_DOC}} |
 | API contract docs | {{PATH_API_DOCS}}{endpoint}/{module}.md (cross-endpoint shared goes in common/) |
 | Technical baseline (changes go through review) | ARCHITECTURE.md / TECH.md |
 

package/templates/agents/en/designer.md

@@ -21,9 +21,9 @@ You are @designer. Each of your three artifacts travels a different trust channe
 
 | Artifact | Path | Trust channel |
 | --- | --- | --- |
-| Design system (one per endpoint) | {{PATH_DESIGN_SYSTEMS}}{endpoint}.md | **Human approval** (endpoint-level contract; one change makes every prototype for that endpoint stale) |
-| Page design prompt | {{PATH_DESIGN_PROMPTS}}{endpoint}/{module}/{page}.md | Register only (working draft, not submitted) |
-| HTML prototype | {{PATH_PROTOTYPES}}{endpoint}/{module}/{page}.html | **👍 = feedback + approval in one** (user releases after previewing in opcflow) |
+| Design system (one per endpoint) | {{TPL_DESIGN_SYSTEM}} | **Human approval** (endpoint-level contract; one change makes every prototype for that endpoint stale) |
+| Page design prompt | {{TPL_DESIGN_PROMPT}} | Register only (working draft, not submitted) |
+| HTML prototype | {{TPL_PROTOTYPE}} | **👍 = feedback + approval in one** (user releases after previewing in opcflow) |
 
 ## Workflow (page task)
 
@@ -37,7 +37,7 @@ You are @designer. Each of your three artifacts travels a different trust channe
 
 ## Endpoint Design-System Task (once per endpoint)
 
-Write to {{PATH_DESIGN_SYSTEMS}}{endpoint}.md (palette / spacing / font sizes / component forms / **that endpoint's hard constraints** — platform limits, component-library specs, etc. are all legislated here) → register → **submit for review**.
+Write to {{TPL_DESIGN_SYSTEM}} (palette / spacing / font sizes / component forms / **that endpoint's hard constraints** — platform limits, component-library specs, etc. are all legislated here) → register → **submit for review**.
 For endpoints that already have prototypes or production pages, **reverse-engineer** from the established facts (legislate, don't design from scratch); for a brand-new endpoint, propose an initial version from the approved baseline (the UI stack in TECH.md) and the project's positioning.
 
 ## Red Flags

package/templates/agents/en/developer.md

@@ -22,10 +22,10 @@ You are @developer. **Approved contract = implement directly, zero divergence**
 | Input | Path |
 | --- | --- |
 | Technical baseline (selection/directories/protocol conventions) | ARCHITECTURE.md / TECH.md |
-| Page PRD (incl. acceptance points) | {{PATH_PAGES}}{endpoint}/{module}/{page}.md |
+| Page PRD (incl. acceptance points) | {{TPL_PAGE_PRD}} |
 | API contract | {{PATH_API_DOCS}}{endpoint}/{module}.md |
-| DB docs | {{PATH_DB_DOCS}}{module}.md |
-| 👍-approved prototype (UI truth) | {{PATH_PROTOTYPES}}{endpoint}/{module}/{page}.html |
+| DB docs | {{TPL_DB_DOC}} |
+| 👍-approved prototype (UI truth) | {{TPL_PROTOTYPE}} |
 
 ## Code Directory Conventions (config-injected; follow when building code)
 

package/templates/agents/en/product-manager.md

@@ -25,9 +25,9 @@ You are @product-manager. Responsibility: translate requirements into **layer-by
 | Project overview | {{PATH_PROJECT}} | Project-level contract |
 | Role permission matrix | {{PATH_ROLES}} | Project-level contract |
 | Domain glossary | {{PATH_GLOSSARY}} | Project-level contract |
-| Business flow + entity state machine | {{PATH_FLOWS}}{module}.md | Module-level contract |
-| Module PRD | {{PATH_MODULES}}{module}.md | Module-level contract |
-| Page PRD | {{PATH_PAGES}}{endpoint}/{module}/{page}.md | Page-level contract |
+| Business flow + entity state machine | {{TPL_FLOW}} | Module-level contract |
+| Module PRD | {{TPL_MODULE_PRD}} | Module-level contract |
+| Page PRD | {{TPL_PAGE_PRD}} | Page-level contract |
 
 ## Core Discipline: Layer-by-Layer Confirmation
 

package/templates/agents/en/qa.md

@@ -20,7 +20,7 @@ You are @qa. **Judgment authority belongs to PM (acceptance points), execution a
 ## Two-Phase Acceptance
 
 **Phase one (before or after developer starts): translate acceptance criteria**
-Read the "acceptance points" section of the approved page PRD → translate into executable cases, write to {{PATH_ACCEPTANCE}}{endpoint}/{module}/{page}.md → register output → **submit for review** (it's a contract; developer writes against it).
+Read the "acceptance points" section of the approved page PRD → translate into executable cases, write to {{TPL_ACCEPTANCE}} → register output → **submit for review** (it's a contract; developer writes against it).
 When a point is ambiguous: **dispute or send back to PM**, do not fill in the wording yourself.
 
 **Phase two (after developer finishes): execute acceptance**

package/templates/agents/zh/architect.md

@@ -29,7 +29,7 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 | 产物 | 路径 |
 | --- | --- |
 | 数据库模型定义 | 按 approved TECH.md 的约定(路径/技术随基线定) |
-| 数据库文档 | {{PATH_DB_DOCS}}{模块}.md |
+| 数据库文档 | {{TPL_DB_DOC}} |
 | API 契约文档 | {{PATH_API_DOCS}}{端}/{模块}.md(跨端共用放 common/) |
 | 技术基线(变更走审批) | ARCHITECTURE.md / TECH.md |
 

package/templates/agents/zh/designer.md

@@ -21,9 +21,9 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 
 | 产物 | 路径 | 信任通道 |
 | --- | --- | --- |
-| 设计系统(每端一份) | {{PATH_DESIGN_SYSTEMS}}{端}.md | **人工审批**(端级契约,改一次全端原型 stale) |
-| 页面设计提示词 | {{PATH_DESIGN_PROMPTS}}{端}/{模块}/{页面}.md | 仅登记(工作底稿,不送审) |
-| HTML 原型 | {{PATH_PROTOTYPES}}{端}/{模块}/{页面}.html | **👍 = 反馈+审批合一**(用户在 opcflow 预览后放行) |
+| 设计系统(每端一份) | {{TPL_DESIGN_SYSTEM}} | **人工审批**(端级契约,改一次全端原型 stale) |
+| 页面设计提示词 | {{TPL_DESIGN_PROMPT}} | 仅登记(工作底稿,不送审) |
+| HTML 原型 | {{TPL_PROTOTYPE}} | **👍 = 反馈+审批合一**(用户在 opcflow 预览后放行) |
 
 ## 工作流程(页面任务)
 
@@ -37,7 +37,7 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 
 ## 端设计系统任务(每端一次)
 
-写入 {{PATH_DESIGN_SYSTEMS}}{端}.md(色板/间距/字号/组件形态/**该端硬约束**——平台限制、组件库规范等都在此立法)→ 登记 → **submit 送审**。
+写入 {{TPL_DESIGN_SYSTEM}}(色板/间距/字号/组件形态/**该端硬约束**——平台限制、组件库规范等都在此立法)→ 登记 → **submit 送审**。
 已有原型或生产页面的端,从既成事实**反向提炼**(立法,不凭空设计);全新的端,依据 approved 基线(TECH.md 的 UI 栈)与项目定位提出初版。
 
 ## Red Flags

package/templates/agents/zh/developer.md

@@ -22,10 +22,10 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 | 输入 | 路径 |
 | --- | --- |
 | 技术基线(选型/目录/协议约定) | ARCHITECTURE.md / TECH.md |
-| 页面 PRD(含验收要点) | {{PATH_PAGES}}{端}/{模块}/{页面}.md |
+| 页面 PRD(含验收要点) | {{TPL_PAGE_PRD}} |
 | API 契约 | {{PATH_API_DOCS}}{端}/{模块}.md |
-| DB 文档 | {{PATH_DB_DOCS}}{模块}.md |
-| 已 👍 原型(UI 真相) | {{PATH_PROTOTYPES}}{端}/{模块}/{页面}.html |
+| DB 文档 | {{TPL_DB_DOC}} |
+| 已 👍 原型(UI 真相) | {{TPL_PROTOTYPE}} |
 
 ## 代码目录约定(config 注入,建代码时遵守)
 

package/templates/agents/zh/product-manager.md

@@ -25,9 +25,9 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 | 项目全景 | {{PATH_PROJECT}} | 项目级契约 |
 | 角色权限矩阵 | {{PATH_ROLES}} | 项目级契约 |
 | 领域术语表 | {{PATH_GLOSSARY}} | 项目级契约 |
-| 业务流程+实体状态机 | {{PATH_FLOWS}}{模块}.md | 模块级契约 |
-| 模块 PRD | {{PATH_MODULES}}{模块}.md | 模块级契约 |
-| 页面 PRD | {{PATH_PAGES}}{端}/{模块}/{页面}.md | 页面级契约 |
+| 业务流程+实体状态机 | {{TPL_FLOW}} | 模块级契约 |
+| 模块 PRD | {{TPL_MODULE_PRD}} | 模块级契约 |
+| 页面 PRD | {{TPL_PAGE_PRD}} | 页面级契约 |
 
 ## 核心纪律:逐层确认制
 

package/templates/agents/zh/qa.md

@@ -20,7 +20,7 @@ tools: Read, Write, Edit, Glob, Grep, Bash
 ## 两段式验收
 
 **第一段(developer 开工前后皆可):翻译验收标准**
-读 approved 页面 PRD 的"验收要点"章节 → 翻译成可执行用例,写入 {{PATH_ACCEPTANCE}}{端}/{模块}/{页面}.md → output 登记 → **submit 送审**(它是契约,developer 对着它写)。
+读 approved 页面 PRD 的"验收要点"章节 → 翻译成可执行用例,写入 {{TPL_ACCEPTANCE}} → output 登记 → **submit 送审**(它是契约,developer 对着它写)。
 遇到要点含混:**dispute 或退回 PM**,禁止自行脑补口径。
 
 **第二段(developer 完成后):执行验收**