エージェントに知識を覚えさせる仕組みを作ると、だいたい2つの問題にぶつかる。1つは、覚えたはずの知識が各マシンや各エージェントに散らばって同期されなくなること。もう1つは、知識もコードも、足すばかりで削られないために膨らみ続け、やがて古い情報や過剰な仕組みが腐っていくことだ。

agent-cortex のスキル群の中には、この「保守」側を担う仕組み系のスキルが揃っている。この記事では knowledge-maintainer と parallelize、そして過剰設計を抑える ponytail 系6スキルを取り上げる。いずれも派手な生成系スキルではないが、長く運用するほど効いてくる類のものだ。

knowledge-maintainer: 終わりに一度だけ棚卸しする

knowledge-maintainer は、タスク終了時の知識レビューを担当するスキルだ。Codex、Gemini CLI、Antigravity のいずれでも、メインエージェントのタスクの終わりに一度だけ実行される想定になっている。読み取りだけのタスクでも対象で、「学ぶことがなかった」が正規の結論として認められているのが特徴だ。

処理の流れはおおむね次の通りである。

まず、持続する新しい事実、前提の訂正、長く効くプロジェクト判断、再利用できるトラブルシュート策を拾う。逆に、一時的なログ、タイムスタンプ、定型出力、検証できない主張、秘密情報や個人データは最初から捨てる。

次に、編集前に既存のワークスペースルールと関連する knowledge を検索し、すでに書かれている内容を重複して足さない。巨大なバックアップや大きな指示ファイルを全部読み込むこともしない。

置き場所は性質で決まる。プロジェクト横断の行動原則は共有の共通ルールへ(ただし稀なケース)、プロジェクトの現行方針はワークスペースの指示へ、詳細な技術や事象の記録はトピック別の knowledge やプロジェクト文書へ。古くなったことが確実な知識は、追記ではなく統合や置き換えで処理する。元の仕様や安全ルール、矛盾する証拠は、決着するまで残すという留保も付いている。

そして、このレビュー自体は読み取り専用が原則だ。書き込みは、ユーザーの既存の明示的な承認とプロジェクトの承認要件の範囲内でのみ行い、それ以外では「内容と保存先の提案」に留める。学習を理由に自動でコミット、Push、マージ、同期、サービス再起動、SSH 変更をしてはいけない。最後に、学びがなければ「学習: なし」と短く報告し、あれば更新した(あるいは提案する)保存先を名指しする。

要するに、記憶の入り口に選別と振り分けと承認の3つの関門を置いたスキルである。起動時の指示ファイルをコンパクトに保ち、詳細はオンデマンドで引ける場所へ逃がす、という全体方針の出口側を担っている。

parallelize: 同期そのものをスキルにする

parallelize は、agent-cortex リポジトリとの同期を担当するスキルだ。「同期して」「並列化して」「最新の記憶を同期」といった依頼や、自動同期のセットアップを求められたときに使う。

やること自体は素朴で、OS ごとに用意された同期スクリプトを叩く。Windows では PowerShell の同期スクリプト、Linux / macOS では Bash の同期スクリプトが対象になる。自動同期のセットアップでは、Windows ならタスクスケジューラ登録用、Linux / macOS なら Cron 登録用のスクリプトを実行する。

このスキルの要点は、実行して終わりではなく確認まで含む点にある。同期後に、リモートから新しい知識を取得したか、ローカルの学びをアップロードしたか、スケジュールによるバックグラウンド同期が有効かどうかを報告する。同期という定型作業をスキル化しておくことで、どのエージェントから頼んでも同じ手順・同じ報告形式になる。

knowledge-maintainer が「何を残すか」を決め、parallelize が「残したものをどう全マシンへ配るか」を担う、という分担である。

ponytail: 怠惰なシニア開発者という型

ここからは毛色が違う。ponytail は、動作する解法の中で最も怠惰なもの、つまり最も単純で、最も短く、最も小さいものを強制するスキルだ。ドキュメント上、名前の由来は明確には説明されていない。比喩として提示されているのは髪型ではなく、「すべてを見てきたシニア開発者」の人格である。曰く、怠惰とは非効率ではなく効率のことであり、最も良いコードは書かれなかったコードだ、という立場を取る。

