Communityライティング&編集github.com

Angkon/agent-skills

研究方法をMETHOD.mdとして文書化し、出典と検証セクションを含める形式を提供します。研究メソッドリポジトリで使用される形式に従い、メソッド、手順、アルゴリズム、分析レシピを再利用可能な形で書き起こす、記録する、形式化するよう求められた場合に使用します。

agent-skills とは?

このスキルは、研究手法や手順を体系的に文書化するためのテンプレートと手順を提供します。主な目的は、他の研究者やAIエージェントが、元の会話にアクセスしなくても再現可能な`METHOD.md`ファイルを作成することです。対応プラットフォームはClaude Code、Codexなど、SKILL.md形式をサポートする任意のエージェント環境です。手順は、まず手法の境界を明確にし、出典(誰が導出したか、使用したツールやモデル、日付)を収集することから始まります。次に、定義されたテンプレートを使用して手順を実行可能な形で記述し、具体的な検証テスト、制限事項、失敗モードを記載します。ステータスは`draft`(検証未完了)、`validated`(検証済み)、`published`(論文で引用)の3段階で正直に設定します。このスキルの価値は、研究プロセスの透明性と再現性を高め、異なるプロジェクト間で手法を共有・再利用できるようにすることです。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Angkon/agent-skills/tree/HEAD/skills/research-method-writeup

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

研究手法の書き起こし

別の研究者やエージェントが、手法を生成した会話にアクセスしなくても追跡できるMETHOD.mdを1つ作成します。

手順

  1. 境界を明確にする。 手法が答える質問、入力、出力を記述します。会話に複数の手法が含まれている場合は、手法ごとに1つのファイルを作成します。
  2. 最初に出典を収集する。 誰が導出したか(人間、エージェント、または両方)、使用したツールとモデル、使用したスキルやプロンプト、日付。不明な点は推測せずに尋ねます。
  3. 以下のテンプレートからMETHOD.mdを作成する。 対象リポジトリにmethods/_template/METHOD.mdが存在する場合は、そちらが新しい可能性があるため、そちらを使用します。
  4. 手順を実行可能にする。 番号付きの手順、正確なコマンドや数式、パラメータのデフォルト値、予想実行時間。
  5. 検証は具体的に。 手法が機能することを示すテスト、データセット、または健全性チェックを指定し、実際に観測された数値を記録します。
  6. 制限事項と、開発中に発生した失敗モードを記録する。
  7. ステータスを正直に設定する。 検証で結果が観測されるまでは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
---

# <手法名>

## 概要
## 問題
## 入力と出力
## 手順
## 検証
## 制限事項と失敗モード
## 出典
## 使用箇所
## 参考文献

関連スキル