Skip to content

Commit a203fc4

Browse files
CodeCasterXclaude
andcommitted
docs(ai-agents): 优化配置体系,明确 Claude 与 AGENTS.md 的独立关系
重构配置文件体系,建立两套独立的配置系统: - 精简 CLAUDE.md 至 148 行(-63.3%),与 AGENTS.md 保持一致的简洁风格 - 删除 project-rules.md 中对 AGENTS.md 的 4 处引用,改为引用同体系内的 CLAUDE.md - 在 .ai-agents/README.md 新增"配置体系说明"章节,明确两套体系的平行独立关系 - 修正配置架构图,体现 Claude Code 配置的自包含性 优化效果: - CLAUDE.md: 403 → 148 行(-63.3%),节省约 3,825 tokens - 两套体系互不依赖,内容一致但格式独立 - 协作机制和工作区由两套体系共享 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent 92e9e95 commit a203fc4

File tree

3 files changed

+152
-340
lines changed

3 files changed

+152
-340
lines changed

.ai-agents/README.md

Lines changed: 61 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,67 @@
22

33
本目录包含 FIT Framework 项目的 AI 智能体协作配置,支持多个主流 AI 工具(Claude Code、Codex、Gemini CLI、Cursor 等)在同一项目中高效协作。
44

5-
> **💡 提示**:如需快速了解项目规范,请先阅读根目录的 `AGENTS.md` 文件。本文档专注于**多 AI 协作机制**的详细说明。
5+
> **💡 提示**:如需快速了解项目规范,请先阅读对应工具的配置文件(详见下方"配置体系说明")。本文档专注于**多 AI 协作机制**的详细说明。
6+
7+
## 🔧 配置体系说明
8+
9+
本项目采用**双轨配置体系**,不同 AI 工具使用不同的配置文件:
10+
11+
### 配置体系 A:Claude Code
12+
**适用工具**:Claude Code
13+
14+
**配置文件**
15+
- **`.claude/CLAUDE.md`** - 快速参考(启动时自动加载)
16+
- **`.claude/project-rules.md`** - 详细规则
17+
- **`.claude/commands/`** - Slash Commands 实现
18+
19+
**特点**
20+
- Claude Code 专属配置,包含 Slash Commands 和特定规则
21+
- 自包含,不依赖其他配置文件
22+
- 启动时自动加载 `.claude/CLAUDE.md`
23+
24+
### 配置体系 B:AGENTS.md 标准
25+
**适用工具**:Codex CLI、Gemini CLI、Cursor、其他 TUI 工具
26+
27+
**配置文件**
28+
- **`AGENTS.md`** - 项目开发规范(根目录)
29+
- **`.ai-agents/codex/preferences.yaml`** - Codex 特定配置
30+
- **`.ai-agents/gemini/preferences.yaml`** - Gemini 特定配置
31+
32+
**特点**
33+
- 遵循 [AGENTS.md 标准](https://agents.md)(Linux Foundation AAIF)
34+
- 轻量级,专注于项目开发规范
35+
- 启动时自动加载 `AGENTS.md`
36+
37+
### 两套体系的关系
38+
39+
```
40+
项目规范(两套独立但内容一致)
41+
├── 体系 A:.claude/ (Claude Code 使用)
42+
│ ├── CLAUDE.md (快速参考)
43+
│ └── project-rules.md (详细规则)
44+
45+
└── 体系 B:AGENTS.md (其他工具使用)
46+
├── AGENTS.md (项目规范)
47+
└── .ai-agents/{tool}/preferences.yaml (工具配置)
48+
49+
协作机制(两套体系共享)
50+
└── .ai-agents/ (多 AI 协作配置)
51+
├── workflows/ (工作流定义)
52+
├── templates/ (任务模板)
53+
└── README.md (本文件 - 协作指南)
54+
55+
工作区(两套体系共享)
56+
└── .ai-workspace/ (任务跟踪和上下文共享)
57+
├── active/ (进行中的任务)
58+
├── blocked/ (被阻塞的任务)
59+
└── completed/ (已完成的任务)
60+
```
61+
62+
**为什么需要两套体系**
63+
- Claude Code 仅加载 `.claude/CLAUDE.md`,不会自动读取 `AGENTS.md`
64+
- 其他 TUI 工具遵循 AGENTS.md 标准,自动加载根目录的 `AGENTS.md`
65+
- 两套体系内容一致,只是文件位置和格式不同
666

767
## 📋 目录说明
868

0 commit comments

Comments
 (0)