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
specdev-w-wayfinder
当大型需求的边界、可行路线或子问题尚不清楚时进行目标导向探索,形成可实施范围与关键证据。
specdev-v-inventory-view
查看服务器、项目、共享服务和部署版本的对应关系,区分已有配置、最新观测与未知状态。
specdev-t-triage
收集多渠道需求、浏览待办并评估 issue、PR 或本地请求,形成有依据的优先级和可继续实施的简报。
specdev-t-tickets
把清晰规格拆成可独立实施和验收的切片,保留真实依赖与协作边界。
specdev-s-spec
综合需求、已确认设计、代码事实与关键决定,形成可实施、可验证的行为规格。
specdev-s-server-connect
接入指定本地或远程服务器,核实身份、账号、权限与部署根,保存可复用连接信息。