AGENT SKILL

specdev-a-archive-and-consolidate

结束交付并整理历史,或独立审计、更新项目的 ADR、背景、故障经验与长期设计。

License 许可
MIT
所属仓库
NAMEWTA/Speculo
最近更新
2026-11-13
Stars
★ 2
Forks
0

01 前言 Front Matter

name
specdev-a-archive-and-consolidate
description
结束交付并整理历史,或独立审计、更新项目的 ADR、背景、故障经验与长期设计。

03 SKILL.md 正文

知识提纯与归档

本入口可以单独维护某个知识主题,也可以为一次已结束的交付收尾。先读取相关实际材料,范围明确的任务直接处理,不要求先创建 change 或额外批准表。

提纯有长期价值的事实

按 持久化 选择已有位置,优先更新原记录:

  • ADR:重要决定、真实替代方案、取舍与后果。
  • context:代码和配置不能直接表达的业务背景、边界与稳定事实。
  • error:有证据的故障机制、有效修复与防止重演的方法。
  • design:当前有效设计源、必要候选和使用说明,允许代码或图像。

只保存未来仍会改变判断或行动的内容。普通局部改动无需新增 ADR;未验证的推测不写成通用经验。来源、适用条件和当前版本应可定位。

更新当前工程文档时核对代码,删除或修正过时事实;重要决定被替代时保留原理由并链接后继决定。用户要求从代码提炼知识时,先调查实现与真实背景,未知意图不能凭源码猜成历史理由。

只读知识审计返回发现与建议;已要求维护时直接更新范围内材料并回读。短记录不需单独索引,重复事实不因分散目录就保留多份。

结束与归档

核对原交付范围、实际结果、未完成事项及外部动作。技术检查、发布结果和明确要求的用户验收分别说明;待验收不能自行写成接受,取消也应来自真实任务决定。

当前设计与环境方法留在长期位置维护。交付记录保留当时采用的设计版本、来源和真实结果,再按需要移入 .agents/speculo/.speculo/archive/<name>/,名称保持可识别。

移动前确认目的地未占用、引用能继续定位、没有正在写入的冲突;移动后读回完整资料与链接。独有用户材料和有用的未完成工作保留可发现入口,不因归档就被视为解决。

历史原貌保持可回读,后续变化写入当前知识或新交付记录。无需长期价值的临时材料可按任务范围清理,但不要把唯一证据、原型源或用户资产当作冗余。

交付

说明实际维护了哪些知识、保留哪些历史、归档到哪里,以及剩余事项怎样接续。没有需要提纯的内容是有效结果;无需每次强制生成四类知识或一份专门归档回执。

04 同仓库更多 Skills