agentic-flow-kit 1.8.7 → 2.0.0

package/templates/hosts/cline/hooks/PreToolUse.cjs

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+'use strict';
+/**
+ * Cline 宿主 → 仓库既有 .cjs 门禁的协议适配层（本机私有，.cline/ 已 gitignore）。
+ *
+ * 单源纪律：判据仍只养在 .agents/hooks/*.cjs（gates.json / pre-shell-check.cjs /
+ * pre-write-check.cjs）；本文件只做字段映射、进程调用与结果翻译，不复制任何判据。
+ * 参照先例：.pi/extensions/lib/gates-core.cjs（PI 宿主同型适配层）。
+ *
+ * 协议差异（实证来源：解包本机 cline CLI @cline/core）：
+ *   - Cline stdin：{ hookName:"tool_call", tool_call:{id,name,input}, preToolUse:{toolName,parameters},
+ *     workspaceRoots:[...], taskId, iteration, ... }（parameters 为字符串化 JSON，input 为原始对象）
+ *   - 仓库 hook stdin：{ tool_name, llm_tool_name, tool_input, cwd, workspace_roots,
+ *     hook_event_name:"PreToolUse" }（见 pre-shell-check.cjs:22-24 / pre-write-check.cjs:30）
+ *   - 仓库 hook stdout：{ hookSpecificOutput:{ permissionDecision:"deny"/"ask"/"allow",
+ *     permissionDecisionReason } }；无输出 = 放行
+ *   - Cline 控制输出：stdout JSON { cancel:true, cancelReason } 或 { review:true, context }，
+ *     推荐加 "HOOK_CONTROL\t" 前缀行（E3() 只取该前缀行并 JSON.parse，K3() 消费）
+ *
+ * 工具名归一（Cline → 仓库正则）：
+ *   - run_commands → bash（pre-shell-check.cjs:48-49 认 runcommand|bash|powershell|shell|terminal|executecommand）
+ *   - editor / apply_patch → write（pre-write-check.cjs:61 认 edit|write|multiedit|search_replace）
+ *
+ * 可运行自检：node .cline/hooks/PreToolUse.cjs --selftest
+ */
+const { spawnSync } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const TIMEOUT_MS = 30000;
+const ROOT = path.resolve(__dirname, '..', '..'); // .cline/hooks → 仓库根
+
+// Cline 工具名 → 仓库 hook 工具名（喂给 .agents/hooks/*.cjs 的 tool_name）
+const GATE_TOOL_ALIAS = {
+  run_commands: 'bash',
+  editor: 'write',
+  apply_patch: 'write',
+};
+
+// 该工具名是否属于「命令门」范畴（shell 家族）
+const SHELL_TOOLS = new Set(['run_commands', 'bash', 'execute_command', 'shell', 'terminal']);
+// 该工具名是否属于「写前门」范畴
+const WRITE_TOOLS = new Set(['editor', 'apply_patch', 'write', 'edit', 'multiedit', 'replace_in_file', 'write_to_file']);
+
+function readStdin() {
+  try {
+    return fs.readFileSync(0, 'utf8');
+  } catch {
+    return '';
+  }
+}
+
+// 从 Cline payload 提取 tool_call 名称与原始 input 对象
+function extractToolCall(payload) {
+  if (!payload || typeof payload !== 'object') return { name: '', input: {} };
+  const tc = payload.tool_call && typeof payload.tool_call === 'object' ? payload.tool_call : {};
+  const ptu = payload.preToolUse && typeof payload.preToolUse === 'object' ? payload.preToolUse : {};
+  const name = typeof tc.name === 'string' && tc.name ? tc.name
+    : typeof ptu.toolName === 'string' && ptu.toolName ? ptu.toolName : '';
+  // input 优先用原始对象；若只有字符串化 parameters（部分宿主变体）则尝试 JSON 解析
+  let input = tc.input && typeof tc.input === 'object' ? tc.input : {};
+  if (!input || typeof input !== 'object') {
+    const raw = ptu.parameters;
+    if (typeof raw === 'string' && raw.trim()) {
+      try { input = JSON.parse(raw); } catch { input = {}; }
+    }
+  }
+  return { name, input: input && typeof input === 'object' ? input : {} };
+}
+
+// 从 Cline tool_call.input 提取命令文本（run_commands 的 input 是 {command} 或 {commands:[]} 或 {cmd}）
+function extractCommand(input) {
+  if (!input || typeof input !== 'object') return '';
+  if (typeof input.command === 'string') return input.command;
+  if (typeof input.cmd === 'string') return input.cmd;
+  if (Array.isArray(input.commands)) {
+    return input.commands.filter((c) => typeof c === 'string').join('\n');
+  }
+  // 兜底：扫全部字符串值，拼接（与 pre-shell-check.cjs 的 extractCommand 行为一致）
+  return Object.values(input)
+    .filter((v) => typeof v === 'string')
+    .join(' ');
+}
+
+// 构造仓库 hook 需要的 stdin payload
+function toRepoPayload(gateTool, input, cwd) {
+  const i = input && typeof input === 'object' ? input : {};
+  return {
+    session_id: 'cline-host',
+    transcript_path: '',
+    cwd,
+    permission_mode: 'default',
+    hook_event_name: 'PreToolUse',
+    tool_name: gateTool,
+    llm_tool_name: gateTool,
+    workspace_roots: [cwd],
+    tool_input: i,
+  };
+}
+// 调用仓库 hook，返回 { decision, reason, context }（无输出 = allow）
+function callRepoHook(script, payload) {
+  const r = spawnSync(process.execPath, [script], {
+    input: JSON.stringify(payload),
+    encoding: 'utf8',
+    timeout: TIMEOUT_MS,
+    cwd: ROOT,
+  });
+  if (r.error) {
+    return { decision: 'allow', reason: `仓库 hook 调用失败（${r.error.message}），放行` };
+  }
+  const out = (r.stdout || '').trim();
+  if (!out) return { decision: 'allow', reason: '' };
+  try {
+    const parsed = JSON.parse(out);
+    const hso = parsed && typeof parsed === 'object' && parsed.hookSpecificOutput
+      ? parsed.hookSpecificOutput
+      : parsed;
+    const decision = hso.permissionDecision || 'allow';
+    return {
+      decision,
+      reason: hso.permissionDecisionReason || hso.reason || '',
+      context: hso.additionalContext || '',
+    };
+  } catch {
+    return { decision: 'allow', reason: '' };
+  }
+}
+
+// 把仓库结果翻译成 Cline 控制输出（HOOK_CONTROL\t{json}）
+function emitControl(control) {
+  process.stdout.write(`HOOK_CONTROL\t${JSON.stringify(control)}\n`);
+}
+
+function main() {
+  const raw = readStdin();
+  if (!raw.trim()) return; // 无 payload，放行
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    return; // 解析失败，放行
+  }
+
+  const { name, input } = extractToolCall(payload);
+  const cwd = Array.isArray(payload.workspaceRoots) && payload.workspaceRoots[0]
+    ? payload.workspaceRoots[0]
+    : ROOT;
+
+  // 命令门：只认 shell 家族工具名（Cline run_commands → bash）
+  if (SHELL_TOOLS.has(name)) {
+    const command = extractCommand(input);
+    if (!command) return; // 无命令文本，放行
+    const shellPayload = toRepoPayload('bash', { command }, cwd);
+    const { decision, reason } = callRepoHook(
+      path.join(ROOT, '.agents', 'hooks', 'pre-shell-check.cjs'),
+      shellPayload
+    );
+    if (decision === 'deny') {
+      emitControl({ cancel: true, cancelReason: reason || '命令被仓库门禁拒绝' });
+    } else if (decision === 'ask') {
+      emitControl({ review: true, context: reason || '命令需要用户确认' });
+    }
+    return;
+  }
+
+  // 写前门：只认编辑器家族工具名（Cline editor/apply_patch → write）
+  if (WRITE_TOOLS.has(name)) {
+    const filePath = typeof input.path === 'string' ? input.path : '';
+    if (!filePath) return; // 无文件路径，放行
+    const writeInput = {
+      file_path: filePath,
+      content: input.new_text || '',
+      old_string: input.old_text || undefined,
+      new_string: input.new_text || undefined,
+    };
+    if (typeof input.insert_line === 'number' && Number.isInteger(input.insert_line)) {
+      writeInput.edits = [{ insert_line: input.insert_line, new_string: input.new_text || '' }];
+    }
+    const writePayload = toRepoPayload('write', writeInput, cwd);
+    const { decision, reason, context } = callRepoHook(
+      path.join(ROOT, '.agents', 'hooks', 'pre-write-check.cjs'),
+      writePayload
+    );
+    if (decision === 'deny') {
+      emitControl({ cancel: true, cancelReason: reason || '写入被仓库门禁拒绝' });
+    } else if (decision === 'ask') {
+      emitControl({ review: true, context: reason || '写入需要用户确认' });
+    } else if (context) {
+      emitControl({ context });
+    }
+    return;
+  }
+
+  // 非门禁工具（read_files / search_codebase / skills 等），放行
+}
+// ── 自检 ────────────────────────────────────────────
+// 用子进程喂模拟 payload，验证字段映射与翻译（不触碰仓库文件）。
+function runWithPayload(payload) {
+  const r = spawnSync(process.execPath, [__filename], {
+    input: JSON.stringify(payload),
+    encoding: 'utf8',
+    timeout: TIMEOUT_MS,
+    cwd: ROOT,
+    env: { ...process.env, CLINE_HOOK_SELFTEST: '1' },
+  });
+  return (r.stdout || '') + (r.stderr || '');
+}
+
+function selfTest() {
+  const cases = [
+    {
+      name: 'run_commands deny → cancel',
+      payload: { hookName: 'tool_call', tool_call: { name: 'run_commands', input: { command: 'git reset --hard' } }, workspaceRoots: [ROOT] },
+      expect: 'cancel',
+    },
+    {
+      name: 'run_commands ask → review',
+      payload: { hookName: 'tool_call', tool_call: { name: 'run_commands', input: { command: 'git checkout main' } }, workspaceRoots: [ROOT] },
+      expect: 'review',
+    },
+    {
+      name: 'run_commands allow → silent',
+      payload: { hookName: 'tool_call', tool_call: { name: 'run_commands', input: { command: 'git status' } }, workspaceRoots: [ROOT] },
+      expect: 'silent',
+    },
+    {
+      name: 'editor 写 .agents 保护面 → cancel',
+      payload: { hookName: 'tool_call', tool_call: { name: 'editor', input: { path: path.join(ROOT, '.agents', 'hooks', 'gates.json'), new_text: '{}' } }, workspaceRoots: [ROOT] },
+      expect: 'cancel',
+    },
+    {
+      name: 'read_files 放行 → silent',
+      payload: { hookName: 'tool_call', tool_call: { name: 'read_files', input: { files: [path.join(ROOT, 'AGENTS.md')] } }, workspaceRoots: [ROOT] },
+      expect: 'silent',
+    },
+  ];
+  let failed = 0;
+  for (const c of cases) {
+    const out = runWithPayload(c.payload);
+    const isCancel = out.includes('"cancel":true');
+    const isReview = out.includes('"review":true');
+    const silent = out.trim() === '';
+    let ok = false;
+    if (c.expect === 'cancel') ok = isCancel;
+    else if (c.expect === 'review') ok = isReview;
+    else if (c.expect === 'silent') ok = silent;
+    console.log(`${ok ? '✅' : '❌'} ${c.name}（期望 ${c.expect}）`);
+    if (!ok) {
+      console.log('   输出: ' + JSON.stringify(out));
+      failed++;
+    }
+  }
+  process.exit(failed ? 1 : 0);
+}
+
+if (process.argv.includes('--selftest')) {
+  selfTest();
+} else {
+  main();
+}

