自動化の仕組み
透明性のためのページです。最小限のメンテナー労力で AILmanac を新鮮かつ高品質に保つための仕組みを紹介します。一貫した原則は次のとおりです。自動化は人間が承認するための作業を提示するだけで、検証されていない主張をひそかに公開することは決してありません。
ビルドゲート(稼働中)
すべての変更は onBrokenLinks: 'throw' でビルドされるため、内部リンク切れや壊れた MDX があるとマージ前にビルドが失敗します。これは単独で最も価値のあるチェックであり、ナビゲーションの信頼性を保ちます。
CI ワークフロー
ワークフローファイルは
ci-workflowsブランチにあり、リポジトリにworkflowスコープを持つトークンが設定されると有効になります(README を参照)。それまでの間、サイトはgh-pagesブランチからデプロイされます。
build-check— すべての PR をビルドします(リンク切れがあると失敗)。必須チェックです。deploy—mainへのプッシュ時にビルドし、GitHub Pages へ公開します。link-check—lycheeを毎週および PR 時に実行します。外部リンク切れがあると、単に赤くなるのではなく追跡用の Issue を作成します(ラベルlink-rot)。
鮮度の自動化(計画中/段階的)
- リリースウォッチャー — Anthropic のドキュメント/変更履歴に加えて、最も変化の速い利用面(アプリ、音声、モバイル、マーケットプレイス)を定期的にポーリングするジョブです。変更を検知すると、影響を受けそうなページを指す
upstream-change+needs-verificationラベルの Issue/PR を作成します。更新は人間が書きます。 - モデルテーブル検証ツール —
data/models.jsonを公式のモデル一覧と差分比較し、何かがずれたときに PR を作成します。モデルテーブルには「最終検証日」が表示されます。 - 陳腐化スイープ —
lastVerifiedがしきい値より古い変動しやすいページにフラグを立てます。
なぜ人間を介在させるのか
:::tip 自動化されていて正直 > 自動化されていて間違っている リファレンスサイトに「ニュース」を自動コミットする AI は、ハルシネーションを公開するリスクを抱えています。これは信頼性とは正反対です。そのため当プロジェクトの自動化は提案する(Issue/PR)にとどめ、検証とマージは人間が行います。ファクト検証を参照してください。 :::
自動化を手伝いたいですか?
これらのワークフローの改善は、優れた上級者向けの貢献です。.github/workflows(ci-workflows ブランチ上)と貢献ガイドを参照してください。