AI Instruction Standards

AI 指令文件标准指南

语言: English | 简体中文

版本: 2.0.0 最后更新: 2026-05-05 适用范围: Claude Code Skills

核心标准: 本技能实现 AI 指令文件标准。完整方法论文档请参阅核心标准。

目的

本技能协助创建和维护 AI 指令文件，适当区分通用标准与项目特定配置。

快速参考

支持的 AI 工具

核心原则：通用 vs 项目特定

建议配置

# [项目名称] - AI 指令

## 通用标准
<!-- 适用于任何项目的规则 -->
- Commit 消息格式
- 代码审查清单
- 测试标准
- 反幻觉规则

---

## 项目特定配置
<!-- 此项目独有的设置 -->

### 技术栈
[你的技术在此]

### 快速命令
[你的构建/测试/部署命令]

### 文件结构
[你的项目结构]

详细指南

完整标准请参阅：

• AI 指令文件标准

AI 优化格式（Token 效率）

AI 助手可使用 YAML 格式文件以减少 Token 使用：

• 基础标准：ai/standards/ai-instruction-standards.ai.yaml

内容指南

通用内容（保持通用）

通用区段应避免：

• 特定命令（npm test、pytest）
• 固定路径（cli/src/、/var/www/）
• 版本号（Node.js 18、Python 3.11）
• 项目名称和 URL

项目特定内容

标签惯例

选项 A：区段标题

## 通用标准
[通用内容]

## 项目特定配置
[项目特定内容]

选项 B：行内标记

> ⚠️ **项目特定**：本区段包含此项目独有的配置。

### 技术栈
...

选项 C：注释标注

<!-- 通用：以下适用于所有项目 -->
### Commit 消息格式
...

<!-- 项目特定：为你的项目自定义 -->
### 快速命令
...

多工具配置

使用多个 AI 工具时，保持一致性：

project/
├── CLAUDE.md              # Claude Code 指令
├── .cursorrules           # Cursor 指令（可从 CLAUDE.md 导入）
├── .windsurfrules         # Windsurf 指令
└── .github/
    └── copilot-instructions.md  # Copilot 指令

最佳实践：创建共用的 docs/ai-standards.md 并从各工具文件引用，避免重复。

维护检查清单

提交 AI 指令文件变更前：

• 通用区段不包含项目特定的路径、命令或版本
• 项目特定区段有明确标记
• 标准文档的交叉引用正确
• 格式与现有区段一致

配置侦测

本技能支持项目特定配置。

侦测顺序

1. 检查是否存在 CLAUDE.md 或等效文件
2. 分析内容结构是否区分通用/项目特定
3. 若未找到，建议创建结构化 AI 指令文件

首次设置

若未找到 AI 指令文件：

1. 询问：「此项目没有 AI 指令文件。是否要创建一个？」
2. 确定项目类型和技术栈
3. 生成包含适当区段的模板
4. 若包含敏感信息，添加到 .gitignore

相关标准

• AI 指令文件标准 - 核心标准
• 文档撰写标准 - 撰写指南
• 反幻觉规范 - AI 准确性规则
• AI 友善架构 - 上下文优化

版本历史

授权

本技能以 CC BY 4.0 授权发布。

来源: universal-dev-standards

Next Steps Guidance

After /ai-instruction-standards completes, suggest:

• Create or update project's CLAUDE.md / AGENTS.md ⭐ Recommended — Apply standards immediately
• Run /ai-friendly-architecture to optimize AI collaboration at the architecture level
• Run /ai-collaboration to review AI behavior guidelines

Related Standards

• AI Instruction File Standards - Core standard
• Documentation Writing Standards - Writing guidelines
• Anti-Hallucination Guidelines - AI accuracy rules
• AI-Friendly Architecture - Context optimization

Version History

License

This skill is released under CC BY 4.0.

Source: universal-dev-standards