package/templates/hosts/cline/workflows/wf-deploy.md

@@ -0,0 +1,8 @@
+---
+name: wf-deploy
+description: Deploy 阶段:合入清单(静态门 + 配对检查 + 回归 + DB + 授权 + PR 审查合并)
+---
+
+权威命令：`.agents/commands/deploy.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。

package/templates/hosts/cline/workflows/wf-maintain.md

@@ -0,0 +1,8 @@
+---
+name: wf-maintain
+description: Maintain 阶段:立 incident + 复盘三件套(修复 / 防复发 / 规范条目)
+---
+
+权威命令：`.agents/commands/maintain.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。

package/templates/hosts/cline/workflows/wf-new-task.md

@@ -0,0 +1,8 @@
+---
+name: wf-new-task
+description: AI-Native 闭环总入口(按风险定级路由):L1 走快速道(plan 即可动手);L2/L3 走四章阶段流
+---
+
+权威命令：`.agents/commands/new-task.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。

package/templates/hosts/cline/workflows/wf-pipeline-run.md

@@ -0,0 +1,8 @@
+---
+name: wf-pipeline-run
+description: pipeline-run 自动化驱动入口——单命令驱动六阶段闭环（工单协议+机器门+原话代录）
+---
+
+权威命令：`.agents/commands/pipeline-run.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。

