source-command-audit-prose
ユーザーが移行済みのソースコマンド audit-prose を実行するよう依頼した場合に、このスキルを使用します。
コマンドテンプレート
Audit Prose — ベアセクションの充実
ホワイトペーパーの各「ベアセクション」の前に、説明的な散文(2〜4文)を追加します。 「ベアセクション」とは、見出しの直後に表、コードブロック、またはリストが続き、導入段落がないセクションを指します。
使用法
/audit-prose # 全WP(00-08)、FR + EN
/audit-prose 07 # WP07のみ(FR + EN)
/audit-prose 03 07 # WP03とWP07のみ
「ベアセクション」の定義
セクション(## または ###)の直後に以下が続くもの:
- Markdown テーブル(
|) - コードブロック(
```) - 箇条書き(
-)または番号付きリスト
導入段落(最低2文)がないもの。
厳格なルール(譲歩不可)
- 絶対に箇条書きの前に段落を
:で終了しない → Typstのバグで箇条書きがインラインに統合される - 数値、メトリクス、引用を捏造しない
- コールアウト(
:::)、Mermaid、ペルソナシナリオを追加しない - ファイルごとの行数増加を+15%以内に抑える
- メンテナンスバージョンは 3.27.6
- 英語の散文は自然な英語で、FRの逐語訳ではない
- 各追加は 最低2文、最大4文
変換例
変更前:
### Exit Codes
| Code | 意味 |
|------|------|
| 0 | 許可 |
変更後:
### Exit Codes
フックは標準化された終了コードを介してCodexと通信します。
これにより、人間の介入なしにアクションをリアルタイムでブロックまたは許可するメカニズムが実現します。
| Code | 意味 |
|------|------|
| 0 | 許可 |
ワークフロー:9つの並列エージェント
コンテキストソース
machine-readable/reference.yaml: トピック → メインガイドの行番号マッピングguide/ultimate-guide.md: リファレンスガイド(reference.yamlで指定された行)- Codexの知識(v3.27.6、MCP、フック、エージェントチームなど)
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番号の場合:そのFR/ENペアに対して1つのエージェントのみ起動します。
引数がない(または「all」)場合:audit-prose-{日付} チームを作成し、9つのエージェントを並列起動します。
対象の各WPに対し、以下のプロンプトでエージェントを起動します:
あなたはシニアテクニカルエディターです。ミッション:ホワイトペーパー[XX - タイトル]の「ベアセクション」に説明的な散文を追加すること。
## 「ベアセクション」の定義
セクション(##または###)の直後に表、コードブロック、箇条書きが続き、導入段落(2文以上)がないもの。
## あなたが行うこと
特定された各ベアセクションに対して:
1. 構造化されたコンテンツの前に2〜4文を追加する
2. 各文は新しい情報を提供:理由、使用タイミング、影響、デザインの選択、実践的なコンテキスト
3. 後続を言い換えるのではなく、不足しているコンテキストを補完する
## コンテキストソース
- `machine-readable/reference.yaml`:トピック → メインガイドの完全マッピング
- Codexの知識(v3.27.6、MCP、フック、エージェントチームなど)
## 厳格なルール
- 数値、メトリクス、引用を捏造しない
- コールアウト(:::)、Mermaid、ペルソナシナリオを追加しない
- 箇条書きの前に段落を「:」で終了しない(Typstバグ)
- 行数増加を+15%以内に抑える
- バージョンを3.27.6に維持
- 英語の散文は自然な英語で、逐語訳ではない
- 各追加は最低2文、最大4文
## プロセス
1. reference.yamlを読む(WPに関連するセクション)
2. フランス語版WP全体を読む
3. すべてのベアセクションを特定する
4. フランス語ファイルを編集する(Editツール、セクションごと)
5. 英語版WP全体を読む
6. 英語ファイルを編集する
7. 確認:箇条書きの前に「:」で終わる段落がないこと
8. 報告:処理したセクション数、FR/ENの行数差分
待機と報告
すべてのエージェントからの応答を待ちます。各WP完了ごとに、以下を表示:
WP[XX] ✅ — [N] セクション, +[X]% FR/EN
シャットダウン
すべてのエージェントが完了したら、各エージェントに shutdown_request を送信し、その後 TeamDelete を実行します。
充実後検証
# 1. 行数差分(最大+15%)
for f in whitepapers/fr/*.qmd; do
echo "$(wc -l < "$f") $(basename $f)"
done
# 2. Typstバグ確認:リスト前に「:」で終わる段落
rgrep -n ':$' whitepapers/fr/*.qmd whitepapers/en/*.qmd | head -20
# 3. バージョン整合性
rgrep "^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 | FR最大予算 | EN最大予算 |
|---|---|---|
| 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行 |