# Technical Research

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

- Skill: `masashifukuzawa/technical-research` (Agent Skill)
- Install (CLI): `npx skillmds@latest add masashifukuzawa/technical-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/masashifukuzawa/technical-research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: MasashiFukuzawa (https://skillmd.com/u/masashifukuzawa)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/masashifukuzawa/technical-research

---

# Technical research

## 安全契約

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

## 手順

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

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