spec-compound-refresh
刷新、合并、替换或删除已经漂移的 docs/solutions/ learning docs。
基本信息
| 字段 | 内容 |
|---|---|
| Skill | spec-compound-refresh |
| 类型 | workflow command |
| 研发链路位置 | Knowledge |
| 入口 | /spec:compound-refresh / $spec-compound-refresh |
| Source | skills/spec-compound-refresh/SKILL.md |
描述
Refresh stale learning docs and pattern docs under docs/solutions/ by reviewing them against the current codebase, then updating, consolidating, replacing, or deleting the drifted ones. Trigger this skill when the user asks to refresh, audit, sweep, clean up, or consolidate stale docs in docs/solutions/ (phrases like "refresh my learnings", "audit docs/solutions/", "clean up stale learnings", "consolidate overlapping docs", "compound refresh", "spec-compound-refresh"), or when spec-compound has just captured a new learning and flagged a specific older doc in docs/solutions/ as now inaccurate or superseded — invoke with the narrow scope hint spec-compound provides. Also trigger when the user points at a specific learning or pattern doc under docs/solutions/ and calls it stale, outdated, overlapping, or drifted. Do not trigger for general refactor, migration, debugging, or code-review work unless the user has explicitly directed attention to docs/solutions/ itself.
何时使用
- 用户明确指出 learning stale、overlap 或 drift。
- 新 compound 文档发现旧知识冲突。
- 需要清理重复或过期经验。
工作步骤
- 读取已完成工作、历史会话、Slack、release 记录或 docs/solutions。
- 抽取可复用经验、已验证解法、上下文决策和过期知识。
- 写入或刷新团队知识，并保留证据限制。
- 让下一次 Codebase、Spec、Plan 或 Review 能复用这些知识。
输出
- solution docs、refresh report、session digest、Slack research digest 或 release notes。
- 对重复、过期或冲突知识给出合并、替换、删除或保留判断。
Agent 调度
- 可使用 session historian、Slack researcher、learnings researcher、related docs finder 等研究型能力。
- 知识写入由 orchestrator 负责，研究 agents 返回证据而不是直接写最终文档。
边界
- 不因普通 refactor 自动触发。
- 必须用当前代码或证据确认漂移。