9.8 案例一：项目资料核对与章节草稿生成

面向经管学生、研究者与从业者的 AI 智能体设计教材

9.8 配图

场景：用户要写一章教材，目录中已有旧大纲、素材清单、参考笔记和若干参考稿。目标不是让模型凭空写，而是让它先确认资料范围，再按模板生成一份结构稳定的章节草稿。

这个案例主要采用模式 1（顺序工作流编排），同时包含模式 3（迭代精修）的元素——第一步的资料核对本身就是一个验证节点，缺失资料时停止而非强行继续。

完整的 SKILL.md：

▶ Skill

---
name: chapter-draft-generator
description: 当用户需要为教材章节整理资料并生成初稿时使用。适用于已有素材包和大纲、需要按模板产出章节草稿的场景。
allowed-tools: "Read Glob Grep Write"
---

!ls chapters/chapter-{N}/
!ls 参考资料及素材/chapter-{N}/

## 执行步骤

### 第一步：锁定输入范围
读取上面的目录列表，确认以下文件是否存在：
- 章节大纲（outline.md）
- 素材清单（sources.md）
- 参考笔记（notes.md）

如有缺失，先列出缺失清单并停止，等用户补充后再继续。

### 第二步：提取关键信息
从大纲中提取：章节定位、学习目标、建议节次。
从素材中提取：核心概念、关键术语、可复用的段落和示例。

### 第三步：按模板生成草稿
按以下结构生成 draft-v1.md：
- 引言（说明本章要解决的问题）
- 各节正文（按大纲节次展开）
- 小结（回顾本章主线）

### 第四步：交接回主流程
输出状态说明：
- 本轮使用了哪些主材料
- 还缺什么事实点
- 下一步建议做哪类审阅

## 边界
- 只写入指定的 draft 文件，不修改已有的 outline 或素材文件。
- 不联网查找资料，只基于本地已有素材工作。

这个案例体现了编排型 Skill 的五个步骤：

步骤	动作	对应机制
1. 锁定输入	确认资料范围，拒绝盲写	!command 取证
2. 提取信息	从多个文件中提取要点	allowed-tools 限制为读取工具
3. 受控生成	按模板结构产出草稿	正文步骤约束
4. 限制写入	只写 draft 文件，不碰源文件	边界声明
5. 状态交接	报告完成情况和下一步建议	交付规则

核心判断

这个案例的重点不在于用了多少工具，而在于它体现了一种稳定顺序：先确认现场，再受控生成。 如果省略第一步直接让模型写，输出质量会明显下降。

测试验证

为这个 Skill 做三类测试：

触发测试：

应触发：
- "帮我生成第 9 章的初稿"
- "整理素材并写章节草稿"

不应触发：
- "帮我检查第 9 章的文风"（这是审阅任务，不是草稿生成）

功能测试：

测试：第 9 章草稿生成
Given：chapters/chapter-7/ 下有 outline.md 和 notes.md，缺少 sources.md
When：Skill 执行第一步
Then：输出缺失清单，包含 sources.md，并停止等待用户补充

这条测试用于验证一个关键行为：遇到资料缺失时停止，而不是强行继续。