1. 明确这次交付什么
拿一张纸写下这三项，比直接堆一长串提示词更容易发现遗漏。
| 项目 | 页面规划练习 | 完整图包 |
|---|---|---|
| 输入 | 原文、受众、读者收益 | 还需要真实素材和视觉要求 |
| 输出 | 页面规划、事实记录、笔记初稿 | 还包含封面、内页和图片审核记录 |
| 完成条件 | 每页有判断和证据，文稿能对应页面 | 最终图片可读、保真、事实一致，笔记和图片齐全 |
本站的图包规则将 article.md 和 images/ 同时作为完整交付。只生成了规划文件时，记录当前阶段为规划完成；等图片也生成并检查后，再判断图包是否完成。
2. 下载练习包，放到项目里
Agent Skills 格式以 SKILL.md 为入口，开头包含 name 和 description。其他文件可以放在 references/、scripts/ 或 assets/ 中，按需读取。格式细节可查Agent Skills 规范。
本例可以组织为：
article-page-planner/
SKILL.md
references/
page-template.md
fact-ledger.md
review-checklist.md
下载完整 Skill 练习包，解压后会看到上面的四个文件，以及 README.md。不要只复制入口而漏掉 references。
在项目中创建 .agents/skills/，把整个 article-page-planner 文件夹放进去。最后应是 .agents/skills/article-page-planner/SKILL.md。这是本地项目中的使用位置；不同客户端的发现与启用入口以当前界面为准。你也可以把入口文件完整路径交给 Codex，明确要求先读取它。
3. 读懂 SKILL.md 的入口
下面是教学用的页面规划 Skill。它演示文件组织和执行要求，输出范围是文字规划。
---
name: article-page-planner
description: 将已有长文整理为多页图文规划和发布笔记初稿。适用于用户已提供原文，希望确定每页判断、证据、标题与配图顺序的任务。
---
# 文章页面规划
## 输入
读取用户指定的原文。确认受众和读者完成的动作。
缺少原文时，请用户提供原文或可读取文件。
## 步骤
1. 保留原文，提取事实、数字、对象和必要条件。
2. 读取 references/fact-ledger.md，记录事实来源。
3. 读取 references/page-template.md，逐页填写规划。
4. 每页确定一个判断，写清画面使用什么证据。
5. 撰写 article.md，包含标题、正文、标签和配图顺序。
6. 读取 references/review-checklist.md，检查结果。
## 输出
- page-plan.md：逐页规划。
- fact-ledger.md：事实与示例记录。
- article.md：发布笔记初稿。
- review.md：缺失素材、待确认事项和检查结果。
## 边界
示例须标明；缺少真实素材时记录待补证据。
本文字规划流程不生成最终图片。
不得声称已完成整套图片或已经发布。
保存时确认文件名是 SKILL.md，没有变成 SKILL.md.txt；开头的两行元信息放在成对的 --- 中。原文、输出内容与技能规则分开放置。
4. 参考文件里写可以照填的内容
page-template.md 可以列出六个字段：页码、判断、证据、标题断行、正文、待补素材。
fact-ledger.md 列出原文值、出处、页面位置，以及它属于原文事实、唯一推导还是教学示例。它帮助检查数字被改动、例子被写成实测结果等问题。
review-checklist.md 写可以回答的检查问题。例如“第二页是否已经给出封面承诺的方法”“每个数字是否能找到出处”。“请达到高级感”缺少检查依据，可以换成明确的标题层级、参考样页和实际尺寸检查。
如果之后接入生图，把素材要求、页面构图和成品审查独立写清楚。具体身份的产品和人物需要真实素材；缺少它们时，流程停在待补材料的页面。
5. 在 Codex 中运行一次
在 Codex 打开这个项目，把原文保存为 source.md。新建任务，明确指定 Skill 和输出位置：
请使用本项目的 article-page-planner Skill，先读取
.agents/skills/article-page-planner/SKILL.md。原文在source.md，面向第一次整理图片素材的创作者。将结果放到新目录outputs/first-run/，生成 page-plan.md、fact-ledger.md、article.md 和 review.md。保留原文。本轮完成文字规划，列出每页还缺什么素材。
如果客户端能在技能选择器中找到它，也可以从选择器插入。找不到时，先请 Codex 核对实际文件路径与入口格式，并直接读取文件；不要把“我会使用这个 Skill”的回复当成已执行结果。
运行结束后，在项目里打开输出目录。正常情况下应看到这四份文件：
| 输出文件 | 打开后要看什么 |
|---|---|
| page-plan.md | 页码、标题、判断和证据是否齐全 |
| fact-ledger.md | 每个数字与示例有没有出处 |
| article.md | 发布标题、正文、标签和图片顺序 |
| review.md | 缺失材料、发现的问题、当前完成阶段 |
完成标志：四个文件实际存在，并且内容对应你的原文。文件名齐全却都是空表，继续要求完成填写。官方 Skill 文档可用于核对当前客户端支持方式。
6. 用三份输入检查规则
先让 Skill 处理一篇内容清楚、事实完整的短文。检查四份输出是否齐全，以及每页是否有明确内容。这是正常路径。
第二次拿含有数字和必要条件的文章。检查数字是否保持一致，条件是否在改写后仍然存在。如果原文说“这个示例使用六页”，输出就应保持示例范围。
第三次故意不给图片素材，却要求制作命名产品的页面。合理结果应明确列出缺失证据和受影响的页码，方便你补充素材。
每次记录输入、实际输出、问题和修改。改完规则后，用同一份输入重新检查原问题，再看有没有影响其他页。一次顺利运行只能说明这一次结果可用。
7. 规划稳定后，再接入出图
当规划稳定后，可以继续加入字体配置、样页生成和最终图片核验。每增加一种能力，就为它补上所需输入和检查方法。
例如新增最终出图，需要明确工具依赖、素材来源、可用字体、图片目录，以及打不开文件或素材不足时怎样处理。Skill 本身保存流程；实际生成和导出依赖运行环境提供的能力。
常见问题：没有调用、缺文件、输出跑偏
没有读取Skill：提供入口的完整路径，让Codex先确认读取结果。提示参考文件不存在：核对references路径和文件名。数字被改写：在事实表中指出原句，让它修正受影响的页面并重查。只有笔记没有分页：回到入口的四份输出要求逐项补齐。
第一轮先让这套文字规划可用，再扩展到真实素材、整页构图和图片导出。可以下载完整练习包，按其中 README 的输入与四项交付完成一次练习。