Community研究與資料分析github.com

FlorianBruniaux/claude-code-ultimate-guide

使用9個並行代理程式,為白皮書中的裸章節添加描述性散文(支援法文和英文)。

claude-code-ultimate-guide 是什麼?

這項技能專為需要自動化填充白皮書中「裸章節」(bare sections)的開發者或AI代理使用者設計。所謂「裸章節」,指的是標題(## 或 ###)後直接跟隨表格、程式碼區塊或清單,卻沒有任何介紹性段落的情況。該技能會啟動最多9個並行代理程式,同時處理法文和英文版本的8份白皮書(WP00至WP08),每個代理負責一對(法文+英文)文件。代理程式會根據 `reference.yaml` 中的主題映射和 `ultimate-guide.md` 參考指南來撰寫2至4句的說明性散文,嚴格遵守不發明數據、不添加 callouts、段落不以冒號結尾(以避免 Typst 渲染錯誤)以及不超過+15%行數增加等約束。支援指定單一 WP 或全部 WP 處理,完成後會報告每個 WP 中處理的章節數和行數變動,並提供後續驗證指令(行數差異、Typst 錯誤檢查、版本確認和 PDF 重建)。該技能特別適合在 Codex 環境下(v3.27.6)維護大型技術文檔集,確保內容結構完整且前後一致。

相容平台✓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        # 所有白皮書 (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句

轉換範例

轉換前:
### Exit Codes
| Code | Signification |
|------|---------------|
| 0    | Autorisé      |

轉換後:
### Exit Codes
Les hooks communiquent avec Codex via des codes de sortie standardisés.
C'est le mécanisme qui permet de bloquer ou autoriser une action en temps réel,
sans intervention humaine.

| Code | Signification |
|------|---------------|
| 0    | Autorisé      |

工作流程:9個並行代理程式

上下文來源

  • machine-readable/reference.yaml:主題映射 → 主要指南行號
  • guide/ultimate-guide.md:參考指南(在 reference.yaml 中所指的行號處)
  • Codex 知識(v3.27.6,MCP,hooks,agent teams 等)

WP 映射

#法文英文~裸章節數
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個代理程式。

若無引數(或 "all"):建立一個 audit-prose-{date} 團隊,並同時啟動9個代理程式。

對每個目標 WP,啟動一個代理程式並使用以下提示:

你是資深技術編輯。你的任務:為白皮書 [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. 逐步編輯法文檔案(使用編輯工具)
5. 讀取完整的英文 WP
6. 編輯英文檔案
7. 檢查:沒有任何段落以 ":" 結尾後接清單
8. 報告:處理的章節數,法文/英文行數差異

等待與回報

等待所有代理程式回傳結果。對每個完成的 WP,顯示:

WP[XX] ✅ — [N] 個章節,+[X]% 法文/英文

關閉

當所有代理程式完成後,對每個代理程式發送 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.

相關技能