Community研究与数据分析github.com

FlorianBruniaux/claude-code-ultimate-guide

为白皮书中的裸章节添加描述性散文(法文 + 英文),使用 9 个并行 agent 同时处理。

claude-code-ultimate-guide 是什么?

此技能专为 AI 编码代理(如 Codex、Claude Code)设计,旨在自动化丰富技术白皮书内容。其主要功能是识别并填充白皮书中的“裸章节”——即标题后直接跟随表格、代码块或列表,而没有任何介绍性段落的区域。通过为每个裸章节添加 2-4 句描述性散文,该技能显著提升了文档的可读性和实用性,无需人工编辑。该技能支持处理特定白皮书章节(编号 00 至 08),可一次性处理全部 9 个章节,或仅处理指定章节。执行时,它会启动 9 个并行代理,每个代理负责一组特定的法文/英文白皮书对,并遵循严格规则,例如不编造数据、不添加特定 Markdown 格式、保持行数增长在 15% 以内。此工作流可无缝集成到自动化文档流水线中,确保大型技术文档集的质量和一致性。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.agents/skills/source-command-audit-prose

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 句)。

严格规则(不可协商)

  1. 绝不要在段落末尾以 : 结束,然后紧跟一个无序列 → 会导致 Typst 错误,合并子弹点为内联
  2. 不要编造数字、指标或引用
  3. 不要添加 callouts(:::)、Mermaid 或人物场景
  4. 不要使每文件行数增加超过 +15%
  5. 维护的版本为 3.27.6
  6. 英文散文 = 自然英语,不要逐字翻译法文
  7. 每次添加 = 最少 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 映射

#FREN~裸章节数
00whitepapers/fr/00-introduction-serie.qmdwhitepapers/en/00-series-introduction.qmd~10
01whitepapers/fr/01-prompts-efficaces.qmdwhitepapers/en/01-effective-prompts.qmd~14
02whitepapers/fr/02-personnalisation.qmdwhitepapers/en/02-customization.qmd~18
03whitepapers/fr/03-securite.qmdwhitepapers/en/03-security.qmd~20
04whitepapers/fr/04-architecture.qmdwhitepapers/en/04-architecture.qmd~14
05whitepapers/fr/05-equipe.qmdwhitepapers/en/05-team.qmd~20
06whitepapers/fr/06-privacy.qmdwhitepapers/en/06-privacy.qmd~12
07whitepapers/fr/07-guide-reference.qmdwhitepapers/en/07-reference-guide.qmd~36
08whitepapers/fr/08-agent-teams.qmdwhitepapers/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 行

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

相关技能