package/templates/hosts/cline/workflows/wf-pr-review.md

@@ -0,0 +1,8 @@
+---
+name: wf-pr-review
+description: PR 面板评审（手动工具）——多子代理找 bug + 独立投票 + 台账；自动门已退役，按需手动跑
+---
+
+权威命令：`.agents/commands/pr-review.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。

package/templates/hosts/cline/workflows/wf-review.md

@@ -0,0 +1,8 @@
+---
+name: wf-review
+description: 代码评审标准（按风险分级：机器兜底 + AI 自查出清单，用户决策定性和合入）
+---
+
+权威命令：`.agents/commands/review.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。

package/templates/hosts/cline/workflows/wf-stages.md

@@ -0,0 +1,8 @@
+---
+name: wf-stages
+description: L2/L3 阶段流:Plan 立 intent → Design 起 spec → Build 起 plan + 实现 → Test 静态门 + UI 实测 + 复核关单(L1 走 wf-new-task)
+---
+
+权威命令：`.agents/commands/stages.md`（四章 Plan → Design → Build → Test，按当前阶段进对应章）
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。

package/templates/hosts/codebuddy/CODEBUDDY.md

@@ -0,0 +1,7 @@
+# 项目记忆
+
+唯一权威：根 `AGENTS.md`（开工前完整读取）。宿主面见本目录 `commands/`、`agents/`、`rules/`；hook 只接线（本目录 `settings.json`）指向 `.agents/hooks/`，宿主层不养脚本（2026-10-29 单源指示）。
+
+- 动 `backend/`、`frontend/` 前先读其 `AGENTS.md`（惰性加载）。
+- 根目录**禁止**放 `CODEBUDDY.md`（优先于 `AGENTS.md` 且不合并，落根即顶掉权威）。
+- 中文唯一语言；提交遵循 Conventional Commits 中文。

