Technical Research

非自明な技術課題を、既存実装と一次資料から調査して根拠付きの方針にする。実装前の調査や API の不確実性解消に使う。「技術調査して」「公式仕様を確認」「実装前に調べて」を正のトリガーとし、既知の局所修正やコードベース全体の改善監査には使わない。

MasashiFukuzawa fe82e96 1.4 KB Updated

File contents

Technical research

安全契約

  • 調査は read-only で始める。依頼が調査だけならコードや外部状態を変更しない。
  • API、version、制限値、推奨手順は記憶で断定せず一次資料を確認する。
  • credential、非公開データ、認証済みページの本文を引用・保存しない。

手順

  1. 問いを「確認すべき事実」「設計判断」「対象外」に分解する。
  2. リポジトリ内の実装、設定、テスト、ADR を rg で調べる。
  3. 不確実な API や挙動は公式 documentation、仕様、一次論文で確認する。
  4. 事実、推論、未確認事項を分け、根拠へのリンクまたはファイル位置を添える。
  5. 選択肢を比較し、互換性・安全性・保守性を基準に推奨を明示する。
  6. 実装依頼を含む場合だけ、方針確定後に変更へ進む。

公式資料が見つからない場合は、推測を事実として扱わず、検証方法と残る不確実性を報告する。

MasashiFukuzawa/agent-toolbox/tree/main/plugins/toolbox/skills/technical-research commit fe82e96d14

Frequently asked questions

npx skillmds@latest add masashifukuzawa/technical-research