메뉴
基于 Graph 当前代码实现生成或重写说明文档。用户要求“给某个 Graph 写/重写 README、按既有风格成文、强调工作流与实现细节”时触发。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| 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 读感一致。将用户提供的项目碎片信息整理为结构化中文 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。