spec-compound-refresh
刷新、合并、替换或删除已经漂移的 docs/solutions/ learning docs。
ASCII 链路图
text
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
|
v
spec-compound-refresh
entry: spec-compound-refresh
type: workflow command基本信息
| 字段 | 内容 |
|---|---|
| Skill | spec-compound-refresh |
| 类型 | workflow command |
| 研发链路位置 | Knowledge |
| 当前入口 | spec-compound-refresh |
| 兼容别名 | /spec:compound-refresh、$spec-compound-refresh |
| Source | skills/spec-compound-refresh/SKILL.md |
| Governance | src/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance） |
描述
Refresh docs/solutions learnings against the current codebase. Use when auditing stale, overlapping, superseded, or drifted learnings; avoid general refactor, debugging, or code review unless docs/solutions is explicit.
Source 契约摘要
该 source skill 未声明标准 Workflow Contract Summary 小节；本页以 frontmatter、supported-host governance 和维护者补充元数据为准。
何时使用
- 用户明确指出 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 返回证据而不是直接写最终文档。
本 skill 当前没有 skill-local references/agents 或 references/personas 文件；默认由 orchestrator 直接完成，或按阶段需要临时调用其他 skill 的专家。
边界
- 不因普通 refactor 自动触发。
- 必须用当前代码或证据确认漂移。
源码校准
- 本页由
website/scripts/generate-skill-detail-pages.js从上游 source skill 生成。 - 当前入口、兼容别名与宿主投递 metadata 来自
src/cli/contracts/dual-host-governance/skills-governance.json。 - 当 source skill 或 governance contract 变化后，应重新运行
npm run reference:pages并执行npm run content:audit。