工作流类 Skills 详解
掌握文档协作、企业沟通、品牌管理和 Skill 创建的专业工作流
本章概览
本章深入解析 4 个工作流类 Skills：
| Skill | 用途 | 核心价值 |
|---|---|---|
| doc-coauthoring | 文档协作写作 | 结构化的三阶段写作流程 |
| internal-comms | 企业内部沟通 | 标准化的沟通模板 |
| brand-guidelines | 品牌规范应用 | Anthropic 官方品牌指南 |
| skill-creator | Skill 创建指南 | 创建高质量 Skills 的方法论 |
1. Doc Co-authoring（文档协作）
1.1 概述
这个 Skill 提供了一套结构化的文档协作写作流程，特别适合技术规范、提案、决策文档等正式文档。
yaml
name: doc-coauthoring
description: Guide users through a structured workflow for co-authoring
documentation. Use when user wants to write documentation, proposals,
technical specs, decision docs, or similar structured content.
This workflow helps users efficiently transfer context, refine content
through iteration, and verify the doc works for readers.1.2 触发条件
当用户提到以下内容时触发：
- "写一份文档"、"起草提案"、"创建规范"
- 特定文档类型：PRD、设计文档、决策文档、RFC
- 开始大型写作任务
1.3 三阶段工作流
mermaid
graph LR
A[Stage 1<br>收集上下文] --> B[Stage 2<br>精炼与结构]
B --> C[Stage 3<br>读者测试]Stage 1：收集上下文
目标：缩小用户知道的和 Claude 知道的之间的差距
初始问题
- 这是什么类型的文档？（技术规范、决策文档、提案等）
- 主要受众是谁？
- 读完后期望的影响是什么？
- 有模板或特定格式要求吗？
- 其他约束或上下文？
信息倾倒
鼓励用户倾倒所有相关信息：
- 项目/问题背景
- 相关团队讨论或共享文档
- 为何不采用替代方案
- 组织上下文（团队动态、过往事件、政治）
- 时间压力或约束
- 技术架构或依赖
- 利益相关者关切
输入方式：
- 意识流式信息倾倒
- 指向团队频道或帖子
- 链接到共享文档
- 如果有集成（Slack、Google Drive 等），直接拉取
澄清问题
用户完成初始倾倒后，生成 5-10 个基于上下文差距的编号问题。
退出条件：当问题显示出理解——能够询问边缘情况和权衡而无需解释基础知识。
Stage 2：精炼与结构
目标：逐章节构建文档，通过头脑风暴、筛选和迭代精炼
工作流程
mermaid
graph TB
A[选择章节] --> B[澄清问题]
B --> C[头脑风暴 5-20 项]
C --> D[用户筛选]
D --> E[差距检查]
E --> F[起草章节]
F --> G[迭代精炼]
G --> H{满意?}
H -->|否| G
H -->|是| I[下一章节]
I --> A章节顺序
- 从未知最多的章节开始
- 对于决策文档，通常是核心提案
- 对于规范，通常是技术方法
- 摘要章节留到最后
每章节步骤
- 澄清问题：5-10 个关于应包含内容的问题
- 头脑风暴：根据复杂度生成 5-20 个选项
- 筛选：用户指示保留/移除/合并
- 差距检查：是否遗漏重要内容
- 起草：使用
str_replace替换占位符 - 迭代：直到用户满意
质量检查
连续 3 次迭代无实质变化后，询问：
"是否有任何内容可以移除而不丢失重要信息？"
Stage 3：读者测试
目标：用没有上下文的 Claude 测试文档，验证它对读者有效
有子代理访问时（如 Claude Code）
mermaid
graph TB
A[预测读者问题] --> B[为每个问题调用子代理]
B --> C[运行额外检查]
C --> D[报告并修复]- 预测问题：生成 5-10 个读者会问的问题
- 子代理测试：用文档内容和问题调用新 Claude 实例
- 额外检查：检查歧义、假设、矛盾
- 修复：解决发现的问题
无子代理时（如 claude.ai）
提供手动测试指令：
1. 打开新的 Claude 对话：https://claude.ai
2. 粘贴或分享文档内容
3. 向 Reader Claude 询问生成的问题
4. 记录 Reader Claude 的回答是否正确
5. 询问额外检查问题：
- "这个文档中有什么可能模糊或不清楚？"
- "这个文档假设读者已知道什么？"
- "有内部矛盾或不一致吗？"退出条件
当 Reader Claude 能一致正确回答问题且不发现新的差距或歧义。
1.4 最终审查
markdown
通过 Reader Claude 测试后：
1. 建议用户自己做最终阅读——他们拥有这份文档
2. 建议检查事实、链接或技术细节
3. 验证是否达到期望的影响
最终提示：
- 考虑在附录中链接此对话，展示文档开发过程
- 使用附录提供深度而不使主文档膨胀
- 收到真实读者反馈后更新文档2. Internal Comms（企业内部沟通）
2.1 概述
提供企业内部各类沟通的标准模板和指南。
yaml
name: internal-comms
description: A set of resources to help me write all kinds of internal
communications, using the formats that my company likes to use.
Claude should use this skill whenever asked to write some sort of
internal communications (status reports, leadership updates, 3P updates,
company newsletters, FAQs, incident reports, project updates, etc.).2.2 支持的沟通类型
| 类型 | 模板文件 | 用途 |
|---|---|---|
| 3P 更新 | examples/3p-updates.md | Progress/Plans/Problems 团队更新 |
| 公司新闻通讯 | examples/company-newsletter.md | 全公司范围的新闻通讯 |
| FAQ 回答 | examples/faq-answers.md | 回答常见问题 |
| 通用沟通 | examples/general-comms.md | 其他不匹配上述类型的内容 |
2.3 使用流程
mermaid
graph LR
A[识别沟通类型] --> B[加载相应指南]
B --> C[遵循具体指令]
C --> D[生成沟通内容]- 识别类型：从用户请求中确定沟通类型
- 加载指南：从
examples/目录加载相应文件 - 遵循指令：按照文件中的格式、语气和内容收集指导
- 生成内容：创建符合规范的沟通
2.4 示例：3P 更新模板
markdown
# [项目名称] - 周更新
**日期**: [日期]
**作者**: [姓名]
## Progress（进展）
- 完成了 [具体任务]
- 达成了 [里程碑]
- [其他进展]
## Plans（计划）
- 下周将 [任务1]
- 计划开始 [任务2]
- 目标是 [目标]
## Problems（问题）
- **[问题标题]**: [描述]，需要 [支持/资源]
- **[风险]**: [描述]，缓解措施是 [方案]
## 关键指标
| 指标 | 上周 | 本周 | 目标 |
|------|------|------|------|
| [指标1] | [值] | [值] | [值] |2.5 最佳实践
- 保持一致的格式和语气
- 具体且可操作
- 突出需要关注的问题
- 使用公司熟悉的术语
- 简洁但完整
3. Brand Guidelines（品牌指南）
3.1 概述
将 Anthropic 官方品牌颜色和排版应用到各种 Artifact。
yaml
name: brand-guidelines
description: Applies Anthropic's official brand colors and typography
to any sort of artifact that may benefit from having Anthropic's
look-and-feel. Use it when brand colors or style guidelines,
visual formatting, or company design standards apply.3.2 品牌颜色
主色
| 颜色 | Hex | 用途 |
|---|---|---|
| Dark | #141413 | 主要文字和深色背景 |
| Light | #faf9f5 | 浅色背景和深色上的文字 |
| Mid Gray | #b0aea5 | 次要元素 |
| Light Gray | #e8e6dc | 微妙背景 |
强调色
| 颜色 | Hex | 用途 |
|---|---|---|
| Orange | #d97757 | 主要强调 |
| Blue | #6a9bcc | 次要强调 |
| Green | #788c5d | 第三强调 |
3.3 字体
| 用途 | 字体 | 备用 |
|---|---|---|
| 标题 | Poppins | Arial |
| 正文 | Lora | Georgia |
3.4 智能字体应用
python
# 自动应用规则
- 24pt 及以上：Poppins 字体
- 正文文字：Lora 字体
- 系统字体备用：Arial/Georgia
# 颜色选择基于背景
- 深色背景：浅色文字
- 浅色背景：深色文字3.5 形状和强调色
python
# 非文字形状使用强调色
accent_colors = ['#d97757', '#6a9bcc', '#788c5d']
# 循环使用以保持视觉兴趣
for i, shape in enumerate(shapes):
shape.fill = accent_colors[i % 3]3.6 技术实现
python
# 使用 python-pptx 的 RGBColor
from pptx.util import RGBColor
# 精确的品牌颜色匹配
anthropic_dark = RGBColor(0x14, 0x14, 0x13)
anthropic_orange = RGBColor(0xd9, 0x77, 0x57)4. Skill Creator（Skill 创建指南）
4.1 概述
这是一个元 Skill——教你如何创建其他 Skills。
yaml
name: skill-creator
description: Guide for creating effective skills. This skill should be
used when users want to create a new skill (or update an existing skill)
that extends Claude's capabilities with specialized knowledge, workflows,
or tool integrations.4.2 Skills 提供什么
| 能力 | 说明 | 示例 |
|---|---|---|
| 专业工作流 | 特定领域的多步骤流程 | 文档审阅流程 |
| 工具集成 | 与特定文件格式/API 的交互 | PDF 处理 |
| 领域专识 | 公司特定知识、Schema、业务逻辑 | 数据库 Schema |
| 捆绑资源 | 脚本、参考资料、素材 | Python 脚本、模板 |
4.3 核心原则
精简是关键
上下文窗口是公共资源
默认假设：Claude 已经很聪明了
每段信息都要问：
- "Claude 真的需要这个解释吗？"
- "这段话值得占用 Token 吗？"
简洁示例优于冗长解释设置适当的自由度
| 自由度 | 适用场景 | 实现方式 |
|---|---|---|
| 高 | 多种方法都可行 | 文本指令 |
| 中 | 有首选模式 | 伪代码/带参数脚本 |
| 低 | 操作易出错 | 具体脚本/少量参数 |
4.4 Skill 解剖
skill-name/
├── SKILL.md # [必需] 核心指令
│ ├── YAML frontmatter # name + description
│ └── Markdown 指令
└── 捆绑资源 (可选)
├── scripts/ # 可执行代码
├── references/ # 参考文档
└── assets/ # 模板和素材SKILL.md
- Frontmatter：
name和description（唯一会被 Claude 用来判断何时使用的字段） - Body：使用指令（仅在 Skill 触发后加载）
scripts/
适用于：
- 反复重写相同代码
- 需要确定性可靠性
示例：scripts/rotate_pdf.py
references/
适用于：
- Claude 工作时需要参考的文档
- 数据库 Schema、API 文档、领域知识
最佳实践：
- 大文件（>10k 词）提供 grep 搜索模式
- 避免重复（信息只在一处存在）
assets/
适用于：
- 不需要加载到上下文的输出文件
- 模板、图片、字体、样板代码
4.5 六步创建流程
mermaid
graph TB
A[1. 理解 Skill<br>收集具体示例] --> B[2. 规划内容<br>脚本/参考/素材]
B --> C[3. 初始化<br>运行 init_skill.py]
C --> D[4. 编辑 Skill<br>实现资源和指令]
D --> E[5. 打包<br>运行 package_skill.py]
E --> F[6. 迭代<br>基于真实使用改进]Step 1：理解 Skill
询问用户：
- "这个 Skill 应该支持什么功能？"
- "能给一些使用示例吗？"
- "什么话应该触发这个 Skill？"
Step 2：规划内容
对每个示例分析：
- 如何从头执行这个示例
- 重复执行时哪些脚本、参考、素材有帮助
Step 3：初始化
bash
scripts/init_skill.py <skill-name> --path <output-directory>脚本创建：
- Skill 目录
- SKILL.md 模板
- 示例资源目录
Step 4：编辑 Skill
学习设计模式
- 多步骤流程：见
references/workflows.md - 输出格式/质量标准：见
references/output-patterns.md
实现资源
可能需要用户输入（如品牌素材、公司政策）。
测试脚本确保无 bug。
更新 SKILL.md
Frontmatter 关键点：
yaml
name: skill-name
description: |
[功能描述]
[触发条件：When to use]
# 示例
"Comprehensive document creation, editing, and analysis...
When Claude needs to work with professional documents for:
(1) Creating new documents,
(2) Modifying content,
(3) Working with tracked changes..."不要在 frontmatter 中添加其他字段。
Step 5：打包
bash
scripts/package_skill.py <path/to/skill-folder>脚本操作：
- 验证：检查格式、命名、描述
- 打包：创建
.skill文件（本质是 zip）
Step 6：迭代
mermaid
graph LR
A[在真实任务中使用] --> B[注意问题]
B --> C[确定改进点]
C --> D[实现更改]
D --> E[再次测试]
E --> A4.6 不应包含的内容
❌ README.md
❌ INSTALLATION_GUIDE.md
❌ QUICK_REFERENCE.md
❌ CHANGELOG.md
❌ 其他辅助文档
Skills 是给 AI Agent 使用的，不是给人类阅读的。4.7 渐进式加载设计模式
模式 1：高层指南 + 分离参考
markdown
# 主 Skill
## 快速开始
[简短示例]
## 高级功能
- **表单填写**: 见 [FORMS.md](FORMS.md)
- **API 参考**: 见 [REFERENCE.md](REFERENCE.md)模式 2：按领域组织
skill/
├── SKILL.md
└── reference/
├── finance.md
├── sales.md
└── marketing.md模式 3：按框架组织
cloud-deploy/
├── SKILL.md
└── references/
├── aws.md
├── gcp.md
└── azure.md5. 本章小结
工作流类 Skills 对比
| Skill | 核心价值 | 使用场景 |
|---|---|---|
| doc-coauthoring | 结构化写作流程 | 正式文档、提案、规范 |
| internal-comms | 标准化模板 | 企业内部沟通 |
| brand-guidelines | 品牌一致性 | Anthropic 风格 Artifact |
| skill-creator | 创建方法论 | 开发新 Skills |
共同设计理念
- 流程化：将复杂任务分解为清晰步骤
- 模板化：提供可复用的结构和格式
- 迭代式：支持反复精炼和改进
- 质量优先：内置验证和测试机制
适用建议
| 如果你需要... | 使用这个 Skill |
|---|---|
| 写一份技术规范 | doc-coauthoring |
| 发送周更新给团队 | internal-comms |
| 创建带 Anthropic 风格的 PPT | brand-guidelines |
| 为公司创建自定义 Skill | skill-creator |
上一章：开发工具类 Skills
下一章：使用指南