1.1 KiB
1.1 KiB
.agents 指南索引
本目录用于存放 AI/自动化代理在本仓库内工作时必须遵守的规则。
这些规则与 docs/ 下的人类开发规范并行：
docs/：给人看的编码/命名/提交规范.agents/：给代理看的任务边界、质量与安全要求
范围
- 适用于本仓库所有目录与文件，除非子目录另有更具体的
.agents/*.md覆盖说明。 - 当
.agents与docs发生冲突时：- 安全/合规优先
- 其次保持仓库现有一致性
代理工作原则
- 先理解目标与上下文，再动手改代码。
- 修改要小而清晰；避免无关重构。
- 任何可能影响行为的改动都要补充或更新测试/示例（若项目有测试体系）。
- 不要引入新依赖或工具，除非明确要求。
子文档
- 安全与鉴权：
auth.md - 性能：
performance.md - 代码质量：
code_quality.md - 测试：
testing.md
与开发规范的关系
- 代码风格：
docs/code_style.md - 命名规范：
docs/naming.md - 提交信息：
docs/commit_message.md