Communitygithub.com

オートリサーチ

厳格な評価者コントラクト、マークダウン形式の決定ログ、最大実行時間による停止動作を備えた、状態を持つ単一ミッション改善ループです。

オートリサーチ とは?

Autoresearchは、単一のミッションに対して評価駆動型の反復改善を実行するステートフルスキルです。ユーザーは事前に`/deep-interview --autoresearch`でミッションと評価者を生成しておく必要があり、スキルはそのミッションにのみ責任を持ちます。各反復では実験と評価を実行し、評価結果をJSONとして、人間が読める決定ログをマークダウンとして`.omc/autoresearch/`以下に永続化します。評価が合格しなくても実行は継続され、最大実行時間(max-runtime)に達するか、ユーザーが明示的にキャンセルするか、その他の終了条件が満たされた場合にのみ停止します。v1では複数ミッションのオーケストレーションは禁止されており、Claude Codeのネイティブcronと統合して定期的な再実行も可能です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/autoresearch

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

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

ドキュメント

<目的> Autoresearchは、制限付きで評価者駆動の反復改善を行うステートフルスキルです。一度に1つのミッションを担当し、不合格の結果が出ても反復を継続し、各評価と判断を永続的なアーティファクトとして記録し、明示的な最大実行時間またはその他の明示的な終了条件に達した場合にのみ停止します。 </目的>

<使用タイミング>

  • /deep-interview --autoresearch によってミッションと評価者がすでに用意されている場合
  • 厳格な評価を伴う永続的な単一ミッションの改善が必要な場合
  • .omc/autoresearch/ 以下に耐久性のある実験ログが必要な場合
  • Claude Codeネイティブのcronによる定期的な再実行のサポートパスが必要な場合 </使用タイミング>

<使用すべきでない場合>

  • 実行時に評価者を生成する必要がある場合 — 先に /deep-interview --autoresearch を使用してください
  • 複数のミッションをまとめてオーケストレーションする必要がある場合 — v1では禁止されています
  • 非推奨の omc autoresearch CLI フローを使用したい場合 — これはもはや信頼できる方法ではありません </使用すべきでない場合>

<コントラクト>

  • v1では単一ミッションのみ
  • ミッションのセットアップと評価者の生成は deep-interview --autoresearch に任せる
  • 評価者の出力は構造化JSONである必要があり、必須の真偽値 pass とオプションの数値 score を含むこと
  • 不合格の反復でも実行は停止しない
  • 停止条件は明示的かつ制限付きであり、最大実行時間が主要な厳格な停止フックとなる </コントラクト>

<必要なアーティファクト> 正規の永続ストレージは .omc/autoresearch/<mission-slug>/ および/または .omc/logs/autoresearch/<run-id>/ に配置されます。

最低限必要なアーティファクト:

  • ミッション仕様書
  • 評価者スクリプトまたはコマンドリファレンス
  • 反復ごとの評価JSON
  • マークダウン形式の決定ログ

推奨される正規の構造:

.omc/autoresearch/<mission-slug>/
  mission.md
  evaluator.json
  runs/<run-id>/
    evaluations/
      iteration-0001.json
      iteration-0002.json
    decision-log.md

既存のランタイムアーティファクトを不必要に複製せず、可能な限り再利用してください。 </必要なアーティファクト>

<ワークフロー>

  1. 単一のミッションが存在し、評価者のセットアップがすでに利用可能であることを確認する。
  2. モード/状態が autoresearch に対してアクティブであり、以下を記録していることを確認する:
    • ミッションスラッグ/ディレクトリ
    • 評価者リファレンス
    • 反復回数
    • 開始/更新タイムスタンプ
    • 明示的な最大実行時間または期限
  3. 各反復で:
    • 正確に1回の実験/変更サイクルを実行する
    • 評価者を実行する
    • 機械可読な評価JSONを永続化する
    • 人間可読なマークダウン決定ログエントリを追記する
    • 評価が合格しなくても継続する
  4. 以下の場合に停止する:
    • 最大実行時間に達した場合
    • ユーザーが明示的にキャンセルした場合
    • その他の明示的な終了条件がランタイムによって記録された場合 </ワークフロー>