package/templates/hosts/codebuddy/agents/implementer.md

@@ -0,0 +1,9 @@
+---
+name: implementer
+description: Implements an approved, tightly scoped code change or test when the task includes owned files and executable acceptance criteria
+tools: Read, Glob, Grep, Edit, Write, Bash, LSP
+---
+
+# Implementer
+
+公共角色契约：`.agents/roles/implementer.md`。本文件只保留宿主 frontmatter。

package/templates/hosts/codebuddy/agents/independent-reviewer.md

@@ -0,0 +1,10 @@
+---
+name: independent-reviewer
+description: Independently reviews a fixed spec, plan, or code diff for correctness and project-rule violations without modifying files
+tools: Read, Glob, Grep
+disallowedTools: Edit, Write, Bash
+---
+
+# Independent Reviewer
+
+公共角色契约：`.agents/roles/independent-reviewer.md`。本文件只保留宿主 frontmatter。

package/templates/hosts/codebuddy/agents/pr-adjudicator.md

@@ -0,0 +1,10 @@
+---
+name: pr-adjudicator
+description: PR 面板评审的只读裁决者；处理 escalated 候选并返回裁决
+tools: Read, Glob, Grep
+disallowedTools: Edit, Write, Bash
+---
+
+# PR Adjudicator
+
+公共角色契约：`.agents/roles/pr-adjudicator.md`。本文件只保留宿主 frontmatter。

