dsh-archive-agent-notes

归档 DeepSeek Harness Agent 笔记

在不抹去仍能指导工作的历史记录的前提下，缩减当前决策文档集。评估每条笔记的语义；字数和时效性只是发现线索，绝不是归档标准。

阅读规则

在分类前，阅读Agent 笔记规则、归档说明以及适用的当前生命周期说明。利用当前代码、配置、软件包文档、生成的目录、较新的 Agent 笔记和入站链接，判断某项理由是否仍然拥有或约束某些内容。

添加笔记时检查是否被取代

起草前，应用创建标准。每条新 Agent 笔记都会触发一项范围限定的审查，检查涵盖相同决策、机制或被否决替代方案的当前笔记。撰写新笔记时，分类所有被完全或部分取代的笔记：在同一个 PR 中归档符合条件且已实现的三元组；保留部分被取代的笔记或仍有独立价值的理由，并添加交叉链接；否决过时提案；删除不再能避免合理错误的被否决笔记。新笔记吸收了所有独特观点时，应用 Agent 笔记合并规则；不要把已知的匹配项推迟到之后的文档集审查中。

按未来价值分类

应用以下特定于生命周期的处理方式：

• 已实现 — 删除： 删除仅描述细微 UI 调整或纯机械变更的完整三元组，并修复或删除入站链接。本地错误修复、性能改进、新功能以及实质性的行为或归属权决策，不会仅仅因为已经实现就符合此条件。将此标准应用于保留或归档分类之前。
• 已实现 — 保留为当前笔记： 如果某项理由、替代方案、负面保证、持久性／线缆语义、归属权边界、安全规则或重新引入条件很可能指导未来变更，就保留该笔记。对决策进行分类，而不是对其实现机制进行分类：机械重命名或类型提取仍可能记录持久的命名、兼容性或归属权规则。长度无关紧要。
• 已实现 — 归档： 对于已经完成且不太可能指导未来工作的实质性历史决策，如果其历史理由仍值得保留，则将其归档。不要归档符合直接删除标准的记录。
• 已提议 — 绝不归档： 将仍然有效的提案保留为当前笔记；如果不再值得推进，就以诚实的理由予以否决，并满足被否决生命周期格式的要求。
• 已否决 — 仅作为防护规则保留： 仅当落选提案仍是一个诱人且有实质影响的错误，并且笔记解释了它为何不可取时，才保留该否决记录。
• 已否决 — 删除： 如果被否决的想法已经过时、被取代、不再合理或不太可能阻止重新讨论，就删除整个三元组。修复或删除入站链接。

不要为了达到配额而归档。检查范围内的每条笔记，按同一原则对类似类别进行分类，对难以判断的情况运用最佳判断，并在交接记录中注明真正处于边界的决策。

校准示例

这些示例设定了标准；词数表明，篇幅不是判断依据。

删除已实现的说明，例如：

• 折叠侧边栏控制栏 — 533 个词：已关闭、影响轻微的 UI 行为；
• issue-policy 模块所有权 — 已完成函数迁移和导入重连，行为未变。

保留已实现的说明，例如：

• 事件溯源会话 — 248 个词：基础权威来源和持久性边界；
• 单一 Harness-home 解析器 — 596 个词：跨产品所有权规则；
• 项目会话目录 — 628 个词：持久存储和身份策略；
• 并行 pre-push 门禁 — 400 个词：处于边界，但仍可指导门禁调度和资源调优；
• 已移除的图像内容块 — 334 个词：在多模态支持落地前保留，因为其中说明了协调重新引入的条件。

对于已否决的说明：

• 保留持续拆分压缩包 — 426 个词：合并这些包的诱惑仍然具有现实意义；
• 删除通过工具调用流式传输工作流进度 — 972 个词：其 ACP/UI 前提已过时；
• 删除丢弃 ACP 终端元数据 — 362 个词：后续仅面向自动化的 ACP 决策已解决此问题。

归档一组三文件

1. 将完整的 foo.md、foo.zh.md 和 foo.i18n.yaml 三文件组从 implemented/<kind>/ 移至 archived/<kind>/；归档路径中有意不包含 implemented。
2. 不修改正文。仅在两种语言文件中 Status: implemented 下方立即插入 Archived: YYYY-MM-DD，使用归档日期，并确保两边的值相同。
3. 以机械方式重新记录 sidecar 哈希，以反映这两处仅修改元数据的变更。不要翻译、重新排版、更新事实或修复说明中的链接。现有标题标点、空行布局和语言切换器措辞应予保留，但并非归档的前提。
4. 搜索活动正文中指向该说明的入站链接。将其重定向到当前权威内容，仅在有意引用历史快照时才改为指向归档路径，或删除链接。绝不要验证或修复归档说明中的出站链接。
5. 运行 pnpm run verify-archived-agent-notes --write。其仅追加模式会先验证每个现有封存项仍然匹配，然后只添加新三文件组的哈希。之后运行常规验证器。

三文件组封存后，绝不要编辑、移动、翻译、重新排版或删除它。归档说明仍可作为有效的入站链接目标，但它们是历史快照，不代表当前行为的权威说明。

验证并报告

运行归档验证器的专项测试、pnpm run verify-archived-agent-notes、pnpm run doc-sync、pnpm run lint 和 git diff --check；通过 dsh-pre-push-checks 选择任何额外的验证依据。

报告保留的活动已实现说明、删除或归档的已实现说明、保留或删除的已否决说明、任何被否决的拟议说明，以及每个确实处于边界的案例、其词数和最终处理结果。不要声称归档说明的出站链接有效：归档验证器有意不检查这些链接。