القائمة
指导编写和改进 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 了解：