Menu
以正确的技能结构、渐进式披露与打包资源来创建新的 agent 技能。适用于用户希望创建、编写或构建新的技能。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | write-a-skill |
| description | 以正确的技能结构、渐进式披露与打包资源来创建新的 agent 技能。适用于用户希望创建、编写或构建新的技能。 |
收集需求 - 询问用户关于：
起草技能 - 创建：
SKILL.md 主说明与用户一起复核 - 展示草稿并询问：
skill-name/
├── SKILL.md # 主说明（必需）
├── REFERENCE.md # 详细文档（如需）
├── EXAMPLES.md # 使用示例（如需）
└── scripts/ # 工具脚本（如需）
└── helper.js
---
name: skill-name
description: 对能力的简短说明。适用于 [特定触发条件]。
---
# 技能名称
## 快速开始
[最小可用示例]
## 工作流
[包含检查清单的分步骤流程（适用于复杂任务）]
## 高级特性
[如需更详细内容：见 [REFERENCE.md](REFERENCE.md)]
描述是你的 agent 在决定加载哪个技能时，唯一会看到的内容。它会与其他已安装技能一起展示在系统提示词中。agent 会读取这些描述，并根据用户请求选择最相关的技能。
目标：让 agent 只需要获得足够信息即可判断：
格式要求：
良好示例：
从 PDF 文件中提取文本与表格，填写表单并合并文档。适用于处理 PDF 文件，或用户提到 PDF、表单、文档提取等场景。
不良示例：
处理文档。
该不良示例无法让 agent 与其他文档类技能区分开来。
当需要以下情况时，添加工具脚本：
相较于生成代码，脚本可以节省 token，并提升稳定性与可预期性。
当出现以下情况时，将内容拆分到独立文件：
SKILL.md 超过 100 行起草完成后，请复核：
SKILL.md 行数少于 100使用 tracer-bullet 竖向切片法，把 PRD 拆分成彼此独立、可以直接认领的 GitHub issues（并形成对应的实现工单）。适用于用户想把 PRD 转成 issues、创建实现任务，或把 PRD 拆成工作项。
使用 tracer-bullet 竖向切片方法把 PRD 转换成多阶段的落地实施计划，并保存为本地 Markdown 文件（存放在 `./plans/`）。适用于用户希望把 PRD 拆分为多个阶段、生成实施计划、从 PRD 推导阶段计划，或提到 “tracer bullets”。
通过用户访谈创建一个详细的重构计划，并将其拆分成很小的提交（tiny commits），最后以 GitHub issue 的形式归档。适用于用户希望规划一次重构、创建重构 RFC，或把重构拆成安全的渐进步骤。
使用 RED-GREEN-重构（red-green-refactor）循环进行测试驱动开发。适用于用户希望用 TDD 构建新功能或修复 bug，提到 “red-green-refactor”，希望使用集成测试，或询问“test-first development（先写测试）”。
通过探索代码库对 Bug/Issue 进行排查归因，并基于 TDD 方式生成修复计划，同时创建对应的 GitHub issue。适用于用户报告了 bug、希望创建 issue、提到“triage”，或想调查并规划某个问题的修复方案。
从当前对话中抽取 DDD 风格的“统一语言”术语表（ubiquitous language glossary），标记歧义，并提出规范的术语选择。保存为 `UBIQUITOUS_LANGUAGE.md`。适用于用户希望定义领域术语、构建术语表、固化用词并强化术语一致性，或提到 “domain model” / “DDD”（领域模型与 DDD）。