AI 简明手册
DeepSeek Harness 源码解读 · 工程方法论怎样用 Agent Notes 与 AGENTS.md 约束 AI 开发

专题篇章 · 工程方法论源码解读

怎样用 Agent Notes 与 AGENTS.md 约束 AI 开发

它要解决什么

笔记路径承载状态，换状态须移文件并改 Status 行。门禁强制写「为什么」。AGENTS.md 只收可机器或评审检查的硬契约。

源码给出的答案

类别封闭

类别封闭，非平凡变更须同 PR 更新笔记。每篇须有 Alternatives considered。状态与内容不改同变，门禁交叉检查。rejected 须带理由，archived 永久冻结。

[repo]

proposed 要求三节

proposed 要求三节，implemented 要求两节，禁止提案腔标题。AGENTS.md 条款须十秒内可判违没违反，根文件 1600 词预算，文档门禁统一驱动。

[repo]

收益与代价

  • 最小 AGENTS.md 只写五条有何要求： 每条三行内，可脚本查或十秒评审判违，须含设计笔记触发条件。

  • 直接 git mv proposed 入 implemented 会报什么： 状态与目录不符，缺 Decision 和 Consequences，检测到提案腔标题。

别把取舍当成定律

  • 本页结论对应 revision 0a53fb55bea101816fa226bb964ae2bed71c343b。文件位置、命名和默认行为可能随版本变化，引用实现细节时应同时记录 commit。

来源与核验

  1. [repo] DeepSeek Harness 官方源码（固定 revision）
  2. [official] DeepSeek Harness 官方介绍

Revision：0a53fb55bea101816fa226bb964ae2bed71c343b · 核验日期：2026-08-31