# KB 工种 Agent 角色定义（SSOT）

> 各 `/kb-*` command 为工序 SSOT（步骤与验收）；本文件为**工种边界 SSOT**（谁能写什么）。`kb-admin` 细则见 [`agents/kb-admin.md`](../../../agents/kb-admin.md)。

## 三层模型

| 层 | 载体 | 职责 |
|---|---|---|
| 入口 | `/kb-*` command | 触发条件、工序步骤 |
| 调度 | `kb-admin` | stage 路由、闸门、组批、shell 复核 |
| 执行 | 下表工种 | 单一能力域落盘 |

单步 command 时：主 Agent 跳过 admin，直接派对应工种。

---

## kb-admin（调度员）

- **写入**：否
- **命令**：`/kb-orchestrator`
- **职责**：意图识别、stage 路由、派工种、external/git 闸门、shell 读盘复核
- **标准流 apply 后自动链**：`applied` → `kb-audit-apply` → `applied_audited` → **强制** kb-reviewer → review 通过后 **强制** kb-recorder（可执行 test）；`flow=lite` 豁免该链
- **下一跳 SSOT**：`scripts/kb-stage-next.mjs`（新建默认 `--intent new` → lite；已有变更 `--change-dir`）

---

## kb-scribe（文档员）

- **Agent 文件**：[`agents/kb-scribe.md`](../../../agents/kb-scribe.md)
- **写入**：`knowledge/变更/**` 内 `00`～`07`、反馈 `FB-*.md`、`00-manifest.json`（文档状态）
- **命令**：propose、lite(01)、design、plan、revise、repair(文档)、feedback
- **禁止**：业务代码、工程配置、`knowledge/` 业务域正文（归 librarian）

---

## kb-builder（实现员）

- **Agent 文件**：[`agents/kb-builder.md`](../../../agents/kb-builder.md)
- **写入**：业务代码、变更目录 manifest.tasks；目录 `AGENTS.md` 沉淀（规矩非流水账）
- **命令**：apply、revise-apply、lite(实现)
- **必遵**：CodeGraph 优先（项目级 MCP 已配置且硬门禁阶段 `codegraph_*` 可用）；目录 AGENTS 内容口径 SSOT：[kb-code-agents-spec.md](./kb-code-agents-spec.md)；沉淀闭环见 [kb-agents-precipitation.md](./kb-agents-precipitation.md)
- **边界**：实现收尾后交主 Agent/admin 写 `applied` 并进入 review；**不负责** review/test 验收链

---

## kb-reviewer（评审员）

- **Agent 文件**：[`agents/kb-reviewer.md`](../../../agents/kb-reviewer.md)
- **写入**：`04-review.md`、`manifest.reviews`（评审落盘时）
- **命令**：review、check（只读部分）
- **模式**：只读 CodeGraph + diff；full-review 可 6 路并行，可选 `bugbot` 一角
- **下一步**：通过后进入 `/kb-test`（kb-recorder），**不得**直接 archive

---

## kb-recorder（验收记录员）

- **Agent 文件**：[`agents/kb-recorder.md`](../../../agents/kb-recorder.md)
- **写入**：`06-automation-test.md`、`08-verify-issue.md`、变更 `auto_test/` 下 UI E2E/契约脚本（追溯 `03`）；成功时 `manifest.stage=tested`
- **命令**：test、verify-issue(08)
- **职责**：默认可执行验收（`03` / `auto_test/` / 明示命令）并写 `06`；分层 **ui>contract>unit**；失败不标 `tested`
- **禁止**：不写 **unit** 脚手架、不粘贴完整终端日志；Playwright/契约脚本仅在 test 阶段于 `auto_test/` 按需补写

---

## kb-librarian（知识库员）

- **Agent 文件**：[`agents/kb-librarian.md`](../../../agents/kb-librarian.md)
- **写入**：`knowledge/知识地图.md`、`knowledge/业务域/**`、`knowledge/工程平台/**`、索引 README；经 shell 写 `.kb/knowledge-utility.json`（bump）
- **命令**：sync、archive(步骤 6–7 + 10.5 utility)、index
- **写时演化**：构笔记 → 建链 → 邻接回写；可选 `status`/`supersedes`/`keywords`（[kb-knowledge-evolve.md](kb-knowledge-evolve.md)）
- **禁止**：变更目录 `01`～`07`（归 scribe）

---

## kb-release（发布员）

- **Agent 文件**：[`agents/kb-release.md`](../../../agents/kb-release.md)
- **写入**：git 白名单提交、`manifest.external`、目录 `mv` 迁移
- **命令**：archive(步骤 8–10)、archive-purge、commit、propose/lite 外部登记（可选）
- **顺序**：迁移 → commit+push → 外部 sync 步骤 10（integrations 启用且有 registry_record_id 时）；批清见 `/kb-archive-purge`

---

## kb-inspector（巡检员）

- **Agent 文件**：[`agents/kb-inspector.md`](../../../agents/kb-inspector.md)
- **写入**：仅 `.kb/knowledge-utility.json`（经 `kb-knowledge-utility.mjs` bump/penalize）；evolve 写流程文件时另派 scribe
- **命令**：explore、query、health、check；query 后 rank/bump
- **工具**：知识索引 → CodeGraph（项目级 MCP；不可用时报阻断或警告，见 [kb-codegraph.md](./kb-codegraph.md) §二）→ 具体文件；仓外/时效可用 `web_search`（Pi，见 [kb-deepseek-search.md](./kb-deepseek-search.md)）

---

## 命令 → 工种速查

| 命令 | 工种 |
|---|---|
| `/kb-orchestrator` | admin → 再派工种 |
| `/kb-propose`、`/kb-design`、`/kb-plan`、`/kb-revise` | scribe（+ release 登记） |
| `/kb-apply`、`/kb-revise-apply` | builder（标准流全部通过后由 admin 强制串联 reviewer → recorder） |
| `/kb-review` | reviewer |
| `/kb-test`、`/kb-verify-issue` | recorder（+ release 外部 sync，可选；标准流 review 后强制 test） |
| `/kb-archive` | librarian + release |
| `/kb-archive-purge` | release（或 admin） |
| `/kb-sync`、`/kb-index` | librarian |
| `/kb-commit` | release |
| `/kb-explore`、`/kb-query`、`/kb-health` | inspector |
| `/kb-feedback` | scribe |
| `/kb-evolve` | inspector（提案）+ scribe（落盘） |

用户-facing 场景示例见 `knowledge/工程平台/KB工作流/使用文档/`。