name: prompt-section-design description: 设计可组合的提示部分用于构建智能体提示。在创建可重用提示组件、设计乐高块式提示部分或为利益相关者三方构建提示时使用。 allowed-tools: Read, Grep, Glob
提示部分设计技能
设计可组合的提示部分，像乐高块一样用于构建任何级别的提示。
目的
创建结构良好的提示部分，可重用、一致且高效，适用于利益相关者三方。
何时使用
- 创建新提示
- 重构现有提示
- 向提示添加部分
- 标准化团队提示
部分层级列表
| 层级 | 部分 | 优先级 |
|---|---|---|
| S | 工作流 | 始终包含（级别2+） |
| A | 变量、示例、控制流、委托、模板 | 高价值 |
| B | 目的、高层、高阶、指令 | 支持性 |
| C | 元数据、代码库结构、相关文件、报告 | 根据需要 |
设计流程
步骤1: 识别提示目的
询问：
- 这个提示实现什么？
- 谁将使用它？（你、团队、智能体）
- 它是什么级别？（1-7）
- 需要什么输入/输出？
步骤2: 选择所需部分
基于级别：
| 级别 | 必需 | 推荐 |
|---|---|---|
| 1 | 标题、提示 | - |
| 2 | 标题、工作流 | 变量、报告 |
| 3 | 标题、工作流 | 变量、控制流 |
| 4 | 标题、工作流 | 变量、委托 |
| 5 | 标题、工作流 | 变量 |
| 6 | 标题、工作流、模板 | 变量 |
| 7 | 标题、工作流、专业知识 | 变量 |
步骤3: 设计每个部分
元数据（前言）
---
description: 清晰、可搜索的描述
argument-hint: [arg1] [arg2]
allowed-tools: Read, Write, Edit
model: sonnet
---
指南：
description：它做什么？何时使用？argument-hint：预期什么参数？allowed-tools：所需的最小工具集model：匹配任务复杂度
标题
# 面向行动的标题
指南：
- 使用祈使动词：创建、构建、生成、分析
- 具体化：“创建实施计划”而非“计划”
- 保持简洁：2-5个词
目的
## 目的
[1-2句话描述提示实现什么]
指南：
- 直接向智能体传达语言
- 引用关键部分
- 解释“什么”和“为什么”
变量
## 变量
# 动态（来自用户）
USER_PROMPT: $ARGUMENTS
FILE_PATH: $1
COUNT: $2 或如果不提供则3
# 静态（固定）
OUTPUT_DIR: specs/
MODEL: sonnet
指南：
- SCREAMING_SNAKE_CASE
- 动态先，静态后
- 包括默认值（如适用）
- 清晰描述
工作流（S层级）
## 工作流
1. 验证输入
- 检查 USER_PROMPT 是否提供
- 如否，停止并询问用户
2. 处理任务
- 子步骤详情
3. 生成输出
4. 报告结果
指南：
- 编号步骤用于序列
- 子项目符号用于细节
- 停止条件明确
- 清晰进展
指令
## 指令
- 重要：始终在处理前验证
- 优雅处理边缘情况
- 绝不修改项目外的文件
指南：
- 项目符号用于规则
- 重要标记用于关键点
- 边缘情况明确
报告
## 报告
## 任务完成
**文件：** [数量]
**状态：** [状态]
### 更改
- [更改1]
- [更改2]
指南：
- 输出模板
- 一致格式
- 易于解析
模板（级别6）
<!-- markdownlint-disable MD033 MD025 MD003 MD040 -->
## 指定格式
```text
---
allowed-tools: <工具>
description: <描述>
---
# <名称>
## 变量
<变量>: $1
## 工作流
<步骤>
<!-- markdownlint-enable MD033 MD025 MD003 MD040 -->
指南：
- 完整模板
- 占位符清晰标记
- 遵循提示约定
专业知识（级别7）
## 专业知识
### 领域知识
- 模式1 学习
- 模式2 发现
### 发现模式
- 实施洞察1
- 最佳实践2
指南：
- 按类别组织
- 随时间增长
- 绝不修改工作流
步骤4: 验证结构
检查清单：
- [ ] 标题面向行动
- [ ] 工作流有编号步骤
- [ ] 变量使用 SCREAMING_SNAKE_CASE
- [ ] 停止条件明确
- [ ] 前言有描述
- [ ] 部分顺序逻辑
部分顺序约定
<!-- markdownlint-disable MD033 MD025 MD040 -->
---
[前言]
---
# [标题]
## 目的
[目的]
## 变量
[变量]
## 指令
[指令]
## 工作流
[工作流]
## 报告
[报告格式]
<!-- markdownlint-enable MD033 MD025 MD040 -->
输出格式
当设计部分时：
## 部分设计
**提示：** [名称]
**级别：** [1-7]
### 推荐部分
1. **标题**: [建议标题]
2. **前言**:
```yaml
description: ...
argument-hint: ...
allowed-tools: ...
model: ...
```
1. **变量**:
- 动态: [列表]
- 静态: [列表]
2. **工作流**: [步骤数] 步骤
- 步骤1: [概述]
- 步骤2: [概述]
...
3. **报告**: [格式类型]
反模式
| 反模式 | 问题 | 解决方案 |
|---|---|---|
| 无工作流部分 | 智能体缺乏方向 | 始终为级别2+添加 |
| 不一致的变量名 | 混乱 | 使用 SCREAMING_SNAKE_CASE |
| 缺失停止条件 | 运行失控 | 明确的早期退出 |
| 过于详细的工作流 | 减少智能体自主性 | 高层步骤 |
| 无前言 | 难以发现 | 添加描述 |
关键引用
“构建可重用、经过实战测试的智能体提示库，使用像乐高块一样的可组合部分。”
交叉引用
- @prompt-sections-reference.md - 部分定义
- @seven-levels.md - 按级别的部分
- @variable-patterns.md - 变量约定
版本历史
- v1.0.0 (2025-12-26): 初始发布
最后更新
日期： 2025-12-26 模型： claude-opus-4-5-20251101