القائمة
引导创建符合团队约定的 SKILL.md 文件。 仅当用户明确说出"使用 my-create-skill"或"启动 my-create-skill"时触发。 不适用于任何隐式场景。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | my-create-skill |
| description | 引导创建符合团队约定的 SKILL.md 文件。 仅当用户明确说出"使用 my-create-skill"或"启动 my-create-skill"时触发。 不适用于任何隐式场景。 |
引导用户创建高质量 skill，遵循团队统一约定。所有输出必须符合 AGENTS.md 规范。
此 skill 仅通过显式调用触发。
必须同时满足：
每个 skill 是一个目录，包含 SKILL.md 和可选资源：
skill-name/
├── SKILL.md 必需 — 主指令
├── scripts/ 可选 — 可执行脚本（确定性任务）
├── references/ 可选 — 深度参考文档
└── assets/ 可选 — 输出模板、图片等资源
三级渐进加载：元数据（常驻） → SKILL.md body（触发时） → 参考文件（按需）。
以下是创建 skill 的默认方案，大部分情况适用。用户明确要求时可覆盖。
默认手动触发。 description 和 body 中默认声明手动触发条件。
用户明确要求自动触发时：
只保留开放标准的 name + description，禁止 when_to_use、argument-hint、arguments 等非标准字段。
手动触发默认格式：
---
name: skill-name
description: >-
{1句话描述功能，第三人称，关键词密集}。
仅当用户明确说出"使用 {skill-name}"或"启动 {skill-name}"时触发。
不适用于任何隐式场景。
---
自动触发格式（用户明确要求时）：
---
name: skill-name
description: {1句话描述功能，第三人称，关键词密集}
---
在 body 中说明自动触发条件。
name：kebab-case，≤64 字符，小写字母+数字+连字符 description：≤1024 字符，必须包含 WHAT（功能）+ WHEN（触发声明，手动或自动）
手动触发 skill，标题之后、正文之前，需包含：
## 触发约束
此 skill **仅通过显式调用触发**。
### ⛔ 不触发的场景
- 用户提到相关功能但未提及 {skill-name}
- 日常文档编辑、代码编写、完成任务后的"顺便"操作
- 用户未显式引用 @{skill-name}
### ✅ 触发条件
必须同时满足：
1. 用户明确说出"使用 {skill-name}"或"启动 {skill-name}"，或显式引用 @{skill-name}
2. 用户提供了明确需求或上下文
⛔ 场景第一条根据 skill 功能定制具体关键词。
{相关目录}），不用具体项目目录名（如 material/）确认以下信息：
~/.codex/skills/ 或项目 .agents/skills/~/.claude/skills/ 或项目 .claude/skills/~/.cursor/skills/ 或项目 .cursor/skills/如果有对话上下文已包含这些信息，直接复用，不用重复提问。
根据意图决定目录结构：
| 场景 | 结构 |
|---|---|
| 纯知识型 skill | 只需 SKILL.md |
| 需要可执行工具 | 加 scripts/ |
| 有深度参考内容 | 加 references/ |
| 需要输出模板 | 加 assets/ |
不要预设所有目录都需要，按需创建。
按顺序编写：
写作原则：
写作时自检：
find material/ → 改为 find {相关目录}）校验清单：
格式检查：
内容质量检查：
触发条件：skill 涉及多步骤流程或技术细节时执行。
模拟执行：
输出格式示例：
模拟执行发现问题：
- Phase 1 "识别相关目录" 缺少具体方法
补充：关键词推断 → 查看CLI入口 → 查看数据结构
不符合时修正，符合时跳过此环节。
~/.codex/skills/ 或项目 .agents/skills/~/.claude/skills/ 或项目 .claude/skills/~/.cursor/skills/ 或项目 .cursor/skills/| 反模式 | 正确做法 |
|---|---|
| description 写成流程总结（"先做 X，再做 Y"） | 只写 WHAT + WHEN，流程放 body |
when_to_use、argument-hint 等非标准字段 | 只用 name + description |
| 把所有内容塞进 SKILL.md | 超过 500 行就拆分到 references/ |
| 给一堆选项让 agent 自己选 | 提供默认方案 + 逃生口 |
| 写 "Before August 2025" 类时间敏感内容 | 用 <details> 折叠旧方案 |
| 术语前后不一致 | 选定一个词全文统一 |
泛名如 helper、utils | 具体动词命名如 processing-pdfs |
举例用具体项目目录（如 find material/） | 用通用占位符（如 find {相关目录}） |
| 指标写成固定要求（如"必须统计API调用"） | 用可选维度（如"可选：规模/时间维度"） |
| 步骤只有名称（如"识别相关目录"） | 补充执行方法（关键词推断、查看CLI入口等） |
| 假设项目结构（如"infra/"、"cli/"） | 用通用表述（如"现有服务/模块"、"命令入口"） |
分析 git 变更并生成规范的 commit message，遵循 Conventional Commits 格式和中文结构化正文。 自动过滤 AI 供应商文案。仅当用户明确说出"使用 commit-msg"时触发。
复杂任务前先规划执行策略，明确步骤、依赖、风险。仅当用户明确说出"使用 plan-first"或"启动 plan-first"时触发。不适用于任何隐式场景。
以 agent 对话为主扫描源，git 提交和反馈归档为验证补充，发现可复用的高频模式。 不预设模式类型，让模式自然浮现，所有候选由用户判断价值。 仅当用户明确说出"使用 skill-discovery"或"启动 skill-discovery"时触发。 不适用于任何隐式场景。
使用 nm-search 或启动 nm-search 时，用于检索小说素材参考；不适用于未显式点名该 Skill 的普通搜索请求。
分析指定改动的上下游影响，追踪调用链，发现潜在缺陷和隐患。仅当用户明确说出"使用 code-review-change"或"启动 code-review-change"时触发。不适用于任何隐式场景。
对项目代码执行全量质量检查，覆盖格式、命名、引用、注释、逻辑、风格、边界、文档八大维度， 生成结构化 Markdown 报告。当用户要求代码审查、代码质量检查、查找代码问题时使用。