package/templates/hosts/codebuddy/agents/pr-finder.md

@@ -0,0 +1,10 @@
+---
+name: pr-finder
+description: PR 面板评审的只读 finder；按镜头独立找 bug，返回候选 JSON
+tools: Read, Glob, Grep
+disallowedTools: Edit, Write, Bash
+---
+
+# PR Finder
+
+公共角色契约：`.agents/roles/pr-finder.md`。本文件只保留宿主 frontmatter。

package/templates/hosts/codebuddy/agents/pr-verifier.md

@@ -0,0 +1,10 @@
+---
+name: pr-verifier
+description: PR 面板评审的只读 verifier；独立验证单条候选并返回票 JSON
+tools: Read, Glob, Grep
+disallowedTools: Edit, Write, Bash
+---
+
+# PR Verifier
+
+公共角色契约：`.agents/roles/pr-verifier.md`。本文件只保留宿主 frontmatter。

package/templates/hosts/codebuddy/agents/ui-verifier.md

@@ -0,0 +1,11 @@
+---
+name: ui-verifier
+description: Runs browser-based verification for an implemented UI change and returns reproducible evidence without editing repository files
+tools: Read, Glob, Grep, Bash, Skill
+mcpServers: [chrome-devtools]
+disallowedTools: Edit, Write
+---
+
+# UI Verifier
+
+公共角色契约：`.agents/roles/ui-verifier.md`。本文件只保留宿主 frontmatter。

package/templates/hosts/codebuddy/agents/wiki-compiler.md

@@ -0,0 +1,10 @@
+---
+name: wiki-compiler
+description: Translates a code commit into strict JSON describing what business capability the system gained, written for non-coding readers (product/customer service); read-only analysis, never edits files
+tools: Read, Glob, Grep, Bash
+disallowedTools: Edit, Write
+---
+
+# Wiki Compiler
+
+公共角色契约：`.agents/roles/wiki-compiler.md`。本文件只保留宿主 frontmatter。

package/templates/hosts/codebuddy/commands/wf-deploy.md

@@ -0,0 +1,10 @@
+---
+description: Deploy 阶段:合入清单(静态门 + 配对检查 + 回归 + DB + 授权 + PR 审查合并)
+argument-hint: "[发布范围/版本]"
+---
+
+权威命令：`.agents/commands/deploy.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。
+
+用户随命令附带的参数（`$ARGUMENTS`）一并带入权威命令执行。

package/templates/hosts/codebuddy/commands/wf-maintain.md

@@ -0,0 +1,10 @@
+---
+description: Maintain 阶段:立 incident + 复盘三件套(修复 / 防复发 / 规范条目)
+argument-hint: "[问题现象]"
+---
+
+权威命令：`.agents/commands/maintain.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。
+
+用户随命令附带的参数（`$ARGUMENTS`）一并带入权威命令执行。

package/templates/hosts/codebuddy/commands/wf-new-task.md

@@ -0,0 +1,10 @@
+---
+description: AI-Native 闭环总入口:6 阶段指令索引(Plan→Design→Build→Test→Deploy→Maintain)
+argument-hint: "[需求描述]"
+---
+
+权威命令：`.agents/commands/new-task.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。
+
+用户随命令附带的参数（`$ARGUMENTS`）一并带入权威命令执行。

package/templates/hosts/codebuddy/commands/wf-pipeline-run.md

@@ -0,0 +1,10 @@
+---
+description: pipeline-run 自动化驱动入口——单命令驱动六阶段闭环（工单协议+机器门+原话代录）
+argument-hint: "[工单/需求描述]"
+---
+
+权威命令：`.agents/commands/pipeline-run.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。
+
+用户随命令附带的参数（`$ARGUMENTS`）一并带入权威命令执行。

