关于 skill
skill 是用于管理本地 SKILL.md 文件的技能，面向维护用户级或项目级技能的工作流。它涵盖创建、搜索、校验和同步，并要求对复制或覆盖进行确认。
主要功能
- 01列出、搜索和查看技能
- 02创建和编辑 SKILL.md
- 03移除技能前显式确认
- 04比较并确认跨范围同步
- 05校验技能且不改写文件
适用场景
- 01盘点用户级与项目级技能
- 02为代码库编写专用工作流技能
- 03验证技能元数据与正文
- 04同步两处技能目录
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/skill确认已加载。
详细介绍
技能管理
使用 /skill 命令管理本地 SKILL.md 文件。共享的执行、委派、状态、钩子、团队、取消、验证和升级不变量位于 templates/AGENTS.md；请遵循该契约，而不要在此重复。
<Use_When>
- 用户要求列出、添加、编辑、移除、搜索、检查、同步、设置、扫描或验证技能。
- 某个持久的、特定于代码库的解决方案或工作流应被记录为技能。 </Use_When>
<Do_Not_Use_When>
- 使用
/learner从对话中提取技能，使用/note记录简短笔记。 - 不要使用此提示词更改运行时代码、目录、钩子或安装逻辑。 </Do_Not_Use_When>
作用域与命令
规范根目录是 ${CODEX_HOME:-$HOME/.codex}/skills/（用户）和 .codex/skills/（项目）。技能位于 <root>/<name>/SKILL.md。
| 命令 | 契约 |
|---|---|
/skill list | 扫描两个根目录，解析 frontmatter，并显示名称、描述、触发词、作用域以及质量/使用情况（不可用时为 N/A）。 |
/skill add [name] | 运行编写向导，验证名称，选择作用域，创建 SKILL.md，并报告其路径。 |
/skill edit <name> | 查找一个作用域，显示元数据，然后更新描述、触发词、参数提示、正文，或重命名并报告更改。 |
/skill remove <name> | 查找技能，显示作用域和元数据，明确确认，然后移除其目录。 |
/skill search <query> | 不区分大小写地搜索名称、描述、触发词和正文；优先按名称/触发词匹配排序并显示上下文。 |
/skill info <name> | 显示解析后的元数据、作用域、路径和完整正文；不存在时建议 /skill search。 |
/skill sync | 比较用户级/项目级技能，显示仅用户级/仅项目级/共有的条目，并对每次复制或覆盖进行确认。 |
/skill setup | 确保两个根目录都存在，扫描它们，然后提供添加、列出、模式扫描、导入或完成选项。 |
/skill scan | 运行 setup 的扫描/清点，但不使用其交互式菜单。 |
/skill validate | 验证两个根目录中的每个技能，并报告每个路径的通过/失败结果；绝不重写文件。 |
带参数时，使用直接命令模式；不带参数时，使用引导式设置菜单。
编写契约
询问任何缺失的值：
name：小写字母/数字，由单个连字符分隔（[a-z0-9]+(?:-[a-z0-9]+)*）。description：简洁、非空的一行用途说明。triggers：以逗号分隔的识别词。argument-hint：可选的调用参数。scope：user或project。
在每个技能开头写入以下 frontmatter；可选元数据可以添加 id、source 和 quality，但不得替换必需字段：
---
name: <name>
description: <one-line purpose>
triggers: [<trigger1>, <trigger2>]
argument-hint: "<args>"
# optional: id, source, quality
---
使用可操作的正文。推荐的最小结构为：
# <Skill title>
## Purpose
What durable, codebase-specific outcome does this skill provide?
## When to Activate
Recognition signals, scope, and explicit non-goals.
## Workflow
1. Inspect the named files or inputs.
2. Apply the precise approach and record important assumptions.
3. Verify observable behavior and report evidence.
## Examples / Gotchas
Concrete invocation, edge cases, and failure recovery.
优先使用来之不易、非显而易见的经验，而不是通用编程建议。当确有帮助时，包含精确路径、命令、错误文本和预期证据。
验证与错误
在报告成功之前，检查文件存在、以 --- frontmatter 开头、具有非空的 name 和 description、使用有效名称，并且正文非空。
拒绝格式错误或未终止的 YAML、多行必需标量值、同一作用域中的重复名称、缺失的目录/文件、权限失败以及无效参数。一致地报告错误：
✗ Error: <clear message>
→ Suggestion: <specific next step>
退出契约
每个命令都以一个简洁结果结束：✓ 加上受影响的技能/路径和下一步操作，或 ✗ 加上错误和建议。在取消或仅验证运行时保留文件。对于 add/edit/sync，报告更改的作用域和元数据；对于 list/search/info/scan/validate，报告计数或匹配的路径以及任何失败。