القائمة
文档园丁，负责知识库建立后的一切维护工作：自动巡检（过期文档、代码不一致、失效引用）、整理散乱文档、审计模块旧文档、梳理归类。当用户提到"文档巡检""文档园丁""检查文档""扫描文档""整理文档""审计文档""梳理文档"时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Go 语言项目的开发模式和最佳实践。当用户提到"写 Go 代码""Go 服务""Go 接口""goroutine""Go 测试"时使用。
macOS 桌面应用开发的模式和最佳实践。当用户提到"开发 Mac 应用""SwiftUI""Swift 代码""桌面应用""菜单栏应用"时使用。
创建或更新 Skill 的交互式 SOP，通过分步提问引导用户完成 Skill 设计与实现。当用户提到「创建 skill」「帮我做一个 skill」「更新 skill」时使用。
Agent 闭环自验证工作流，在完成代码修改后自动执行"写代码→构建→验证UI→查日志→修复→再验证"的完整循环。当 Agent 完成功能开发、Bug 修复、UI 修改、API 变更或任何代码改动后，应主动触发此验证流程，确保改动真正生效且无副作用。适用于 Web 前后端项目的闭环验证。
统一 AI 调用服务，三服务商策略（4sapi+sodao+OpenRouter），支持文本对话、图片理解、PDF/音视频分析、图像生成、流式输出、智能降级。当需要接入大语言模型或实现多模态 AI 功能时使用。
企微聊天记录查看方案，后端统一处理消息同步/解密/媒体下载/语音转文字，前端按业务场景分散在各模块。当需要展示聊天记录、实现会话历史查看或消息渲染时使用。
| name | doc-gardener |
| description | 文档园丁，负责知识库建立后的一切维护工作：自动巡检（过期文档、代码不一致、失效引用）、整理散乱文档、审计模块旧文档、梳理归类。当用户提到"文档巡检""文档园丁""检查文档""扫描文档""整理文档""审计文档""梳理文档"时使用。 |
知识库建立后的唯一维护入口。包含三大能力：巡检、整理、审计。
所有涉及多文件、多模块的操作，必须使用 Task 工具启动子 agent 并行处理。
触发："文档巡检" / "跑一下文档园丁" / "检查文档" / "扫描文档"
bash ~/.cursor/skills/doc-gardener/scripts/scan.sh <项目根目录>
脚本执行 13项检查：
| 范围 | 检查项 |
|---|---|
| 文档结构 | 关键文件存在、AGENTS.md行数、设计文档验证状态、索引同步、过期（>30天）、空目录 |
| 代码一致性 | 容器一致（docker ps vs 架构.md）、端口一致、凭据一致（.env vs 凭据文档）、模块目录一致、部署模式一致 |
| Git分析 | 代码变更但文档未更新的模块、文档统计 |
根据扫描结果，启动并行子 agent 分头处理：
| 问题类型 | 子 agent 任务 |
|---|---|
| 容器/端口/模块不一致 | 更新 架构.md 和 AGENTS.md 对应部分 |
| 凭据不一致 | 读取 .env 最新值，更新凭据文档 |
| 部署模式不一致 | 读取 docker-compose，更新 架构.md 标记 |
| 代码变更未同步 | 逐模块分析 git diff，判断是否需要更新文档 |
Agent 额外主动检查：
文档/ 内的 TODO/FIXME 标记执行计划/进行中/ 是否有已完成但未归档的计划AGENTS.md 知识库索引是否与 文档/ 子目录同步存入 文档/变更日志/文档巡检报告-YYYYMMDD.md。
触发："整理文档" / "整理XX模块的文档"
当项目下有散落在各处的旧文档时使用。
第一步：扫描盘点（子 agent）
启动 1 个子 agent 递归扫描目标范围内所有 .md 文件，生成审计清单：
| 序号 | 当前路径 | 文件名 | 大小 | 最后修改 | 初步分类 | 处置建议 |
处置建议类型：迁移 / 合并 / 归档 / 废弃 / 更新后迁移
第二步：并行分类迁移（多个子 agent）
按审计清单结果，启动并行子 agent：
| 子 agent | 负责范围 |
|---|---|
| agent-A | 迁移设计文档类（补验证状态头部） |
| agent-B | 迁移参考资料类（API文档、数据库Schema等） |
| agent-C | 迁移凭据/配置类 + 产品规格类 |
| agent-D | 处理需合并/归档/废弃的文档 |
每个子 agent 的执行动作：
文档/ 对应子目录，补验证状态头部文档/执行计划/已完成/第三步：清理与更新索引
AGENTS.md 知识库索引架构.md（如发现架构信息需修正）第四步：输出审计报告
# 文档审计报告 — [范围] — [日期]
## 统计
## 发现的问题
## 新增的隐性知识
触发："审计XX模块的文档" / "梳理XX模块"
对特定模块下的旧文档进行深度审计，验证其与代码的一致性。
第一步：定位模块文档
读取目标模块目录，找出所有 .md 文件和文档类子目录（规划文档/、文档/ 等）。
第二步：逐份验证（子 agent 并行，每个 agent 处理 3-5 份文档）
对每份文档：
第三步：分类处置
根据验证结果：
文档/ 对应子目录第四步：输出模块审计报告
| 操作 | 权限 |
|---|---|
| 架构.md 补充容器/端口 | 直接修复 |
| AGENTS.md 更新知识库索引 | 直接修复 |
| 设计文档补验证状态头部 | 直接修复 |
| 删除空目录 | 直接修复 |
| 凭据文档更新 | 修复后展示 diff |
| 部署模式标记修正 | 修复后展示 diff |
| 质量评分调整 | 修复后展示 diff |
| 过期文档处置 | 需人工确认 |
| 大范围代码-文档不一致 | 需人工确认 |