是什么
它是什么
Skills 适合记录会反复使用的流程，例如工程 grilling、学术 pipeline、部署检查和代码 review。公开指南需要区分官方能力、第三方仓库和本机自写 skills。想按任务比较 Codex 生态仓库时，看 Codex 相关高 stars 开源仓库；想把原始请求改写成 GPT-5.6 任务合同，看 GPT-5.6 提示词与 refine-user-prompt。
触发条件什么时候必须使用，什么时候不该使用。
输入合同需要仓库、目标、范围、预算、人工 checkpoint。
执行步骤先读哪些文件，是否允许 subagent，如何验证。
输出合同产物、证据、风险、下一步和本地限制。
何时使用
什么时候用 / 不用
当任务模式稳定、输入输出明确、需要多次复用时用 skill。一次性的想法、未定边界和临时偏好，不应该急着做成 skill；先用普通任务跑通，再把稳定流程沉淀。
示例
可复制示例
$grill-with-docs
仓库：/path/to/repo
目标：把功能 X 做成可发布版本。
请先读 AGENTS.md、README、相关源码，再追问关键边界。结构解剖
Skill 应该沉淀什么
Skill 的重点不在于把 prompt 写长，而在于把流程写成可复用的操作规程。官方 skill 机制通常围绕 SKILL.md 展开，并可配合 scripts/、references/、assets/。公开指南需要让读者知道：什么时候直接写 prompt，什么时候值得做 skill。
生命周期
从 prompt 到 skill 的生命周期
flowchart LR
A["一次性 prompt"] --> B["重复使用 2-3 次"]
B --> C["提取输入 / 边界 / 步骤"]
C --> D["写入 SKILL.md"]
D --> E["加入验证和失败条件"]
E --> F["版本维护 / 标注 local adaptation"]
模板
一个实用 Skill 模板
---
name: my-review-flow
description: Review a repo change for behavior regressions, test gaps, and docs drift.
---
Use when:
- The user asks for review, PR readiness, or risk audit.
Before acting:
- Read AGENTS.md and nearest project instructions.
- Inspect git diff and relevant tests.
- Do not edit files unless explicitly asked.
Process:
1. Identify changed behavior.
2. Check tests and docs.
3. Rank findings by severity.
4. Report only actionable issues with file evidence.
Output:
- Findings first.
- Then open questions.
- Then verification gaps.真实实例
真实实例：区分官方指南和第三方 skill
本指南同时保留多个扩展入口：Codex 相关高 stars 开源仓库 用来比较第三方 skills 仓库；Compound Engineering 是 EveryInc 的插件仓库；refine-user-prompt 是基于 OpenAI GPT-5.6 提示原则设计的第三方 skill。它能复用官方方法，但不是 OpenAI 官方发布的能力。
判断顺序：
1. 官方 Codex 能力是否足够
2. 是否有可安装插件，例如 Compound Engineering
3. 是否有第三方 skills 仓库可复用
4. 第三方 skill 的来源、授权和验证是否清楚