ai-instruction-standards

# AI 指令文件标准指南 > **语言**: [English](../../../../skills/ai-instruction-standards/SKILL.md) | 简体中文 **版本**: 1.0.0 **最后更新**: 2026-01-25 **适用范围**: Claude Code Skills --- > **核心标准**: 本技能实现 [AI 指令文件标准](../../../../core/ai-instruction-standards.md)。完整方法论文档请参阅核心标准。 ## 目的 本技能协助创建和维护 AI 指令文件，适当区分通用标准与项目特定配置。 ## 快速参考 ### 支持的 AI 工具 | AI 工具 | 指令文件 | 格式 | |---------|----------|------| | Claude Code | `CLAUDE.md` | Markdown | | Cursor | `.cursorrules` | Markdown | | Windsurf | `.windsurfrules` | Markdown | | Cline | `.clinerules` | Markdown | | GitHub Copilot | `.github/copilot-instructions.md` | Markdown | | OpenCode | `.opencode/instructions.md` | Markdown | ### 核心原则：通用 vs 项目特定 | 类型 | 包含内容 | 示例 | |------|----------|------| | **通用** | 通用规则 | 「提交前运行测试」 | | **项目特定** | 具体命令 | 「提交前运行 `npm test`」 | ### 建议配置 ```markdown # [项目名称] - AI 指令 ## 通用标准 <!-- 适用于任何项目的规则 --> - Commit 消息格式 - 代码审查清单 - 测试标准 - 反幻觉规则 --- ## 项目特定配置 <!-- 此项目独有的设置 --> ### 技术栈 [你的技术在此] ### 快速命令 [你的构建/测试/部署命令] ### 文件结构 [你的项目结构] ``` ## 详细指南 完整标准请参阅： - [AI 指令文件标准](../../../../core/ai-instruction-standards.md) ### AI 优化格式（Token 效率） AI 助手可使用 YAML 格式文件以减少 Token 使用： - 基础标准：`ai/standards/ai-instruction-standards.ai.yaml` ## 内容指南 ### 通用内容（保持通用） | 类别 | 良好示例 | |------|----------| | **提交标准** | 「遵循 Conventional Commits 格式」 | | **代码审查** | 「使用 BLOCKING、IMPORTANT、SUGGESTION 前缀」 | | **测试** | 「维持最低 80% 覆盖率」 | | **AI 行为** | 「分析前务必先读取代码」 | **通用区段应避免：** - 特定命令（`npm test`、`pytest`） - 固定路径（`cli/src/`、`/var/www/`） - 版本号（`Node.js 18...