القائمة
基于 Graph 当前代码实现生成或重写说明文档。用户要求“给某个 Graph 写/重写 README、按既有风格成文、强调工作流与实现细节”时触发。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
将用户提供的项目碎片信息整理为结构化中文 Markdown 文档并落盘到 docs。触发于用户提供零散片段并要求成文时；完成后必须调用 doc-optimizer。
对既有 Markdown 文档做结构化增强与可读性优化，保持原意与作者语气不变。触发于用户要求“润色 / 优化 / 重写文档但不改含义”时。
基于用户指定的改动范围（默认当前工作区）分析上下游依赖并产出改动说明，按时间顺序增量写入 docs/CHANGELOG.md 最上方。用户要求“生成本次改动文档/更新记录/changelog”时触发。
将 service 层方法按项目既有规范包装为 Robyn router 并暴露 HTTP API。用户提出“给 service 包一层 router”“暴露 http 接口”“按 user router 风格补接口”时必须触发；适用于 user、figure_and_relation、fine_grained_feed、knowledge 等模块。
针对当前仓库执行指定改动范围的差异质检（默认当前工作区）。触发于用户要求审查本次改动、检查代码变更、review 代码、代码质检等场景。
session 收尾自动提炼经验并路由到 skill/rule/agent。触发条件：session 收尾、用户明确纠偏、稳定实践/重复错误/harness 资产缺口暴露。关键字：session 收尾、纠偏、经验落盘、知识沉淀、skill 更新、rule 更新、agent 更新、ESLint 规则新增。文件类型：.trae/skills/**、.trae/rules/**、.trae/agents/**、AGENTS.md、.eslintrc.*。使用场景：每次 session 结束前判断是否有长期可复用知识，落盘到最合适的资产或输出 No-op。
| name | graph-doc-writer |
| description | 基于 Graph 当前代码实现生成或重写说明文档。用户要求“给某个 Graph 写/重写 README、按既有风格成文、强调工作流与实现细节”时触发。 |
用于把某个 Graph 的实现（graph.py / state.py / nodes.py）整理成结构化中文 Markdown 说明文档，且文风对齐项目现有 Graph 文档（如 ConversationGraph、FRBuildingGraph）。
src/agents/graphs/<GraphName>/）。README.md，或其他 Graph 的 README）。src/.../README.md 或 docs/...）。graph.py、state.py、nodes.py）。若 README 与源码冲突，必须以源码为准，并在文档中按“当前实现”表述，禁止把未落地方案写成已实现事实。
先读实现，再读文档。
graph.py：节点、边、并行关系、编译与实例化方式。state.py：输入输出结构、关键 state 字段、合并语义（尤其 Annotated / MessagesState）。nodes.py：每个节点真实输入/输出、外部依赖、错误路径、日志、关键参数。抽取“可落文档事实清单”。
生成文档骨架（默认两层）。
# <GraphName>## 工作流设计：使用编号步骤（1,2,3...）描述端到端链路。## 关键实现策略：按模块拆分（如短期记忆、召回、落库、输出构建）。## 参数与边界（有必要时）。## 当前取舍（优点 / 成本，均需可追溯到代码）。工作流段落写作规范（强约束）。
nodeBuildAndTrimMessage）。实现策略段落写作规范（强约束）。
风格对齐（贴近现有 Graph README）。
输出与回检。
FRBuildingGraph / ConversationGraph README 读感一致。