用途
archive-agent-notes 用于管理 Agent Notes 的完整生命周期,包括添加、修剪、归档、恢复和审查。其目标是在不抹除仍可指导工作的历史的前提下,减少活跃决策语料。该技能明确要求对每条笔记进行语义判断,字数和时间只是发现辅助,绝不能作为归档标准。
主要能力
- 在分类前阅读仓库的 Agent Note 规则、归档说明和适用的生命周期说明。
- 新增笔记时触发对覆盖同一决策或机制的活跃笔记进行范围审计。
- 在撰写新笔记时对完全或部分取代关系进行分类:在同一 PR 中归档符合条件的已实现三元组,保留并交叉链接部分取代,拒绝过时提案,删除不再能防止合理错误的已拒绝笔记。
- 当新所有者吸收所有独特命题时应用合并规则,整体删除被吸收的三元组,不推迟已知匹配。
- 按未来价值对笔记分类:已实现—保留活跃、已实现—归档、提议—永不归档、已拒绝—仅作护栏保留、已拒绝—删除。
- 归档单个已实现三元组:不修改正文,仅在两份语言文件的 Status: implemented 下方插入 Archived: YYYY-MM-DD,两侧使用相同日期。
- 使用仓库的配对记录器以写入模式机械重录两次仅元数据编辑的一致性记录。
- 将完整的 foo.md、foo.zh.md 和 foo.i18n.yaml 三元组从 implemented/{class}/ 移动到 archived/{class}/。
- 搜索活跃正文中的入站链接,将其重定向到当前权威、仅在有意引用历史快照时重定向到归档路径,或删除。
- 当入站链接修复编辑了活跃双语文档时,将对应更新交给 translate-docs,确保在配对门禁前两侧同步。
- 运行仓库的归档封存门禁(先写入模式,再正常模式)、文档门禁和 git diff --check。
- 报告保留的活跃已实现笔记、归档的已实现笔记、保留/删除的已拒绝笔记、被拒绝的提议笔记(如有),以及每个真正边界情况及其选择结果。
使用方式
该技能以规则和流程形式描述操作步骤,未提供具体安装命令或代码示例。使用时应遵循仓库自身的 Agent Note 规则、归档说明和生命周期说明。归档操作要求:不修改正文,仅插入 Archived 日期;机械重录一致性记录;移动完整三元组;修复入站链接;归档后不再编辑、移动、翻译、重排或删除该三元组。
适用场景
适用于需要管理 Agent Notes 的仓库或项目,特别是在新增笔记、修剪活跃决策语料、归档已实现决策、恢复或审查笔记时。也适用于需要保持双语笔记同步、维护入站链接正确性的场景。
限制
- 不得以配额为目标进行归档。
- 必须检查范围内每条笔记,将类似组按同一原则分类,并记录真正边界情况。
- 归档后三元组是历史快照,不是当前行为的权威,但仍可作为入站链接目标。
- 不得在归档笔记内部验证或修复链接。
- 提议笔记永不归档;若不再值得推进,应以诚实理由拒绝。
- 已拒绝笔记仅在失败提案仍是诱人且有意义的错误时保留为护栏。
- 具体安装命令、代码示例、收费或价格信息暂未提供。