spec-compound
在问题解决后沉淀 docs/solutions/,让团队知识复利。
ASCII 链路图
text
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
|
v
spec-compound
entry: spec-compound
type: workflow command基本信息
| 字段 | 内容 |
|---|---|
| Skill | spec-compound |
| 类型 | workflow command |
| 研发链路位置 | Knowledge |
| 当前入口 | spec-compound |
| 兼容别名 | /spec:compound、$spec-compound |
| Source | skills/spec-compound/SKILL.md |
| Governance | src/cli/contracts/dual-host-governance/skills-governance.json(supported-host skills governance) |
描述
Document a recently solved problem or durable project vocabulary in docs/solutions/ or CONCEPTS.md. Use when capturing a learning after work.
Source 契约摘要
该 source skill 未声明标准 Workflow Contract Summary 小节;本页以 frontmatter、supported-host governance 和维护者补充元数据为准。
何时使用
- 刚解决一个值得复用的问题。
- 需要记录 root cause、solution、prevention 或 practice。
- 希望下次相似问题能从知识库检索。
工作步骤
- 读取已完成工作、历史会话、Slack、release 记录或 docs/solutions。
- 抽取可复用经验、已验证解法、上下文决策和过期知识。
- 写入或刷新团队知识,并保留证据限制。
- 让下一次 Codebase、Spec、Plan 或 Review 能复用这些知识。
输出
- solution docs、refresh report、session digest、Slack research digest 或 release notes。
- 对重复、过期或冲突知识给出合并、替换、删除或保留判断。
Agent / Persona 列表
- 可使用 session historian、Slack researcher、learnings researcher、related docs finder 等研究型能力。
- 知识写入由 orchestrator 负责,研究 agents 返回证据而不是直接写最终文档。
本 skill 在 source 中挂载了 7 个 skill-local 专家资产(agent 7 · persona 0),路径为 skills/spec-compound/references/{agents,personas}/。跨 skill 复用时,详情页按文件名去重。
| 名称 | 类型 | 摘要 |
|---|---|---|
spec-best-practices-researcher | agent | You are an expert technology researcher specializing in discovering, analyzing, and synthesizing best practices from authoritative sources. |
spec-data-integrity-guardian | agent | You are a Data Integrity Guardian, an expert in database design, data migration safety, and data governance. |
spec-framework-docs-researcher | agent | You are a meticulous Framework Documentation Researcher specializing in gathering comprehensive technical documentation and best practices for software libra... |
spec-pattern-recognition-specialist | agent | You are a Code Pattern Analysis Expert specializing in identifying design patterns, anti-patterns, and code quality issues across codebases. |
spec-performance-oracle | agent | You are the Performance Oracle, an elite performance optimization expert specializing in identifying and resolving performance bottlenecks in software systems. |
spec-security-sentinel | agent | You are an elite Application Security Specialist with deep expertise in identifying and mitigating security vulnerabilities. |
spec-session-historian | agent | You are an expert at extracting institutional knowledge from coding agent session history. |
agent 详情页入口仍在
/reference/agents/*;完整按 skill 归属索引见 Agents 参考。persona 目前以 skill-local prompt 形式挂在所属 skill 下,不单独生成全局详情页。
边界
- Full 模式会询问是否搜索 session history。
- 不应为尚未验证的猜测创建 solution doc。
源码校准
- 本页由
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。
