研究手法の書き起こし
別の研究者やエージェントが、手法を生成した会話にアクセスしなくても追跡できるMETHOD.mdを1つ作成します。
手順
- 境界を明確にする。 手法が答える質問、入力、出力を記述します。会話に複数の手法が含まれている場合は、手法ごとに1つのファイルを作成します。
- 最初に出典を収集する。 誰が導出したか(人間、エージェント、または両方)、使用したツールとモデル、使用したスキルやプロンプト、日付。不明な点は推測せずに尋ねます。
- 以下のテンプレートから
METHOD.mdを作成する。 対象リポジトリにmethods/_template/METHOD.mdが存在する場合は、そちらが新しい可能性があるため、そちらを使用します。 - 手順を実行可能にする。 番号付きの手順、正確なコマンドや数式、パラメータのデフォルト値、予想実行時間。
- 検証は具体的に。 手法が機能することを示すテスト、データセット、または健全性チェックを指定し、実際に観測された数値を記録します。
- 制限事項と、開発中に発生した失敗モードを記録する。
- ステータスを正直に設定する。 検証で結果が観測されるまでは
draft、チェックに合格したらvalidated、論文で引用されたらpublished。
ルール
- 実際に実行または導出されたもののみを記録します。テストされていないものは、未テストとして明記します。
- ファイルは自己完結型に保ちます。大きなコードブロックを貼り付けるのではなく、コードへのリンクを貼ります。
- 平易な言葉を推奨します。読者は手法の元になったプロジェクトの専門用語を共有しているとは限りません。
- 出典をでっち上げないでください。不明なモデルや日付は
unknownと記述します。
テンプレート
---
name: <フォルダ名>
description: <1文:何をするか、いつ使うか>
status: draft
origin: human | agent | mixed
agent: claude-code | codex | none
model: <モデルIDまたはunknown>
skill: <使用したSKILL.mdへのリンク、または空>
derived: YYYY-MM-DD
---
# <手法名>
## 概要
## 問題
## 入力と出力
## 手順
## 検証
## 制限事項と失敗モード
## 出典
## 使用箇所
## 参考文献