<cron統合> Claude Codeネイティブのcronは、定期的なミッション拡張のためのサポート統合ポイントです。v1では、大規模なスケジューラUIを構築するよりも、cron入力を文書化・設定することを推奨します。

cronを使用する場合:

  • スケジュールされたジョブごとに1つのミッションを維持する
  • 同じミッション/評価者コントラクトを保持する
  • 以前の実験を上書きせずに、新しい実行アーティファクトを追加する </cron統合>

<実行ポリシー>

  • omc autoresearch に実行を戻さない
  • 複数ミッションのオーケストレーションを作成しない
  • src/autoresearch/* のランタイム/スキーマヘルパーを、すでにより厳格なコントラクトに一致している場合は優先的に再利用する
  • ログは機械だけでなく人間にとっても有用なものにする </実行ポリシー>

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

agent-doc-discipline

Writing-time discipline for documents agents consume (the five surfaces, specs, tickets, .omc/skills/) — every rule checkable and carrying a why, steps before reference, one meaning in one home, no restating what the environment already says. Mandatory at drydock seed generation and the launch C5 sediment pass; opt-in for any other agent-facing doc edit. The companion of minimal-code-discipline: that one disciplines code, this one disciplines papers.

ai-slop-cleaner

Clean AI-generated code slop with a regression-safe, deletion-first workflow and optional reviewer-only mode

ask

Process-first advisor routing for Claude, Codex, Gemini, Antigravity, Grok, or Cursor via `omc ask`, with artifact capture and no raw CLI assembly

ask-navigator

Shipyard

autopilot

Full autonomous execution from idea to working code

cancel

Cancel any active OMC mode (autopilot, ralph, ultragoal, swarm, ultrapilot, pipeline, team) and clean up retired legacy state

configure-notifications

Configure notification integrations (Telegram, Discord, Slack) via natural language

debug

Diagnose the current OMC session or repo state using logs, traces, state, and focused reproduction

deepinit

Deep codebase initialization with hierarchical AGENTS.md documentation

deep-interview

Socratic deep interview with mathematical ambiguity gating before explicit execution approval

drydock

Lay the keel of the shipyard harness in any repo — the 4-pillar shared environment (Context, Rules, Tools, Standards) across 5 surfaces (CLAUDE.md, skills, design-system, mcp/cli, shared context) so that every human and agent inherits the same design language and anyone can ship. Run once per repo; re-run with --check to audit drift.

execute

Carry an approved task through to working, verified code

external-context

Invoke parallel document-specialist agents for external web searches and documentation lookup

graph

Deterministic orchestration graph runtime - declarative DAG pipelines with journal-based crash recovery

harbor

Harbor intake for external work — the captain only handles unresolved decisions. Sweeps incoming issues and PRs, verifies every claim before disposition, reuses every decision already made, and hands the maintainer a docket whose pending items each carry one question with options, recommendation, impact and evidence. Agent-autonomous for facts and for actions covered by standing authorization; signed for every new judgment. Never merges.

hud

Configure HUD display options (layout, presets, display elements)

launch

Shipyard

loft

Loft the shape before cutting steel — answer a design question that prose cannot settle by building a throwaway artifact: a pure logic module in a clickable shell, or structurally different UI variants behind one route. The captain reacts to the artifact; the answer folds into the decision; the artifact never docks. Use when a design question stalls in words, when a navigator map carries a loft ticket, or when a spec discussion reaches

minimal-code-discipline

YAGNI-ladder coding discipline for writing changes — existence-first, reuse before writing, dependency ladder, shortest correct diff, with non-negotiables that must never be minimized away

omc-doctor

Diagnose and fix oh-my-claudecode installation issues

関連スキル