mcpField
O
orient

orient

github.com/camachoエージェントワークフロー646 回インストール
リポジトリ

orient について

orient は、タスクの背景を集め、種類を判定し、プロジェクトの決定事項や最近のメモリを確認して、概要と進行先を提案するエージェントスキルです。リポジトリでの作業開始に使います。

主な機能

  1. 01利用可能な場合に GitHub issue の詳細を取得
  2. 02タスク分類とブランチ接頭辞の選択
  3. 03関連する ADR の確認
  4. 04中断中の作業と最近のメモリの確認
  5. 05タスク概要と進行先の提案

活用シーン

  1. 01GitHub issue から作業を開始
  2. 02タスク説明からブランチ計画を準備
  3. 03保存されたブランチ情報を使って作業を再開

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/camacho/ai-skills --skill orient

インストール後、Claude Code で/orientを入力して読み込まれたか確認します。

詳細

フェーズゲート：EXPLORE チェックポイント。このスキルでは、Isolate に進む前にすべての手順を必ず完了してください。

手順

  1. Issue のコンテキストを取得する（Issue 番号が指定されている場合）：

    gh issue view <number> --json title,body,labels,assignees

    Issue 番号が指定されていない場合は、タスクの説明をユーザーに求めてください。 gh が利用できない場合（GH_TOKEN のないリモートセッション）は、Issue の取得をスキップし、手動での説明に進んでください。

  2. タスクの種類を自動検出する（ラベルまたは説明から）：

    ラベル／キーワード種類ブランチのプレフィックス
    bug、エラー、クラッシュ、故障、修正バグ修正fix/
    enhancement、機能、追加、欲しい、すべき、新規機能feat/
    chore、設定、依存関係、CI、ツール雑務chore/
    docs、ドキュメント、readmeドキュメントdocs/
    デフォルト機能feat/

  3. 関連する ADR を検索する：

    ls "$(git rev-parse --show-toplevel)/ai-workspace/decisions/"*.md 2>/dev/null | head -20

    Issue のタイトル／本文に一致するキーワードがないか、ADR のタイトル／ファイル名を確認してください。一致するものが見つかった場合は、該当する ADR を読み、提示してください。 ADR の検索で矛盾が見つかった場合は、「このタスクは ADR-NNN と矛盾する可能性があります」と明示してください。

  4. 中断された作業を確認する： "$(git rev-parse --show-toplevel)/.branch-context.md" が存在する場合は、それを読み、ブリーフに含めてください（作業を再開します）。

  5. 最近のメモリを読む：

    tail -20 "$(git rev-parse --show-toplevel)/ai-workspace/MEMORY.md" 2>/dev/null

  6. ブリーフを提示する：

    ## Orient Brief
**Task**: [title or description]
**Type**: [bugfix/feature/chore/docs] → branch prefix: [fix/feat/chore/docs]/
**Suggested branch**: [prefix]/[kebab-case-name]
**Relevant ADRs**: [list or "none found"]
**Resuming?**: [yes — from .branch-context.md / no]
**Files likely affected**: [educated guess from issue description + ADR context]

  7. 1文ルールを使って自動で振り分ける：

    • このタスクの差分全体を1文で説明できますか？ → Isolate に直接進む（Design／Review をスキップ）
    • それ以外 → まず計画を立てる（Isolate の後に Design に進む）

    振り分けの判断を提示してください。エージェントが自動で判断するため、人による入力は不要です。人が参加している場合は、判断を上書きできます。

例外ケース

  • Issue 番号もユーザーによる説明もない → 説明を求める
  • gh が利用できない → Issue の取得をスキップし、手動での説明に進む
  • ADR ディレクトリがない → ADR の検索をスキップする

コメント

Markdown 対応