core-fix-skill-docs 是 actionbook/rust-skills 项目中的内部维护技能,版本 2.1.0,最后更新于 2025-01-27。它的用途是检查和修复动态技能中缺失的引用文件,仅在显式通过 /fix-skill-docs 调用时使用。
主要能力:
- 扫描技能目录,支持指定单个 crate 或扫描全部技能。
- 解析 SKILL.md 中 Documentation 部分引用的 ./references/*.md 文件。
- 检查各引用文件是否存在,并输出状态报告(OK 或 MISSING)。
- 修复缺失文件:根据运行模式抓取对应文档并写入引用文件。
- 支持 --check-only 仅报告问题不修复,--remove-invalid 在无法获取文档时移除无效引用而非创建文件。
使用方式: 命令为 /fix-skill-docs [crate_name] [--check-only] [--remove-invalid]。crate_name 可选,默认检查全部;--check-only 仅报告;--remove-invalid 移除无效引用。
执行模式检测:技能会先检测智能体基础设施是否可用,决定使用 Agent 模式还是 Inline 模式。
- Agent 模式(插件安装):当智能体基础设施可用时,使用后台智能体抓取文档。步骤包括扫描技能目录、解析 SKILL.md 引用、检查文件存在性、报告状态,然后启动后台智能体从 docs.rs 抓取文档并保存到对应 references 目录。
- Inline 模式(仅技能安装):当智能体基础设施不可用时,直接执行。步骤包括列出技能目录、读取 SKILL.md 提取引用、检查文件存在性、输出状态报告,然后对每个缺失文件使用 agent-browser CLI 打开 docs.rs 对应页面并提取文档内容保存,或使用 WebFetch 作为回退,最后写入文件。
如果设置了 --remove-invalid 且文件无法抓取,则读取 SKILL.md 并编辑,移除无效引用行。
工具优先级:agent-browser CLI 为首选抓取工具,WebFetch 为回退,Edit SKILL.md 仅用于移除无效引用(配合 --remove-invalid)。
适用场景:维护 Rust 技能文档引用完整性,确保技能引用的参考文件存在且内容可用。
限制:仅在显式调用 /fix-skill-docs 时使用;需要已安装对应技能;依赖 docs.rs 网络可用性;若技能目录为空需先运行 /sync-crate-skills;权限问题需检查 ~/.claude/skills/ 权限;SKILL.md 格式无效需重新生成技能。