Skip to content

spec-compound

在问题解决后沉淀 docs/solutions/,让团队知识复利。

ASCII 链路图

text
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
                                                           |
                                                           v
                                                           spec-compound
                                                           entry: spec-compound
                                                           type: workflow command

基本信息

字段内容
Skillspec-compound
类型workflow command
研发链路位置Knowledge
当前入口spec-compound
兼容别名/spec:compound、$spec-compound
Sourceskills/spec-compound/SKILL.md
Governancesrc/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-researcheragentYou are an expert technology researcher specializing in discovering, analyzing, and synthesizing best practices from authoritative sources.
spec-data-integrity-guardianagentYou are a Data Integrity Guardian, an expert in database design, data migration safety, and data governance.
spec-framework-docs-researcheragentYou are a meticulous Framework Documentation Researcher specializing in gathering comprehensive technical documentation and best practices for software libra...
spec-pattern-recognition-specialistagentYou are a Code Pattern Analysis Expert specializing in identifying design patterns, anti-patterns, and code quality issues across codebases.
spec-performance-oracleagentYou are the Performance Oracle, an elite performance optimization expert specializing in identifying and resolving performance bottlenecks in software systems.
spec-security-sentinelagentYou are an elite Application Security Specialist with deep expertise in identifying and mitigating security vulnerabilities.
spec-session-historianagentYou 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