参考
技能
存放在 SKILL.md 文件中的可复用、可检测的技术，带有检测信号、流程，以及面向计划套件与生态系统审计的强制执行钩子。
技能以文件夹的形式存放在 src/apothem/skills/ 下，每个文件夹都有一个 SKILL.md 入口点。技能记录可复用、可检测的技术——它们具有一个检测信号、一套流程和一个强制执行钩子。
完整的技能目录在下方的生成的技能清单中生成。
Frontmatter 契约
SKILL.md 携带规范的八键 frontmatter。机器可读的契约是 skill.schema.json（additionalProperties: false）；以下代码块与其保持一致：
---
name: <skill name>
version: <semver>
updated: <YYYY-MM-DD>
description: <one-line role>
archetype: <class-template, e.g. workflow-template>
userInvocable: <true | false>
disable-model-invocation: <true | false>
allowed-tools: <comma-separated read-only tools and scoped rules, e.g. "Read, Glob, Grep" or "Read, Bash(git log *)">
---按工具输出
源技能使用上述键。某些工具读取不同的键，因此安装只针对该工具转换这些键：
| 工具 | 安装会更改什么 |
|---|---|
| Claude Code（安装与插件） | 将 userInvocable 重命名为 user-invocable，即 Claude Code 读取的键。Claude Code 会忽略驼峰式的键，因此如果不重命名，标记为 userInvocable: false 的技能仍会显示在 / 菜单中。 |
共享的用户级技能文件夹：~/.agents/skills/（由 Codex、Cursor、GitHub Copilot、Windsurf 和 Zed 写入）以及 ~/.codebuddy/skills/、~/.kiro/skills/ 和 ~/.trae/skills/ | 写入这些文件夹之一的每次安装都使用同一种形式，因此各次安装绝不会相互改写对方的文件。它将 userInvocable 重命名为 user-invocable，把 version、updated、archetype 和 portability 移入末尾一个由带引号字符串组成的 metadata: 映射，并在源文件设置了 disable-model-invocation: true 的每个技能旁边写入带有 policy.allow_implicit_invocation: false 的 agents/openai.yaml，因为 Codex 会忽略该键，并且无论是否由 Codex 适配器写入，它都会读取 ~/.agents/skills/。被包装为技能的命令完整保留其正文，并以一条固定的说明开头，该说明指明规则与模板文件夹 ~/.config/apothem/rules/ 和 ~/.config/apothem/templates/。剩下的顶层键为 name、description、user-invocable、disable-model-invocation、allowed-tools、argument-hint 和 metadata。 |
| Qwen Code | 将以逗号分隔的 allowed-tools 字符串改写为 allowedTools 列表，每行一个 YAML 条目，因为 Qwen Code 只读取驼峰式的键并要求其为列表。每个条目都保留源文件中的拼写，包括诸如 Bash(git status *) 之类的模式。其他所有键以及技能正文均原样安装。 |
| 其他工具 | 不作更改。 |
skill.schema.json 接受用户可调用性标志的任一种拼写，并要求恰好使用其中一种。
编写纪律
- 每个技能一个文件夹。 每个技能都是其自己的文件夹，入口点位于
SKILL.md。 - 检测信号。 技能正文以触发该技术的检测信号开头。
- 流程 + 强制执行。 技能同时携带要应用的流程，以及闭合循环的强制执行信号。
- 描述长度。
description最多 1,024 个字符，这是 Agent Skills 的限制。更严格的工具会拒绝或截断更长的描述，而 schema 会强制执行该限制。
生成的技能清单
| Name | Description | Source |
|---|---|---|
decision-matrix | Choose between two or more options with a weighted, evidence-cited matrix, a runner-up and a first step. Use when the user asks to 'compare these options', 'help me choose between', 'weigh the trade-offs' or 'which one should we pick'. Not for single-answer lookups or building a chosen option. | src/apothem/skills/decision-matrix/SKILL.md |
dependency-upgrade | Upgrade a project's third-party dependencies with changelog review, pinned versions and the host's lint, test and type-check gates. Runs only when the user invokes it (for example to bump deps or refresh the lockfile). Breaking and major bumps stop for a question; --dry-run classifies without writing; --package NAME scopes to one dependency. | src/apothem/skills/dependency-upgrade/SKILL.md |
dev-toolkit | Run a disciplined engineering loop: reproduce-first debugging, test-first red-green-refactor, vertical slices, or a requirement split into issues. Use for 'diagnose a bug', 'do TDD', 'break this into vertical slices' or 'turn this into issues'. Not for one-line edits or multi-agent orchestration. | src/apothem/skills/dev-toolkit/SKILL.md |
diagram-authoring | Author, validate and render diagrams (flowchart, sequence, state, ER, architecture) and data visualizations to SVG, PNG or PDF. Use when the user asks to 'draw a diagram', 'make a flowchart', 'render this Mermaid' or 'export a diagram to SVG'. Source is syntax-validated before render. | src/apothem/skills/diagram-authoring/SKILL.md |
document-authoring | Write a long, cited document (thesis, report, LaTeX) from an approved outline, with checked citations and a PDF compile. Use when the user asks to 'write a thesis', 'author a LaTeX document', 'compile this to PDF' or 'manage the bibliography'. Not for short edits; pipeline papers: research-paper. | src/apothem/skills/document-authoring/SKILL.md |
ecosystem-audit | Audit the apothem configuration tree as a whole for drift, orphans, dangling references and invalid frontmatter. Use when the user asks to 'audit the ecosystem', 'validate the apothem tree' or 'sweep for drift'. Report-only unless --fix is passed. Changed artifacts only: convention-auditor. | src/apothem/skills/ecosystem-audit/SKILL.md |
eval-harness | Build a reproducible evaluation harness for a prompt or model: versioned labeled dataset, scorer, runner and a report with pass rate, interval and regressions. Use when the user asks to 'build an eval' or 'compare models on a labeled task'. One campaign: eval; rubric scoring: prompt-evaluator. | src/apothem/skills/eval-harness/SKILL.md |
incident-runbook | Write or run an incident runbook (Trigger, Diagnosis, Action, Verification, Rollback) with a rollback per action and confirmation before live changes. Use when the user asks to 'write a runbook', 'define an on-call procedure' or 'document recovery steps'. Not for post-mortems. | src/apothem/skills/incident-runbook/SKILL.md |
issue-lifecycle | Takes a reported defect from issue to fix, one stage per run. Use for 'create an issue', 'size this issue', 'reproduce this bug', 'fix issue 123', 'ask the reporter for details' or 'open a draft PR'. Manual only; posts nothing unasked. Debug loops go to dev-toolkit, advisories to vuln-triage. | src/apothem/skills/issue-lifecycle/SKILL.md |
knowledge-wiki | Adds sources to and audits an index-first Markdown knowledge base, when the user asks to 'add this paper to the wiki', 'ingest these sources', 'lint the wiki' or 'what changed in the knowledge base'. Modes: ingest, lint, drift, hubs. Not source discovery or a one-off summary. | src/apothem/skills/knowledge-wiki/SKILL.md |
multi-source-research | Produces a cited, cross-verified research report with confidence levels, when the user asks to 'research X deeply', 'find sources on' or 'gather evidence about'. Finds new sources and writes the report; given documents: source-synthesis, one claim: fact-checker, a bare source list: research-scout. | src/apothem/skills/multi-source-research/SKILL.md |
paper-toolkit | Papers with no research suite: 'write a reading note', 'compare these papers', 'draft related work', 'what would reviewers ask', 'dedupe my references', 'turn DOIs into BibTeX entries'. Suite or referee review: research-* commands. Reference checks: citation-auditor. Loose files: source-synthesis. | src/apothem/skills/paper-toolkit/SKILL.md |
perspectives | Answers a contested question by arguing it from several separate viewpoints, then reconciling them, when the user asks to 'argue both sides', 'what would a skeptic say' or 'we are split on'. Weighted choices go to decision-matrix, claim checks to fact-checker, builds and reviews to workflow. | src/apothem/skills/perspectives/SKILL.md |
plan-suite | Master Plan Suite template, read by path by the /plan pipeline stages (spec, generate, review, design, audit, execute, status, amend). Holds master-template.md, the canonical plan-suite specification. A template, not invoked directly and not listed; use the /plan commands instead. | src/apothem/skills/plan-suite/SKILL.md |
projectify | Builds the Description, Instruction and knowledge files for a chat-app Project or custom assistant within a measured context budget, when the user asks to 'projectify this', 'write Project instructions' or 'set up a custom assistant'. Not for repository rules, skills or commands. | src/apothem/skills/projectify/SKILL.md |
prompt-engineering | Designs a structured prompt and validates it against happy, edge and adversarial eval cases, when the user asks to 'design a prompt', 'write a system prompt for' or 'improve this prompt'. Delivers the prompt plus its eval set; not a running agent or a model benchmark (eval-harness). | src/apothem/skills/prompt-engineering/SKILL.md |
refactor-extract | Extracts a symbol or file without changing behavior, interactively: specifies what it does, re-derives it clean-room, then checks nothing regressed, when the user asks to 'extract this function' or 'pull this out into its own module'. Delegated refactors: refactor-surgeon. | src/apothem/skills/refactor-extract/SKILL.md |
research-suite | Research Suite template, read by path by the /research pipeline stages (ideate through disseminate). Holds the canonical research-suite surface: the ten rigor mandates and the thirteen-stage lifecycle. A template, not invoked directly and not listed; use the /research commands instead. | src/apothem/skills/research-suite/SKILL.md |
secret-rotation | Use when a credential has leaked or been committed ('rotate a secret', 'a key leaked') and must be retired safely: revokes the exposed secret at its issuer first, re-issues a least-privilege replacement, rewires config through env vars or a secret manager, then checks no plaintext remains. Runs only when the user invokes it. | src/apothem/skills/secret-rotation/SKILL.md |
source-synthesis | Reconciles given documents into one cited synthesis separating consensus from contested claims, when the user asks to 'synthesize these sources', 'combine these documents' or 'what do these say together'. Needs two or more sources. Finding them: multi-source-research; gap map: research-synthesis. | src/apothem/skills/source-synthesis/SKILL.md |
surgical-guard | Makes a minimal, anchor-bounded edit, then reviews only its diff for swallowed errors, hollow tests and docs drift, when the user asks to 'edit surgically', 'make a minimal diff' or 'guard this change'. Not for working out what the change should be (dev-toolkit). | src/apothem/skills/surgical-guard/SKILL.md |
teaching-pack | Builds a teaching pack from one paper or technical document: goals, curriculum, formula walk-throughs, worked examples, quiz with key, glossary, slides on request. For 'teach me this paper' or 'make a study guide from this spec'. Several sources: source-synthesis; critique: research-review. | src/apothem/skills/teaching-pack/SKILL.md |
test-authoring | Writes new behavior-first tests in Arrange-Act-Assert form, failing assertions first, covering happy path, edge boundaries and failures, when the user asks to 'write tests' or 'test this function'. Authors tests only. Whole-repo suite: test-suite; running tests: test-runner. | src/apothem/skills/test-authoring/SKILL.md |
ui-design | Designs or refines a user interface: classifies the surface, applies design rules and keeps DESIGN.md current, when the user asks to 'design a landing page', 'improve this UI', 'make it look better' or 'pick a palette and type scale'. Not for critique-only review (design-critic) or backend logic. | src/apothem/skills/ui-design/SKILL.md |
vuln-triage | Triages one named CVE or security advisory: severity band, affected surface in the lockfile, reachability, and a patch, upgrade, mitigate or accept route, when the user asks to 'triage this CVE' or 'does this advisory affect us'. Does not apply fixes or scan the whole repository. | src/apothem/skills/vuln-triage/SKILL.md |
workflow | Use for a non-trivial mission that needs independent parallel work plus adversarial verification: decomposes it, dispatches independent subagents under named return contracts, runs a refute-by-default critique on every finding, and discloses any beyond-mission fixes. Runs only when the user invokes it, as in 'fan out and verify'. | src/apothem/skills/workflow/SKILL.md |