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句)。
嚴格規則(不可協商)
- 絕對不可以以
:結尾段落後接無序清單 → Typst 錯誤會將項目符號合併為內聯 - 不可以虛構數字、指標或引用
- 不可以添加 callouts(
:::)、Mermaid 或角色情境 - 不可以超過檔案行數的 +15%
- 版本維持在 3.27.6
- 英文散文 = 自然英文,不是法文的逐字翻譯
- 每次添加 = 至少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 映射
| # | 法文 | 英文 | ~裸章節數 |
|---|---|---|---|
| 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個代理程式。
若無引數(或 "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 行 |