kharmanskyi/open-steps

Open Steps – Claude Code、Codex、Cursor、Gemini エージェント向け平易な言語の「スキル」

概要

• 再利用可能なスキル（小さなプロンプトテンプレートと数個のシェルスクリプト）のコレクションで、Claude Code、Codex CLI、Cursor CLI、Gemini CLI に追加できます。
• 各スキルは、LLMエージェントに、技術者ではない人間との対話を、平易で非技術的な言葉で出力し、構造化する方法を指示します。
• このパックには、各エージェントセッションの開始時と終了時に実行される2つのフックも含まれており、ルーティングテーブルを自動的に挿入し、実際の作業が行われた場合は、簡潔な「ワンスクリーン」レポートの生成をエージェントに求めます。

主な機能

スキル	得られるもの	実行タイミング
os‑done‑or‑not	ワンスクリーンの判定: 完了? はい/いいえ、必要な入力、新たな技術的負債、閉じても安全かどうかのフラグ。	タスクが完了したとき、または「完了しましたか?」と尋ねたとき。
os‑step‑by‑step	ユーザーが従うべき番号付きの非技術的な手順。エージェントは、自分では実行できない操作のみをユーザーに要求します。	エージェントがユーザーにコマンドの実行、クリック、承認などを求める必要があるとき。
os‑ask‑simple	平易な言葉での質問、推定コスト、単一のハイライトされた推奨事項。	エージェントに決定ポイントがある場合、または確認が必要な場合。
os‑what‑could‑go‑wrong	プレモーテム分析: 決定が失敗すると仮定し、逆算して、最終的な判定を下します。	元に戻せないアクション（契約、移行、ローンチ）を実行する前。
os‑whats‑next	検証済みの内容を要約し、次の具体的なタスクを日常の言葉で提案します。	「残りは何ですか?」と尋ねたとき、またはレポート作成後。
os‑check‑work	以前のセッションからの主張を再検証し、不一致と次のステップを報告します。	別のセッションがジョブが完了したと主張したとき。
os‑say‑simple	任意のテキストブロック（レポート、コメント、エラー）を、事実を維持しながら平易な言語に書き換えます。	既存のテキストのより簡潔なバージョンが必要なとき。
os‑big‑picture	BIG‑PICTURE.md を維持し、製品機能、そのステータス、未使用部分、バックログを一覧表示します。承認後、トラッカーでチケットを開くことができます。	プロジェクト全体のステータスやバックログの表示が必要なとき。

仕組み

• 各スキルは、プロンプトを定義する SKILL.md と、実際の例を含む references/ フォルダを持つ、独自のフォルダ（skills/os-*）にあります。
• 2つのフック（session-start.sh と stop-report.sh）は小さなシェルスクリプトです。開始フックは、ルーティングテーブル（各スキルをいつ起動するかをエージェントに指示する小さなマークダウンテーブル）と最新のレポートをLLMのコンテキストに注入します。停止フックは、セッション終了時のリポジトリの状態を開始時のスナップショットと比較し、十分なファイルが変更された場合、エージェントにレポートの作成を求めます。
• Claude Code の場合、スキルとフックを自動的に配線するプラグインとしてパッケージ化されています。Codex CLI、Cursor CLI、Gemini CLI の場合は、スキルフォルダを ~/.agents/skills/ にコピーし、ルーティングブロックとフック定義をそれぞれの設定ファイルに手動で追加します。
• このパックは自律的なマージも実行できます。PR に緑のチェックと承認済みレビューがある場合、エージェントは再度検証してマージします（gh pr merge またはツールのネイティブマージコマンドを使用）。権限は、Claude Code のプラグインマニフェストの allowed-tools フィールドで制御されます。

インストールのクイックスタート

1. git clone https://github.com/kharmanskyi/open-steps.git
2. Claude Code – claude plugin marketplace add ./open-steps && claude plugin install open-steps@open-steps
   • ルーティングブロックを ~/.claude/CLAUDE.md に追加します（リポジトリには既製のスニペットが用意されています）。
3. その他のエージェント – スキルフォルダをコピーします:

   mkdir -p ~/.agents/skills && cp -R open-steps/skills/os-* ~/.agents/skills/
   

   • ルーティングブロックをツール固有の常時指示ファイル（Cursor の場合は ~/.codex/AGENTS.md、プロジェクトルートの AGENTS.md、または ~/.gemini/GEMINI.md）に挿入します。
   • docs/other-agents.md の説明に従って、2つのフックを配線します。
4. bash open-steps/doctor.sh を実行して、スキル、ルーティングブロック、フックが正しくインストールされていることを確認します。

評価

• 著者は、3つのClaudeモデル（Haiku 4.5、Sonnet 5.5、Opus 5.5）と他の3つのエージェントにわたって、25の代表的なフレーズのスモークテストを実施しました。すべてのスキルは、トピックに関するクエリで正しく起動し、Haikuでは全体のアクティベーション率89％、新しいモデルでは100％でした。オフトピックのアクティベーションは観察されませんでした。
• 詳細な結果とテストハーネスは evals/ ディレクトリ（cases.md、results.md、run.sh）にあります。

対象読者

• プロダクトビルダー、プロジェクトマネージャー、またはコード関連の作業にLLMエージェントを使用したいが、複雑なエンジニアリングレポートを解釈したくない人。
• すでにClaude Code、Codex CLI、Cursor CLI、Gemini CLIを使用しており、エージェントの出力の上に一貫した平易な言語レイヤーが必要なチーム。

ライセンスと貢献

• MITライセンス。無料で使用、変更、再配布できます。
• 貢献を歓迎します。プロセスについては CONTRIBUTING.md を参照してください。

---

要するに、Open Steps は、LLMコーディングエージェントの生の技術的なやり取りを、簡潔で人間にわかりやすいステータスレポートとステップバイステップのガイダンスに変える、プラグアンドプレイのプロンプトテンプレートと小さなスクリプトのセットです。