package/templates/hosts/codebuddy/commands/wf-pr-review.md

@@ -0,0 +1,10 @@
+---
+description: PR 面板评审（手动工具）——多子代理找 bug + 独立投票 + 台账；自动门已退役，按需手动跑
+argument-hint: "[评审范围]"
+---
+
+权威命令：`.agents/commands/pr-review.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。
+
+用户随命令附带的参数（`$ARGUMENTS`）一并带入权威命令执行。

package/templates/hosts/codebuddy/commands/wf-review.md

@@ -0,0 +1,10 @@
+---
+description: 代码评审标准（按风险分级：机器兜底 + AI 自查出清单，用户决策定性和合入）
+argument-hint: "[评审范围]"
+---
+
+权威命令：`.agents/commands/review.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。
+
+用户随命令附带的参数（`$ARGUMENTS`）一并带入权威命令执行。

package/templates/hosts/codebuddy/commands/wf-stages.md

@@ -0,0 +1,10 @@
+---
+description: L2/L3 阶段流:Plan 立 intent → Design 起 spec → Build 起 plan + 实现 → Test 静态门 + UI 实测 + 复核关单(L1 走 wf-new-task)
+argument-hint: "[需求/契约要点]"
+---
+
+权威命令：`.agents/commands/stages.md`（四章 Plan → Design → Build → Test，按当前阶段进对应章）
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。
+
+用户随命令附带的参数（`$ARGUMENTS`）一并带入权威命令执行。

package/templates/hosts/codebuddy/rules/backend-scope.md

@@ -0,0 +1,5 @@
+---
+description: 后端改动必读 backend/AGENTS.md
+alwaysApply: true
+---
+修改或评审 `backend/` 下任何文件前，必须先 Read 并遵守 `backend/AGENTS.md`（含 §6 数据完整性/API 契约/数据库操作硬约束）。

package/templates/hosts/codebuddy/rules/frontend-scope.md

@@ -0,0 +1,5 @@
+---
+description: 前端改动必读 frontend/AGENTS.md
+alwaysApply: true
+---
+修改或评审 `frontend/` 下任何文件前，必须先 Read 并遵守 `frontend/AGENTS.md`（含 BC/G 门禁与 Never 规则）。

package/templates/hosts/codebuddy/settings.json

