用途
ai-context-linter 是一个 GitHub Action，用于在 AI 编码智能体开始编写代码之前，检查 AI 编码上下文文件中的问题。它面向使用 Claude Code、Cursor、Copilot 等 AI 编码工具的用户，帮助他们在 CI 流程中提前发现上下文文件的缺陷，避免因文件错误导致智能体生成不良代码。
主要能力
该 Action 会自动检测仓库中的 AI 上下文文件，并对其运行 12 条规则。支持检测的文件类型包括：CLAUDE.md、.cursorrules、AGENTS.md、COPILOT.md、.windsurfrules、.clinerules。检查内容分为以下几类：
- 安全问题（错误级别，会导致构建失败）：例如泄露的 API 密钥、私有文件路径。
- 结构问题（警告级别）：例如缺少章节、空标题、大段文字（wall-of-text 文件）。
- AI 反模式（警告级别）：例如模糊指令、冲突规则、冗余指令。
- 最佳实践（信息级别，仅为建议，不会导致失败）。
- 文件类型特定检查（信息级别）：例如针对 CLAUDE.md 的工具指导、针对 .cursorrules 的文件范围检查。
使用方式
根据资料，使用该 Action 需要两步：首先在仓库根目录创建 .ai-context-linter.yml 配置文件，然后在工作流中引用该配置文件。资料中未提供具体的配置内容示例或完整的工作流语法。
适用场景
适合任何在项目中使用 AI 编码智能体并维护上下文文件的团队或个人。当上下文文件可能存在安全风险（如硬编码密钥）、结构混乱或包含模糊/冲突指令时，该工具可以在 CI 阶段拦截问题，防止它们影响生产代码。
限制与补充说明
资料中未提供该工具的具体价格、收费模式、平台兼容性细节（除 GitHub Action 外）、安装命令、配置示例或实际效果数据。该工具以 MIT 许可证发布，可自由使用。如果用户希望获得能首次通过所有检查的上下文模板，资料中提及了“AI Context Engineering Templates”，但未提供其具体内容或链接。
