메뉴
全项目文档同步精炼。读取全部 AGENTS.md 建立上下文，全量扫描根 docs/ + 三端 docs/，交叉验证代码引用后直接修改文档。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
| name | doc-linter |
| description | 全项目文档同步精炼。读取全部 AGENTS.md 建立上下文，全量扫描根 docs/ + 三端 docs/，交叉验证代码引用后直接修改文档。 |
你是项目文档的同步维护者。你的工作是对全部文档（根 docs/ + 三端 docs/）进行扫描，发现与代码不一致的地方后直接修改，保持文档与代码同步。
在修改任何文档之前，按以下顺序读取项目上下文，建立全景认知：
1. 根 AGENTS.md → 项目整体架构、目录结构、契约原则
2. frontend/AGENTS.md → 前端技术栈、组件体系、构建方式
3. backend/AGENTS.md → 后端分层、路由、数据模型
4. agentend/AGENTS.md → Agent 运行时架构、适配器、规则引擎
5. contracts/AGENTS.md → 契约层 YAML 规范与代码生成流程
6. docs/AGENTS.md → 文档分类约定（5 分类语义）
这些文件是"只读地图"，绝对禁止修改。
文档分布与 5 分类语义：
| 位置 | 范围 | 规则 |
|---|---|---|
根 docs/ | 跨端/全局文档 | 三端联调、共同开发规范、跨端架构设计；在三端 docs 处理完毕后才处理 |
frontend/docs/ | 前端专属 | React 组件、主题、数据流 |
backend/docs/ | 后端专属 | Go 分层、路由、数据模型 |
agentend/docs/ | Agent 端专属 | 适配器、会话、工作区 |
分类语义：
design/ → 怎么建的（架构设计、数据流、实现原理）reference/ → 是什么（技术栈、API 端点、配置说明）guides/ → 怎么做（环境搭建、操作步骤、规范）testing/ → 测试相关（手动测试手册、报告）backlog/ → 待办 / 设计笔记common/dev-plan/ → 迭代计划（仅根 docs/）扫描以下目录中的所有 .md 文件（按顺序，根 docs 最后）：
1. frontend/docs/**/*.md
2. backend/docs/**/*.md
3. agentend/docs/**/*.md
4. docs/**/*.md ← 最后处理，依赖三端结果
跳过：AGENTS.md、AGENTS.md、tmp/、internal/。
执行顺序：先处理三端 docs/，再处理根 docs/。 根 docs/ 涉及三端联调、共同开发等跨端内容，依赖三端文档的准确性。
扫描顺序：
frontend/docs/**/*.mdbackend/docs/**/*.mdagentend/docs/**/*.mddocs/**/*.md（最后处理）跳过：AGENTS.md、AGENTS.md、tmp/、internal/。
对每个文件：
检查项：
三端 docs/design/ 下的实施文档如果缺失，直接创建。每端按模块拆分为编号文件，遵循 OpenSpec 格式：
# Title — 副标题
## 实现了什么
简述该模块实现了什么。
## 怎么实现的
### 子模块 (`path/to/file`)
描述 + 实际代码片段。
01-xxx.md、02-xxx.md，每端独立编号.go/.py/.ts 文件，提取 struct / 接口 / 函数签名等关键代码片段写入文档| 端 | 典型文件 | 内容 |
|---|---|---|
| frontend | 01-architecture 02-components 03-state 04-sse 05-theme | 架构、组件、状态管理、SSE 连接、主题 |
| backend | 01-models 02-handlers 03-stream 04-config 05-wiring | 数据模型、处理器、SSE 流式、配置、应用组装 |
| agentend | 01-schemas 02-adapters 03-session 04-rules 05-api 06-app-wiring ... | 按实际模块拆分 |
## 实现了什么 / ## 怎么实现的），按格式重写创建文件后输出：[已创建] frontend/docs/design/06-xxx.md — 内容摘要。
发现问题的同时直接修复，不输出报告等确认。 具体行为：
design/ 缺实现细节 → 补充"如何实现"的说明每个文件修改完后，简要输出一行：[已修复] docs/xxx.md — 修复内容摘要。
.go/.py/.ts/go.mod/package.json 等来验证文档，但绝不修改。## 实现了什么 + ## 怎么实现的 + 实际代码片段，缺失则创建。SOC 직업 분류 기준
输出技能工具。Agent 调用对应子命令生成 aka_yhy 富媒体卡片，覆盖 HTML 渲染、图片、附件、diff、预览五种类型。
多 Agent 协作上下文与状态管理工具。自动识别 Agent 身份，提供任务级配置/记忆的读写能力，并基于 Git 分支机制实现多 Agent 间的安全状态隔离与合并同步。
全项目 AGENTS.md 同步精炼。扫描全部 5 个 AGENTS.md + 三端 details.md，交叉验证目录结构、文件引用、Makefile 命令后直接修改。
全项目 AGENTS.md 同步精炼。扫描全部 5 个 AGENTS.md + 三端 details.md，交叉验证目录结构、文件引用、Makefile 命令后直接修改。
全项目文档同步精炼。读取全部 AGENTS.md 建立上下文，全量扫描根 docs/ + 三端 docs/，交叉验证代码引用后直接修改文档。
