Skip to content

Commit 6e94116

Browse files
DCjanuscodex
andcommitted
docs(agents): refine bugfix testing guidance
Co-authored-by: OpenAI Codex <codex@openai.com>
1 parent 1df012b commit 6e94116

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

AGENTS.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,8 @@
3737
### 3.1 长期质量
3838
- 优先选择能提升长期可维护、可理解、可扩展的方案;避免为了快速完成任务引入临时权衡/一次性 hack 或长期复杂度。
3939
- 除非用户当次明确要求,否则不为历史接口/行为做兼容层;如确需引入额外复杂度,先说明成本与替代方案,再执行。
40-
- 修复 BUG 时优先采用 test-first bug fixing:先补一个能稳定复现问题的失败测试,用其验证问题确实存在;修复后应让该测试通过,并将其保留为 regression test。
40+
- 修复 BUG 时,是否补测试应遵循项目既有测试风格与维护成本做法。
41+
- 当决定补测试时,应优先先写能稳定复现问题的失败测试,以先确认测试本身有效且确实复现了待修复的问题,再进行修复,并在修复后保留该测试以防回归。
4142

4243
### 3.2 文档与 Markdown 风格
4344
- Markdown 链接优先使用 `[描述](URL)` 形式,避免裸露 `<URL>`;在 Markdown 中引用相对路径文件时,优先使用链接形式(链接文本仅保留文件名、路径放在链接目标里)。除非有歧义或明确要求,否则不要用 inline code 引用路径。

0 commit comments

Comments
 (0)