source-command-audit-prose
当用户要求运行迁移后的源命令 audit-prose 时,使用此技能。
命令模板
Audit Prose — 裸章节内容丰富
为白皮书的每个“裸章节”前面添加描述性散文(2-4 句)。 “裸章节” = 标题后直接跟随表格、代码块或列表,且没有介绍性段落。
用法
/audit-prose # 所有 WP(00-08),法文 + 英文
/audit-prose 07 # 仅 WP07(法文 + 英文)
/audit-prose 03 07 # 仅 WP03 和 WP07
“裸章节”定义
章节(## 或 ###)后直接跟随:
- 一个 Markdown 表格(
|) - 一个代码块(
```) - 一个无序列(
-)或有序列表
且没有介绍性段落(至少 2 句)。
严格规则(不可协商)
- 绝不要在段落末尾以
:结束,然后紧跟一个无序列 → 会导致 Typst 错误,合并子弹点为内联 - 不要编造数字、指标或引用
- 不要添加 callouts(
:::)、Mermaid 或人物场景 - 不要使每文件行数增加超过 +15%
- 维护的版本为 3.27.6
- 英文散文 = 自然英语,不要逐字翻译法文
- 每次添加 = 最少 2 句,最多 4 句
转换示例
修改前:
### 退出代码
| 代码 | 含义 |
|------|-----------|
| 0 | 已授权 |
修改后:
### 退出代码
钩子通过标准化的退出代码与 Codex 通信。
这是一种实时阻止或允许操作的机制,无需人工干预。
| 代码 | 含义 |
|------|-----------|
| 0 | 已授权 |
工作流:9 个并行 Agent
上下文来源
machine-readable/reference.yaml:主题到主指南行的映射guide/ultimate-guide.md:参考指南(位于 reference.yaml 中指定的行)- Codex 知识(v3.27.6, MCP, hooks, agent teams 等)
WP 映射
| # | FR | EN | ~裸章节数 |
|---|---|---|---|
| 00 | whitepapers/fr/00-introduction-serie.qmd | whitepapers/en/00-series-introduction.qmd | ~10 |
| 01 | whitepapers/fr/01-prompts-efficaces.qmd | whitepapers/en/01-effective-prompts.qmd | ~14 |
| 02 | whitepapers/fr/02-personnalisation.qmd | whitepapers/en/02-customization.qmd | ~18 |
| 03 | whitepapers/fr/03-securite.qmd | whitepapers/en/03-security.qmd | ~20 |
| 04 | whitepapers/fr/04-architecture.qmd | whitepapers/en/04-architecture.qmd | ~14 |
| 05 | whitepapers/fr/05-equipe.qmd | whitepapers/en/05-team.qmd | ~20 |
| 06 | whitepapers/fr/06-privacy.qmd | whitepapers/en/06-privacy.qmd | ~12 |
| 07 | whitepapers/fr/07-guide-reference.qmd | whitepapers/en/07-reference-guide.qmd | ~36 |
| 08 | whitepapers/fr/08-agent-teams.qmd | whitepapers/en/08-agent-teams.qmd | ~16 |
执行
如果参数 = 特定 WP 编号:仅为该法文/英文对启动 1 个 agent。
如果没有参数(或 "all"):创建一个 audit-prose-{date} 团队,并并行启动 9 个 agent。
对于每个目标 WP,启动一个 agent,并使用以下提示:
你是一名高级技术编辑。你的任务:为白皮书 [XX - 标题] 的“裸章节”添加描述性散文。
## “裸章节”定义
章节(## 或 ###)后直接跟随一个表格、代码块或无序列表,而没有介绍性段落(2+ 句)。
## 你要做的事
对于识别的每个裸章节:
1. 在结构化内容之前添加 2-4 句
2. 每句提供新信息:原因、何时使用、含义、设计选择或实际上下文
3. 不要复述后面的内容——而是补充缺失的上下文
## 上下文来源
- `machine-readable/reference.yaml`:主题到主指南的完整映射
- 你对 Codex 的了解(v3.27.6, MCP, hooks, agent teams 等)
## 严格规则
- 不要编造数字、指标或引用
- 不要添加 callouts(:::)、Mermaid 或人物场景
- 绝不要以 ":" 结束段落,然后紧跟一个无序列表(Typst 错误)
- 不要增加超过 +15% 的行数
- 保留版本为 3.27.6
- 英文散文 = 自然英语,不要逐字翻译
- 每次添加 = 最少 2 句,最多 4 句
## 过程
1. 阅读 reference.yaml(与 WP 相关的部分)
2. 完整阅读法文 WP
3. 识别所有裸章节
4. 编辑法文文件(Edit 工具,逐个章节)
5. 完整阅读英文 WP
6. 编辑英文文件
7. 检查:没有段落以 ":" 结尾,后跟一个列表
8. 报告:已处理的章节,法文/英文行数增量
等待与报告
等待所有 agent 的回复。对于每个完成的 WP,显示:
WP[XX] ✅ — [N] 个章节,[+X]% 法文/英文
关闭
当所有 agent 完成后,向每个 agent 发送 shutdown_request,然后执行 TeamDelete。
丰富后验证
# 1. 行数增量(最多 +15%)
for f in whitepapers/fr/*.qmd; do
echo "$(wc -l < "$f") $(basename $f)"
done
# 2. 检查 Typst 错误:段落以 ":" 结尾,后跟列表
grep -n ':$' whitepapers/fr/*.qmd whitepapers/en/*.qmd | head -20
# 3. 检查版本是否保持不变
grep "^version:" whitepapers/fr/*.qmd whitepapers/en/*.qmd
# 4. 重新构建 PDF
for f in whitepapers/fr/*.qmd whitepapers/en/*.qmd; do
quarto render "$f"
done
每个 WP 的行数预算
| WP | 法文最大预算 | 英文最大预算 |
|---|---|---|
| 00 | +54 行 | +54 行 |
| 01 | +142 行 | +142 行 |
| 02 | +189 行 | +189 行 |
| 03 | +145 行 | +145 行 |
| 04 | +120 行 | +120 行 |
| 05 | +143 行 | +143 行 |
| 06 | +79 行 | +79 行 |
| 07 | +281 行 | +281 行 |
| 08 | +241 行 | +241 行 |