source-agents
自动检查和修复 AGENTS.md 与 CLAUDE.md 文件源引的工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:source-agents。 它的用途是:自动检查和修复 AGENTS.md 与 CLAUDE.md 文件源引的工具 完整的 Skill 内容见:https://321skill.com/skills/source-agents/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我检查一下 `~/my-agents` 目录下所有项目的 AGENTS.md 文件源引是否正确。” 它会启动 source-agents 工具,扫描该目录,并以清晰的交互界面列出所有问题文件、具体错误类型(如链接失效、格式不一致),并提供一键修复选项。你可以选择逐个确认或使用 `--auto` 参数让它自动完成所有推荐修复。
介绍
source-agents 是一款专为 AI Agent 开发者设计的自动化工具,核心解决 AGENTS.md 和 CLAUDE.md 等技能清单文档的维护难题。这些文件常因手动编辑导致链接失效、格式混乱或引用不一致,source-agents 能自动扫描项目目录,识别并修复这些问题。
使用方式非常灵活,开发者只需指定项目根目录,工具便会以交互式终端界面(TUI)展示所有检测到的问题,并提供修复建议。支持一键自动修复(—auto)、预览模式(—dry-run)以及自定义排除目录,让维护过程既安全又高效。
它非常适合管理多个 AI Agent 技能项目、维护开源技能仓库或为团队制定统一文档规范的开发者。无论是个人项目还是协作开发,都能显著减少手动核对和修复文档源引的重复劳动。
与同类文件检查工具相比,source-agents 并非通用的代码格式化或链接检查器,而是深度定位于 AI Agent 生态特有的 AGENTS.md/CLAUDE.md 文件格式。它理解这些文件的特定结构和源引约定,能进行更精确的修复,如正确处理相对路径、GitHub 原始文件链接以及符号链接转换,这是通用工具难以做到的。
核心特点
深度针对 AI Agent 生态中特有的 AGENTS.md 和 CLAUDE.md 文件格式进行优化,能精准识别和修复这类文件特有的源引(sourcing)问题,如 GitHub raw 链接格式、相对路径转换等,而非进行通用的链接检查。
注意事项
主要专注于文本文件的源引格式检查与修复,不适合处理复杂的代码逻辑错误或非文本内容的验证。
常见问题
source-agents 能修复哪些问题?
能修复 AGENTS.md/CLAUDE.md 中失效的源文件链接、不一致的格式、错误的相对/绝对路径,并能将符号链接转换为实际内容。
使用它会修改我的原文件吗?
默认交互模式需确认后才修改,使用 --auto 参数会自动修复,使用 --dry-run 则只预览不修改。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/source-agents/raw/index.md 读取 source-agents 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/source-agents/raw/index.md(查看排版版本)