Skip to content

Commit 110db0b

Browse files
DCjanuscodex
andauthored
docs(agents): 补充 BUG 修复测试优先规范 (#29)
## Why - 为 `AGENTS.md` 增加统一的缺陷修复方法约束。 - 明确先构造稳定失败测试、再修复问题的默认实践,降低无效修复和回归风险。 ## What - 在 `3.1 长期质量` 中补充 `test-first bug fixing` 规范。 - 要求先添加可稳定复现问题的失败测试,修复后让测试通过,并将其保留为 `regression test`。 ## Testing - 未运行自动化测试;本次仅更新文档。 Co-authored-by: OpenAI Codex <codex@openai.com>
1 parent 06db5ac commit 110db0b

File tree

1 file changed

+1
-0
lines changed

1 file changed

+1
-0
lines changed

AGENTS.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,7 @@
4646
### 3.1 长期质量
4747
- 优先选择能提升长期可维护、可理解、可扩展的方案;避免为了快速完成任务引入临时权衡/一次性 hack 或长期复杂度。
4848
- 除非用户当次明确要求,否则不为历史接口/行为做兼容层;如确需引入额外复杂度,先说明成本与替代方案,再执行。
49+
- 修复 BUG 时优先采用 test-first bug fixing:先补一个能稳定复现问题的失败测试,用其验证问题确实存在;修复后应让该测试通过,并将其保留为 regression test。
4950

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

0 commit comments

Comments
 (0)