---
name: meta-writing-skills
description: SpecPow meta-writing-skills skill
---

# 编写技能
> 指导如何创建新的 SpecPow 技能文件

## 触发条件

- 用户要求创建新技能
- 需要扩展 SpecPow 能力
- 用户提到"写技能"/"创建 SKILL"

## 铁律

1. **单一职责** — 一个技能只做一件事
2. **可组合** — 技能之间可以互相引用
3. **有边界** — 明确什么时候用、什么时候不用
4. **可测试** — 技能的效果可以验证

## 技能文件结构
```markdown
# 技能名称
> 一句话描述技能用途

## 触发条件
- 什么情况下使用这个技能

## 铁律
1. 不可违反的规则
2. ...

## 工作流
### 阶段 1: ...
### 阶段 2: ...

## 输出格式
- 期望的输出结果

## 红旗（立即停止）
- 什么情况下必须停止
```

## 命名规范

- 目录名: kebab-case（如 `java-codegen`）
- 文件名: 固定为 `SKILL.md`
- 分类: planning / execution / quality / business / meta

## 技能分类
| 分类 | 用途 | 示例 |
|------|------|------|
| meta | 元技能，管理其他技能 | using-skills, writing-skills |
| planning | 规划和设计阶段 | explore, propose, write-specs |
| execution | 执行阶段 | subagent-driven-dev, tdd |
| quality | 质量保障 | code-review, test-gen |
| business | 业务特定 | java-codegen, ui-codegen |

## 编写原则

1. **开头用 `>` 引用块写一句话描述**
2. **铁律不超过 5 条**
3. **工作流分阶段，每阶段有明确目标**
4. **红旗必须具体，不能模糊**
5. **包含具体示例**