菜单
指导编写和改进 Agent Skill 文件（SKILL.md），涵盖 YAML frontmatter、精简写作、渐进式披露、常用模式。当用户要创建新 Skill、改进现有 SKILL.md、或询问 Skill 编写规范时使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
代码文件修改的统一入口。当用户请求任何代码变更（新功能、优化、Bug 修复、重构）时必须首先调用此 skill。仅适用于代码文件（如 .cc/.cpp/.h/.go/.py 等），修改 .md 等非代码文件时不需要调用。它会评估复杂度、检查 spec.md、生成 tasks.md、并逐个任务执行。
测试生成。基于 spec.md 或被测代码，生成单元测试、集成测试、性能测试。当用户请求生成测试、TDD 模式、或 workflow-code-generation 完成后触发。
将纠错经验沉淀为持久化的 Rules/Skills 更新，构建反馈闭环。当被用户纠正且错误具有模式性时自动触发，或通过 /reflect 命令手动触发回顾。
问题排查。当用户遇到编译错误、运行时异常、单测失败、流水线报错、现网告警等需要定位问题时触发。
代码评审。协调 5 个专项 reviewer subagent 对代码进行并行多维度审查。可由用户直接触发，也可由主 agent 加载后作为 Judge 执行。
需求澄清。只负责明确"要解决什么问题"，生成 spec.md 的前三章节（背景、目标、需求）。禁止在本阶段讨论设计方案——设计是 workflow-system-design skill 的职责。
| name | bp-skill-authoring |
| description | 指导编写和改进 Agent Skill 文件（SKILL.md），涵盖 YAML frontmatter、精简写作、渐进式披露、常用模式。当用户要创建新 Skill、改进现有 SKILL.md、或询问 Skill 编写规范时使用。 |
Skills 使用中文编写，包括：
description：中文描述---
name: processing-pdfs # 小写，连字符，最多 64 字符
description: 从 PDF 文件中提取文本... # 中文，第三人称，做什么 + 何时用，最多 1024 字符
---
name 格式：
processing-pdfs, analyzing-data, testing-codepdf-processing, data-analysishelper, utils, tools, anthropic-*, claude-*description 规则：
只添加 AI 尚不知道的信息：
✅ 好（~50 tokens）：
## 锁
使用 TDMutex，不要用 std::mutex：
tdstore::common::TDMutex mutex_;
❌ 差（~150 tokens）：
## 锁
线程安全在多线程应用中很重要。
TDStore 使用 bthread 协程，所以需要特殊的锁...
reference/guide.md）skills/
├── <skill-name>/ # 通用技能
│ └── SKILL.md
└── <module>/ # 模块专项技能
└── <skill-name>/
└── SKILL.md
示例：
skills/
├── writing-skills/ # 通用：编写 Skills 指南
│ ├── SKILL.md
│ └── reference/
└── backend/ # 模块：后端
├── coding-standards/ # 编码规范
│ └── SKILL.md
└── storage-modifications/ # 存储改造规范
└── SKILL.md
命名规则：
backend, storage, scheduler 等coding-standards, storage-modifications, testing 等单个 Skill 内部结构：
skill-name/
├── SKILL.md # 概览（触发时加载）
├── reference/
│ ├── topic-a.md # 按需加载
│ └── topic-b.md
└── scripts/
└── validate.py # 执行，不加载到上下文
在 SKILL.md 中链接到详情：
## 快速开始
[基本用法]
## 进阶
**主题 A**：参见 [reference/topic-a.md](reference/topic-a.md)
**主题 B**：参见 [reference/topic-b.md](reference/topic-b.md)
## 输出格式
始终使用以下结构：
# [标题]
## 摘要
## 发现
## 建议
## Commit 消息
**示例 1：**
输入：Added auth
输出：`feat(auth): implement JWT authentication`
**示例 2：**
输入：Fixed date bug
输出：`fix(reports): correct timezone conversion`
## 迁移工作流
复制并跟踪进度：
- [ ] 步骤 1：备份数据库
- [ ] 步骤 2：运行迁移
- [ ] 步骤 3：验证数据
**步骤 1：备份**
运行：`./scripts/backup.sh`
...
## 选择路径
**创建新的？** → 参见下方"创建"
**编辑现有的？** → 参见下方"编辑"
| 自由度 | 适用场景 | 示例 |
|---|---|---|
| 高 | 多种有效方案 | 代码审查指南 |
| 中 | 有推荐模式 | 报告模板 |
| 低 | 脆弱/关键操作 | 数据库迁移 |
低自由度 = 精确命令，不允许修改。
name/description 符合格式要求（小写连字符，第三人称，做什么 + 何时用）| ❌ 避免 | ✅ 改为 |
|---|---|
Windows 路径（docs\file.md） | Unix 路径（docs/file.md） |
| 多选项（"用 A 或 B 或 C"） | 一个默认 + 逃生口 |
| 时效性内容（"2025年8月前"） | "当前" + "旧模式"分节 |
| 深层嵌套引用（A→B→C） | 所有引用从 SKILL.md 发起 |
| 解释 AI 已知的内容 | 只写项目特定信息 |
完成初稿后，阅读 reference/full-best-practices.md 了解：