@@ -0,0 +1,31 @@
+{
+  "worktree": {
+    "symlinkDirectories": [
+      "frontend/node_modules"
+    ]
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CODEBUDDY_PROJECT_DIR\"/.agents/hooks/pre-write-check.cjs",
+            "timeout": 120
+          }
+        ]
+      },
+      {
+        "matcher": "Bash|PowerShell|RunCommand|Shell|Terminal",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CODEBUDDY_PROJECT_DIR\"/.agents/hooks/pre-shell-check.cjs",
+            "timeout": 800
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/hosts/codebuddy/skills/tfs-pr/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: tfs-pr
+description: 内网自托管 TFS / Azure DevOps Server PR 技能，项目无关：自动识别 git 仓库与远端推导 collection/project/repo，PAT 缺失时引导创建并保存环境变量；查 PR / 建 PR（context 拉 diff 提炼标题与描述）/ 改 PR 描述 / 冲突预检与 worktree 隔离解决，走 REST API + PAT（az devops 扩展拒 http 组织 URL，az 不可用）。命令入口 .agents/skills/tfs-pr/scripts/tfs-pr.mjs。
+---
+
+权威技能：`.agents/skills/tfs-pr/SKILL.md`。本文件是指针壳，执行时读取权威源，不在此复制正文。

package/templates/hosts/commandcode/agents/implementer.md

@@ -0,0 +1,10 @@
+---
+name: implementer
+description: Implements an approved, tightly scoped code change or test when the task includes owned files and executable acceptance criteria
+tools: read_file, grep, glob, read_directory, edit_file, write_file, shell_command
+permissionMode: accept-edits
+---
+
+# Implementer
+
+公共角色契约：`.agents/roles/implementer.md`。本文件只保留宿主 frontmatter（`.commandcode/` 不入库，模型可在此固定）。

package/templates/hosts/commandcode/agents/independent-reviewer.md

@@ -0,0 +1,9 @@
+---
+name: independent-reviewer
+description: Independently reviews a fixed spec, plan, or code diff for correctness and project-rule violations without modifying files
+tools: read_file, grep, glob, read_directory
+---
+
+# Independent Reviewer
+
+公共角色契约：`.agents/roles/independent-reviewer.md`。本文件只保留宿主 frontmatter（`.commandcode/` 不入库）。

package/templates/hosts/commandcode/agents/pr-adjudicator.md

@@ -0,0 +1,9 @@
+---
+name: pr-adjudicator
+description: PR 面板评审的只读裁决者；处理 escalated 候选并返回裁决
+tools: read_file, grep, glob, read_directory
+---
+
+# PR Adjudicator
+
+公共角色契约：`.agents/roles/pr-adjudicator.md`。本文件只保留宿主 frontmatter（`.commandcode/` 不入库）。

package/templates/hosts/commandcode/agents/pr-finder.md

@@ -0,0 +1,9 @@
+---
+name: pr-finder
+description: PR 面板评审的只读 finder；按镜头独立找 bug，返回候选 JSON
+tools: read_file, grep, glob, read_directory
+---
+
+# PR Finder
+
+公共角色契约：`.agents/roles/pr-finder.md`。本文件只保留宿主 frontmatter（`.commandcode/` 不入库）。

package/templates/hosts/commandcode/agents/pr-verifier.md

@@ -0,0 +1,9 @@
+---
+name: pr-verifier
+description: PR 面板评审的只读 verifier；独立验证单条候选并返回票 JSON
+tools: read_file, grep, glob, read_directory
+---
+
+# PR Verifier
+
+公共角色契约：`.agents/roles/pr-verifier.md`。本文件只保留宿主 frontmatter（`.commandcode/` 不入库）。

package/templates/hosts/commandcode/agents/ui-verifier.md

@@ -0,0 +1,11 @@
+---
+name: ui-verifier
+description: Runs browser-based verification for an implemented UI change and returns reproducible evidence without editing repository files
+tools: "*"
+disallowedTools: edit_file, write_file
+---
+
+# UI Verifier
+
+公共角色契约：`.agents/roles/ui-verifier.md`。本文件只保留宿主 frontmatter（`.commandcode/` 不入库）。
+浏览器面依赖用户级 MCP `chrome-devtools`（`~/.commandcode/mcp.json`），未配时按 skill 内降级口径执行。

package/templates/hosts/commandcode/agents/wiki-compiler.md

@@ -0,0 +1,10 @@
+---
+name: wiki-compiler
+description: Translates a code commit into strict JSON describing what business capability the system gained, written for non-coding readers (product/customer service); read-only analysis, never edits files
+tools: read_file, grep, glob, read_directory, shell_command
+disallowedTools: edit_file, write_file
+---
+
+# Wiki Compiler
+
+公共角色契约：`.agents/roles/wiki-compiler.md`。本文件只保留宿主 frontmatter（`.commandcode/` 不入库）。

package/templates/hosts/commandcode/commands/wf-deploy.md

@@ -0,0 +1,9 @@
+---
+description: Deploy 阶段：合入清单（静态门 + 配对检查 + 回归 + DB + 授权 + PR 审查合并）
+---
+
+权威命令：`.agents/commands/deploy.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。
+
+用户随命令附带的参数：$ARGUMENTS

package/templates/hosts/commandcode/commands/wf-maintain.md

@@ -0,0 +1,9 @@
+---
+description: Maintain 阶段：立 incident + 复盘三件套（修复 / 防复发 / 规范条目）
+---
+
+权威命令：`.agents/commands/maintain.md`
+
+本文件是指针壳。执行时读取权威源，不在此复制正文。
+
+用户随命令附带的参数：$ARGUMENTS