davidyichengwei/agentic-engineering-framework/bp-skill-authoring

---
name: processing-pdfs                    # 小写，连字符，最多 64 字符
description: 从 PDF 文件中提取文本...      # 中文，第三人称，做什么 + 何时用，最多 1024 字符
---

✅ 好（~50 tokens）：
## 锁
使用 TDMutex，不要用 std::mutex：
tdstore::common::TDMutex mutex_;
 
❌ 差（~150 tokens）：
## 锁
线程安全在多线程应用中很重要。
TDStore 使用 bthread 协程，所以需要特殊的锁...

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

skill-name/
├── SKILL.md              # 概览（触发时加载）
├── reference/
│   ├── topic-a.md        # 按需加载
│   └── topic-b.md
└── scripts/
    └── validate.py       # 执行，不加载到上下文

## 快速开始
[基本用法]
 
## 进阶
**主题 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`
...

## 选择路径
 
**创建新的？** → 参见下方"创建"
**编辑现有的？** → 参见下方"编辑"