# 目录 AGENTS.md 沉淀（实现类子 Agent）

## 适用范围

实现类子 Agent 收尾必遵，包括但不限于：

- `/kb-apply`、`/kb-revise-apply` 各 `T{n}` 实现任务
- `/kb-lite` 实现小改步骤
- 其他由主 Agent 派发的**写代码**子任务（非只读调研、非 Markdown 草案）

## 沉淀时机

**任务验收通过后、收尾阶段**执行：先完成实现与验收标准核对，再总结本次犯错经验，将可复用规矩写入目录 `AGENTS.md`。

## 落盘路径

- 写入**本次改动涉及目录**的 `AGENTS.md`：选最贴近改动文件的目录；该目录尚无文件则新建。
- 模块级约定不得违背客户端/服务端根 `AGENTS.md`（如 `vkk_client_flutter/AGENTS.md`、`rust_server/AGENTS.md`）；冲突时以根规范为准，目录 `AGENTS.md` 只补充本目录特有规矩。

## 术语对照（apply 沉淀）

apply/revise-apply 收尾沉淀须严格区分三类内容：

| 术语 | 含义 | 落点 |
|---|---|---|
| **代码规范**（同义：**目录编码规矩**） | 命名、分层、单文件行数、工具链命令、本目录代码模式 | apply/revise-apply 收尾**唯一**可写入子目录 `AGENTS.md` 的内容 |
| **业务逻辑** | 功能行为、状态流转、校验规则 | 写在**实现代码**中；**禁止**作为 AGENTS 沉淀对象 |
| **业务规格**（knowledge 级） | 接口契约、表结构、跨端对齐、Handler/SQL 一致性等 | **禁止**写入任何 `AGENTS.md`；回报 knowledge 落点由 `/kb-archive` 合并 |

## 沉淀分流（硬门禁）

apply/revise-apply 收尾沉淀须严格区分两类内容：

| 类型 | 落点 | 示例 |
|---|---|---|
| **代码规范（目录编码规矩）** | 最贴近改动文件的子目录 `AGENTS.md` | 命名、分层、单文件行数、工具链命令 |
| **knowledge 级业务规格** | **禁止**写入任何 `AGENTS.md` | Handler 字段/SQL 一致性、跨端 placeholder 对齐、接口契约、表结构、状态机 |

- **knowledge 级业务规格**尤其**禁止**写入各端根 `AGENTS.md`（`rust_server/AGENTS.md`、`vkk_client_flutter/AGENTS.md`、`quasar/AGENTS.md` 等）。
- kb-builder 收尾须在回报中列出「**建议 knowledge 落点**」（如 `knowledge/工程平台/Rust服务端/0N-*.md` 或对应业务域），由 `/kb-archive` 阶段 **kb-librarian** 合并；**不得**在 apply 阶段私自写入 `knowledge/`。
- 完整禁止项见 [kb-code-agents-spec.md#禁止写入](./kb-code-agents-spec.md#禁止写入)。

## 内容口径

**高度总结的规矩**，面向后续同类任务可直接执行。完整口径见 [kb-code-agents-spec.md](./kb-code-agents-spec.md)。

典型 ✅/❌ 示例：

- ✅ `StatelessWidget + mixin 拆分 build/生命周期，单文件 ≤300 行`
- ❌ `禁止在 mixin 内直接 ref.read 跨页面 Provider`
- ❌ `禁止为单次评审结论新建「评审沉淀(2026-xx-xx)」章节`

## 禁止

完整禁止项见 [kb-code-agents-spec.md](./kb-code-agents-spec.md#禁止写入)。摘要：流水账、评审编号罗列、复制 03/04 全文、knowledge 级业务规格。

## 主 Agent 派发要求

主 Agent 派发**实现类**子 Agent 时，prompt **必须**明确要求：

1. 验收通过后总结犯错经验
2. 将可复用规矩写入涉及目录 `AGENTS.md`
3. 遵守本 reference 的内容口径与禁止项

细则链接：[`kb-agents-precipitation.md`](kb-agents-precipitation.md)（相对 `references/` 或命令文件中的等价路径）。

## 与 `/create-rules` 的关系

精神一致：**一主题、简洁、可执行**；本 reference 专用于 KB 实现收尾闭环，不替代 Cursor Rules 的全局约束。

## 引用

- [kb-code-agents-spec.md](./kb-code-agents-spec.md) — 代码目录 `AGENTS.md` 内容口径 SSOT