Aitishiku.com1. 📌Skill基础信息
Skill名称：document-update（文档更新）
简称：文档同步工具
来源：社区第三方（MoonLadderStudios）
运行宿主：Claude-Code CLI
核心定位：通过比对代码实现与文档声明，自动检测并修复技术文档与代码实现之间的漂移问题，确保文档准确反映系统实际行为。
2. 🧩内部核心组成
核心能力组件
- 文档解析引擎：提取文档中的具体声明和主张
- 代码检测器：扫描代码库验证实现真实性
- 漂移分类器：将文档声明分类为准确/过时/缺失/模糊/超出范围
- Jira集成器：处理与项目方向冲突的更新请求
工作流程组件
| 组件类型 | 功能简述 |
|---|---|
| 文档解析 | 提取技术文档中的具体行为声明 |
| 代码验证 | 搜索代码库验证实现真实性 |
| 漂移分类 | 对每个文档声明进行准确性分类 |
| 文档编辑 | 精确更新需要修正的文档部分 |
| 验证执行 | 运行项目要求的程序化检查 |
3. 🛠安装与启用方式
安装命令：
skills install --user MoonLadderStudios/MoonMind前置依赖：
- Git 版本控制系统
- 代码仓库的本地检出副本
运行要求：
- 需要指定目标文档路径或文档主题
- 需要包含实现代码的当前仓库检出
4. 📋标准工作流
- 目标解析：识别需要更新的文档路径或具体章节
- 声明提取：读取相关章节，列出关于行为、合约、配置等的具体声明
- 实现检查：搜索代码库中的类、函数、路由、模型、测试等验证实现
- 漂移分类：构建漂移账本，将每个声明分类为准确/过时/缺失/模糊
- 方向评估：比对项目宪法(AGENTS.md)、README和主要架构文档
- 文档编辑：仅更新需要修正漂移的部分，保持文档原有风格
- 验证执行：重新读取变更部分，运行项目要求的程序化检查
- Jira回退：当更新与项目方向冲突时，创建Jira问题而非直接编辑
5. ⚠️关键限制、缺陷、注意事项
平台限制：
- 仅支持Git管理的代码仓库
- 依赖本地代码检出，不支持远程仓库直接操作
Token消耗：
- 高Token消耗：需要解析文档和大量代码文件
- 多次代码搜索和验证操作增加计算开销
适用项目类型：
- 中大型技术项目有详细文档规范的
- 架构清晰、有明确宪法和架构文档的项目
不适用场景：
- 小型或个人项目文档规范较简单的
- 缺乏明确架构指导的项目
已知坑点：
- 多个规范文档冲突时需要人工干预
- 无法找到实现证据时标记为模糊而非断言
- 秘密内容出现在示例中需要手动编辑
生产环境适用性：
- 适用于预生产环境文档同步
- 生产环境需谨慎使用，建议配合人工审核
6. ✅适用场景 & ❌不适合场景
✅适用场景
- 技术文档需要与代码实现保持同步的团队
- 有明确架构规范和文档标准的中大型项目
- 需要定期审计文档准确性的质量保障流程
- 修复过时的架构、API、工作流或操作文档
❌不适合场景
- 文档规范不明确或架构指导缺失的项目
- 个人小项目或文档要求简单的场景
- 需要创造性文档编写而非单纯同步的情况
- 缺乏Git版本控制或本地代码检出的环境
如何安装
skills install --user MoonLadderStudios/MoonMind通用安装教程：在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：
- 打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
- 把上面的安装命令复制进去，回车运行，等待下载与注册完成。
- 重启或重新加载 AI 工具，让新安装的 Skill 被识别。
- 新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版（macOS / Windows）
桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。
Claude Code（终端 CLI）
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。
VS Code（含 GitHub Copilot）
打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。
Windsurf
底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。
其他工具（ChatGPT、本地脚本等）
不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。