中核にあるのは7段のはしごで、最初に足が掛かった段で止まる。

1.そもそも存在する必要があるか(YAGNI)
2.このコードベースに既にあるものを使えないか
3.標準ライブラリでできないか
4.プラットフォームのネイティブ機能で賄えないか
5.インストール済みの依存で解けないか
6.1行で書けないか
7.それでも無理なら、動作する最小のコードを書く

強度は lite、full(デフォルト)、ultra の3段階がある。lite は求められたものを実装しつつ、より怠惰な代替案を1行で添える。full ははしごを強制する。ultra は YAGNI の徹底で、追加より削除を優先し、要件そのものにも異議を唱える。

ルールも具体的だ。依頼されていない抽象化、将来のための足場作り、ボイラープレートは禁止。追加より削除、賢さより退屈さを選ぶ。意図的に天井のある単純化をした場合(全体ロックや単純なヒューリスティックなど)は、ponytail: コメントで天井と改善の道筋を明記する。出力はコードが先で、説明は最大3行まで。「何を省略したか、いつ足すべきか」だけを書く形式が指定されている。

一方で、怠惰にしてはいけない範囲も明記されている。信頼境界での入力検証、データ損失を防ぐエラーハンドリング、セキュリティ対策、アクセシビリティの基本は単純化の対象外だ。そして何より、問題の理解については怠けるな、とある。はしごは解法を短くするもので、読む量を減らすものではない。小さい差分を出すために理解を飛ばすのは、最も危険な種類の怠惰だという戒めだ。

ponytail の周辺スキル

ponytail 本体が「作るときの型」だとすれば、周辺の5スキルは点検と可視化を担う。いずれも一回限りの実行で、勝手に修正を適用しないものが多い。

ponytail-review は、差分(diff)に対する過剰設計専門のレビューだ。正しさのレビューとは分業で、複雑さだけを狩る。指摘は1行形式で、delete:(死んだコードや投機的機能)、stdlib:(標準ライブラリで置き換え可能)、native:(プラットフォーム機能で代替可能)、yagni:(実装が1つしかない抽象化など)、shrink:(同じロジックをより短く)のタグを付ける。最後に「正味で何行減らせるか」だけをスコアとして出す。削るものがなければ、それで終わりと宣言する。

ponytail-audit は、そのリポジトリ全体版である。差分ではなくツリー全体を走査し、削れるものを削減量の大きい順に並べる。単一実装のインターフェース、委譲だけのラッパー、誰も設定しない設定項目などが対象になる。こちらも報告のみで修正はしない。

ponytail-debt は、ponytail: コメントを回収して負債台帳にするスキルだ。本体が「天井と再訪条件をコメントに残す」運用なので、そのコメントを grep で集め、ファイルごとに「何を単純化したか、天井は何か、見直すきっかけは何か」を一覧化する。再訪条件の書かれていないコメントには印を付け、「後で」が「永遠にやらない」に化けるのを防ぐ。

ponytail-gain は、行数・コスト・速度について公開ベンチマークの中央値をスコアボード表示するスキルだ。誠実さの境界線が明記されていて、ベンチマーク値を現在のリポジトリの実績のように見せてはいけないとされる。書かれなかった版は基準にならないため、実数として数えられるのは ponytail-debt の台帳だけだという整理である。

ponytail-help は、レベルや各スキルの呼び出し方、デフォルトモードの設定方法(環境変数、設定ファイル、デフォルトの順に解決される)などをまとめたクイックリファレンスカードだ。困ったときに引く索引として置かれている。

まとめ

3系統を並べてみると、役割分担が見えてくる。knowledge-maintainer は知識の入り口で選別し、parallelize は選ばれた知識を全環境へ配り、ponytail 系はそもそも余分なものを生まないことと、生まれた借りを可視化し続けることを担う。

知識管理というと「どう保存するか」ばかりが話題になりがちだが、実際の運用で先に壊れるのは保存先ではなく、選別と棚卸しの方だと思う。足す仕組みと同じくらい、捨てる仕組みと数える仕組みを用意しておくこと。このスキル群は、その地味な側を型として固定しようとしたものだ。