技能

技能（Skills）是一种插件机制，通过安装预定义技能包扩展特定领域能力。技能本质是一组指令和上下文，告诉 AI Agent 如何处理特定类型任务。技能采用开放的 SKILL.md 格式，不绑定单一平台——Claude Code、Qoder 等支持技能机制的 Agent 都能加载同一份技能，在任何地方使用。

安装命令：npx skills add 从 GitHub 仓库拉取，或 /plugin install 安装官方技能。

官方文档技能

文档技能覆盖主流办公格式，让 Claude Code 直接操作文件而非仅生成内容。

技能	功能	适用场景
docx	创建、编辑、分析 Word 文档，支持跟踪更改	文档协作、合同审阅
xlsx	电子表格操作，支持公式、图表、数据转换	数据分析、报表生成
pptx	读取、生成和调整幻灯片	演示文稿制作
pdf	提取 PDF 文本、表格、元数据	文档解析、信息提取

/plugin install document-skills@anthropic-agent-skills

开发工作流技能

superpowers：完整软件开发工作流技能集，注入规划、测试、代码审查等规范。它不是一个单一技能，而是一整套工程规范，覆盖从需求分析到代码审查的完整链路。

npx skills add https://github.com/obra/superpowers

andrej-karpathy-skills：Andrej Karpathy 的编码行为准则，减少 LLM 常见编码错误。不是工具链技能，而是注入工程纪律——约束模型的编码行为模式。

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills

skill-creator：让 Agent 创建和修改技能本身，实现技能自我扩展。用它生成的技能是 .claude/skills/ 目录下的 Markdown 指令文件。

技能安装流程：

自动化与效率技能

技能	功能	安装命令
token-optimizer	Token 成本压缩：拦截工具调用输出、缓存优化、会话连续性	`/plugin marketplace add alexgreensh/token-optimizer` → `/plugin install token-optimizer@alexgreensh-token-optimizer`

我的技能清单

当前安装了 3 个技能，覆盖工程纪律、代码整洁、成本优化三个维度。

superpowers

来源：obra/superpowers-marketplace，状态：🔒 locked by plugin（系统保护，肌肉记忆级注入）。

核心纪律骨架。接管模型的原生 Agent 调用机制，注入工业级开发规范。它不是一个单一技能，而是一整套工程规范，覆盖从需求分析到代码审查的完整链路。

命令	用途
`/write-plan`	写计划书
`/brainstorm`	头脑风暴
`/execute-plan`	多线程执行并跑 TDD 测试
`/simplify`	代码审查与简化

没有纪律的 AI 会野蛮生长。superpowers 强迫 AI 按规范做事，而不是"想到哪写到哪"。

karpathy-skills

来源：andrej-karpathy-skills/karpathy-guidelines，状态：🔒 locked by plugin。

原子级代码微操。注入 Andrej Karpathy 的极简代码整洁之道，强迫模型在执行终端或文件操作时保持绝对的原子性和克制：

原子性 — 一次只做一件事
克制 — 不写多余的代码
清晰 — 代码即文档

token-optimizer

来源：alexgreensh/token-optimizer，状态：✔ active。

Token 成本优化器。通过 PreToolUse/PostToolUse hooks 拦截每次 Read 和 Bash 调用，在输出进入上下文之前进行语义压缩，同时将完整原始输出归档到磁盘。零依赖、零网络调用，纯本地 SQLite 存储。

核心压缩能力（均默认开启）：

能力	机制	典型节省
Delta Mode	文件重新读取时仅返回差异	约 20%
Structure Map	已读代码文件替换为函数签名骨架	约 30%（单文件最高 99%）
Bash Compression	CLI 输出压缩为精要摘要，覆盖 60+ 模式	约 10%
Search Compression	grep 结果压缩为命中行 + 计数	约 15%
Quality Nudges	上下文质量下降时注入警告，防止压缩丢失关键信息	防退化
Decision Extraction	实时检测决策语句，压缩时注入为 CRITICAL DECISIONS	防决策漂移
Loop Detection	检测 AI 重试循环（相似度 ≥ 0.7 的重复工具调用）	打断死循环

会话连续性：在自动压缩前进行渐进式检查点（20%/35%/50%/65%/80% 上下文填充率），压缩后自动注入 Context Intel Digest 摘要。跨会话时相关性评分的检查点自动浮现，实现冷恢复。

质量评分：两个维度 7 个信号，字母等级 S(90-100) → A(80-89) → B(70-79) → C(55-69) → D(40-54) → F(0-39)。SessionEnd 后自动生成 HTML 仪表板。

安装：

/plugin marketplace add alexgreensh/token-optimizer
/plugin install token-optimizer@alexgreensh-token-optimizer
/token-optimizer

我的插件

claude-hud 是插件而非技能——技能向模型注入指令和领域规范，插件提供独立的运行时能力（如可视化、hooks），两者都通过 /plugin 机制分发。

claude-hud

来源：claude-hud/claude-hud，状态：✔ active。

实时抬头显示仪表盘。在终端边缘为你实时滚动 Token 消耗、当前 Agent 的任务状态以及时钟时长，让你对后台发生了什么一目了然。

安装：

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/cla AHUD:setup

与 token-optimizer 的关系

claude-hud 是"实时仪表盘"——让你看到 token 消耗了多少；token-optimizer 是"成本优化器"——主动压缩减少消耗。两者互补，建议同时安装。

辅助工具

工具	功能	安装方式
claude-mem	跨会话持久化记忆，记住偏好和上下文	`/plugin marketplace add thedotmack/claude-mem` → `/plugin install claude-mem`
get-shit-done	规格驱动开发，解决长会话质量劣化	`npx get-shit-done-cc@latest`

安装配置见 Claude Code。

常见问题

技能问题的排查路径：安装失败看网络，冲突看优先级，加载慢看缓存。

问题	解决方案
技能安装失败	确认能访问 GitHub，或配置代理；`/plugin install` 需要已连接模型
技能冲突	在 `CLAUDE.md` 中明确优先级，或卸载冲突技能
技能加载缓慢	首次需下载，后续用缓存；检查 npm 缓存是否被清理工具误删
自定义技能	用 skill-creator 创建，技能本质是 `.claude/skills/` 目录下的 Markdown 指令文件