Community研究&データ分析github.com

FlorianBruniaux/claude-code-ultimate-guide

9つの並列エージェントを使用して、ホワイトペーパーのベアセクション(見出し直後の表・コードブロック・リストなど)に説明的な散文(フランス語+英語)を追加します。

claude-code-ultimate-guide とは?

このスキルは、Codex/Claude Code環境向けに設計された高度なエディトリアルオーケストレーションツールです。ホワイトペーパーの「ベアセクション」(見出しの直後に表やコードブロック、リストが続き、導入段落がないセクション)を自動検出し、各セクションに2〜4文の説明的な散文を追加します。対象は9つのホワイトペーパー(WP00〜08)で、それぞれフランス語版と英語版の両方を処理します。最大の特徴は、9つの並列エージェントが同時に動作し、各エージェントが1つのWPペア(FR+EN)を担当する点です。エージェントは `machine-readable/reference.yaml` と `guide/ultimate-guide.md` をコンテキストソースとして参照し、Codex v3.27.6に関する深い知識を活用します。厳格なルールとして、数値やメトリクスの捏造禁止、Typstバグ回避(リスト前のコロン終了禁止)、+15%行数制限、最大4文などが適用されます。処理後は行数デルタ、Typstバグ、バージョン整合性の自動検証とQuarto再ビルドが可能です。

対応✓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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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文)がないもの。

厳格なルール(譲歩不可)

  1. 絶対に箇条書きの前に段落を : で終了しない → Typstのバグで箇条書きがインラインに統合される
  2. 数値、メトリクス、引用を捏造しない
  3. コールアウト(:::)、Mermaid、ペルソナシナリオを追加しない
  4. ファイルごとの行数増加を+15%以内に抑える
  5. メンテナンスバージョンは 3.27.6
  6. 英語の散文は自然な英語で、FRの逐語訳ではない
  7. 各追加は 最低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マッピング

#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番号の場合:その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別行数予算

WPFR最大予算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行

Individual skills in this repo

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

関連スキル