Skillsaw：为 AI 编码代理配置文件提供 lint 检查

Skillsaw 是一款专门为 AI 编码代理配置文件设计的 lint 工具，主要面向 Claude Code、Cursor 等依赖 CLAUDE.md、AGENTS.md、skills、plugins 等说明文件驱动行为的代理场景。工具内置 40 余条规则，可自动识别弱表述、同义反复、注意力死角、嵌入式密钥、规则矛盾等问题，并提供自动修复能力。

核心能力

Skillsaw 将传统静态分析思路迁移到 AI 代理配置领域，强调「内容智能」层面的检查，而非仅做格式校验。其规则集覆盖以下场景：

• 弱语言与同义反复指令
• 上下文「注意力死角」（即代理实际难以关注到的段落）
• 跨文件、跨规则的逻辑矛盾
• 嵌入式密钥与敏感信息
• 整体结构合理性

对于可自动修复的问题，Skillsaw 提供 skillsaw fix 命令以确定性方式改写；同时配套一个 Skills 插件，引导编码代理在不确定时按规范处理其余情况。

扩展与集成

工具设计上注重工程化落地：

• 支持自定义规则、pip 安装的规则插件，并可针对每条规则设置阈值
• 提供 skillsaw add 脚手架命令，可一键生成符合最佳实践结构的 plugins、skills、commands、agents、hooks
• 提供 skillsaw docs 命令，自动从配置生成 HTML 或 Markdown 文档
• 支持 GitHub 与 GitLab CI 集成，可在 PR 中行内评论并自动去重、关闭已解决讨论线程

适用人群与定位

Skillsaw 主要服务于已经在使用 Claude Code 等 AI 编码代理、并维护较多自定义配置文件的团队。对于普通用户而言，其门槛主要在于需要先建立一套相对成熟的代理配置文件体系，工具才会产生明显收益。整体来看，它属于 AI 编码工作流中「配置质量」这一细分环节的辅助工具，并非通用模型或框架层面的进展。