refactor(docs): 统一 AI Agent 项目文档为 CLAUDE.md #54
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
移除 AGENTS.md，改用 CLAUDE.md 作为所有 AI Agent 的统一项目文档。 主要改动： - 删除 AGENTS.md 及其同步脚本 ensure-guidelines-sync.mjs - 新增 ensure-agent-config.mjs 检查 Codex/Gemini 配置 - 支持增量覆盖逻辑：项目级配置优先，无字段时回退用户级 - 配置检查仅显示警告，不阻断 CI 流程 配置检查项： - Codex: project_doc_fallback_filenames 包含 CLAUDE.md - Gemini: context.fileName 包含 CLAUDE.md
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
主要变化
动机
原有双文档（AGENTS.md / CLAUDE.md）同步机制增加维护成本，且 Codex 和 Gemini CLI 都支持自定义项目文档路径，可以直接读取 CLAUDE.md。
主要改动
AGENTS.md及同步脚本ensure-guidelines-sync.mjsensure-agent-config.mjs检查 Codex/Gemini 配置是否引用 CLAUDE.mdpackage.json脚本命令（guidelines:*→agent-config:*）CLAUDE.md文档描述测试情况
npm run check通过风险评估
低风险。配置检查仅显示警告，不阻断流程，CI 环境无配置文件会自动跳过。