mcpField
A
agent-standards

agent-standards

github.com/oakossエージェントワークフロー2090 回インストール10 週間前に更新
リポジトリ

agent-standards について

上級AIエージェントの行動と推論の指針を定める基礎スキルです。長期タスクに向けたコンテキスト管理、検証、メモリ、多エージェント連携を扱います。

主な機能

  1. 01構造化された推論手順
  2. 02コンテキストの発見と整理
  3. 03検証可能な実装計画
  4. 04段階的な実装とレビュー
  5. 05階層型メモリ管理
  6. 06マルチエージェント連携

活用シーン

  1. 01エージェントのタスク推論手順の設定
  2. 02長期タスクでのコンテキストとメモリ管理
  3. 03実装後の検証とレビュー手順の整備
  4. 04複雑なタスクで複数エージェントを調整

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/oakoss/agent-skills --skill agent-standards

インストール後、Claude Code で/agent-standardsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
agent-protocols.md
cognitive-architecture.md
context-engineering.md
memory-systems.md

詳細

エキスパート向け指示

概要

シニア AI エンジニアリングエージェント向けに、行動および認知の基準を定める基盤となるメタスキルです。検証可能な成果を伴う、自律的かつ長期的なタスク実行を可能にする、推論パイプライン、メモリアーキテクチャ、コンテキストエンジニアリングの実践方法を確立します。

使用する場面： エージェントの推論設定、コンテキストウィンドウの管理、検証プロトコルの確立、マルチエージェントワークフローの調整、トークン使用量の最適化。

使用しない場面： ドメイン固有のコーディングタスク（専門スキルを使用）、UI/UX デザイン、データベーススキーマ作業。

クイックリファレンス

パターンアプローチ主なポイント
知覚ターミナル出力、コードベース、トレースを分析する高忠実度で入力を取り込む
仮説複数の解決策を生成する決定する前に評価する
シミュレーション変更がもたらす結果を推論する副作用を予測する
アクションツールを正確に実行するアトミックでテスト可能なコミット
批評出力を自己監査するバグやスタイル違反を確認する
コンテキストの把握フレームワークのバージョンやパターンを調べる実装前に必ず把握する
依存関係の監査新しいツールを追加する前に既存のツールを確認する不要な依存関係を避ける
検証可能な計画完了の定義を明確にするテスト合格、ビルド成功、またはユーザーの承認
インタラクティブな認識合わせ要件が曖昧な場合はユーザーに確認する重要なアーキテクチャ上の決定を確認する
アトミックな実装論理的でテスト可能な単位で変更を適用する各コミットを個別に検証できるようにする
監査とクリーンアップリンターを実行し、デバッグ用の成果物を削除する最終出力に一時的なコードを残さない
選択的な読み取りオフセットと上限のパラメーターを使用する大きなファイル全体を読み込まない
シンボル検索grep/rg で定義を検索するディレクトリ全体を読み込まない
Few-shot によるアンカリング代表的な例を提示する長いルールのリストより効果的
メモリの階層化短期、中期、長期に分ける情報の寿命に応じて保持期間を設定する
コンテキストのパッキング関連するファイルをまとめる構造化された Markdown 成果物
ノイズの低減node_modules、dist、バイナリ成果物を除外するコンテキストの信号対雑音比を最大化する
意味的な要約長いログを実行可能な事実にまとめる失敗の説明を一文にまとめる
認知負荷の削減現在のコンテキストから無関係な履歴を取り除く現在のタスクの推論に使えるトークンを確保する

よくある間違い

間違い正しいパターン
ツール呼び出しやビルド手順でエラーが発生しても、何も報告しないステータスとエラーを必ずユーザーに明示的に報告します
存在しない API やメソッドをでっち上げるAPI シグネチャを使用する前に、ドキュメントを検索するか、ウェブ検索で確認します
コードを示さず、冗長な説明を書くコードを中心に伝えることを優先し、求められた場合にのみ説明します
周囲のコードのスタイルや規約を無視する既存のコードベースのパターン、命名規則、書式に倣います
ソースファイルにシークレットや API キーをハードコーディングする環境変数と .env ファイルのマッピングを使用します
1 つのシンボルを探すためにディレクトリ全体を読み込むgrep または rg で定義を検索し、関連する箇所だけを読みます
実装後の検証を省略する完了とする前に、すべてのタスクで検証できる根拠を確認します
機密データをメモリやコンテキストファイルに保存するメモリベクトルを永続化する前に、必ずシークレットをスクラブします
ファイルの内容全体を不必要にコンテキストに読み込む大きなファイルはオフセットと上限を指定して一部だけ読み込みます
複数の情報源から重複した情報を含めるトークン予算を保つため、コンテキスト内の重複を排除します

委任

  • コードベースを調査して、フレームワークのバージョンと現在のパターンを把握する：Explore エージェントを使用します
  • 複雑な複数手順の実装を、個別のコミットに分けて実行する：Task エージェントを使用します
  • 依存関係を分析し、長期的な機能のアーキテクチャを計画する：Plan エージェントを使用します

参考資料

コメント

Markdown 対応