Repolode
kharmanskyi

kharmanskyi/open-steps

Claude Code、Codex CLI、Cursor CLI、Gemini CLI向けの平易なエージェントスキル。セッション報告を誰にでも分かる一画面の結論にまとめます。

スター
1,366
フォーク
119
未解決の Issue
0
最終コミット
14 日前

これは何?

Open Stepsは、コーディングエージェントの作業報告の仕方を変えるエージェントスキル集です。コミットハッシュやエンジニア特有の専門用語を並べる代わりに、作業が完了したか、ユーザーに対応してほしいことがあるか、新たな技術的負債が生じたか、セッションを安全に終了できるかを、明確な結論を添えた短い報告にまとめます。

このパックには、ワークフローをカバーする8つのスキルが含まれています。完了した作業の報告、技術に詳しくないユーザー向けの番号付き手順の提示、おすすめの選択肢を添えた質問、元に戻しにくい判断の事前検討、次のタスクの選択、別のセッションの主張と実際の結果の照合、あらゆる文章の平易な表現への書き換え、機能と作業キューを記録するBIG-PICTURE.mdファイルの管理です。

インストール方法はツールによって異なります。Claude Codeでは、ルーティングテーブルの読み込みと報告の保存を行う2つのフックを備えたプラグインを使います。Codex CLI、Cursor CLI、Gemini CLIでは共通のskillsフォルダーを使い、フックの設定を手動で追加する必要があります。報告はリポジトリの外にあるreportsフォルダーに保存されます。

主な機能

  • 01完了状況、ユーザーに必要な対応、新たな負債を含む、完了作業の結論を一画面で報告します。
  • 02技術に詳しくないユーザー向けに番号付きの手順を示し、質問する前にまず自分でタスクを試します。
  • 03別のセッションの主張を、実際に起きたことと照らし合わせて確認します。
  • 04事実を損なわずに、エンジニア向けの専門用語が多い文章を平易な表現に書き換えます。
  • 05機能、未使用のコード、作業キューを記録するBIG-PICTURE.mdファイルを管理します。
  • 06Claude Code、Codex CLI、Cursor CLI、Gemini CLIに対応しています。

ユースケース

  • AIコーディングエージェントでプロダクトを作る非エンジニアが、作業の完了状況を把握したいとき。
  • コミットログではなく、平易な状況報告を求める創業者やプロダクトマネージャー。
  • エージェントの主張を受け入れる前に、別のセッションでその内容を検証したいチーム。
  • マイグレーションやローンチなど、元に戻しにくい変更に進むかどうかを判断するとき。

クイックスタート

  1. 1

    リポジトリをクローンする

    git clone https://github.com/kharmanskyi/open-steps.git
  2. 2

    パックをClaude Codeプラグインとしてインストールする

    claude plugin marketplace add ./open-steps && claude plugin install open-steps@open-steps
  3. 3

    ルーティングブロックをClaude Codeの指示ファイルに追加する

    grep -q 'os-done-or-not' ~/.claude/CLAUDE.md 2>/dev/null || cat open-steps/docs/routing-block.md >> ~/.claude/CLAUDE.md

使う前に知っておきたいこと

  • READMEで一通りテストされているのはClaude Codeのみです。Codex CLI、Cursor CLI、Gemini CLIでのスキルの権限はテストされていません。
  • タスクの注記に別途記載がない限り、チェックに合格し、レビューが承認されると、パックは自動でプルリクエストをマージできます。
  • 更新には、クローン内でのgit pullとプラグインの更新の両方が必要です。そうしないと古いコピーがインストールされたままになります。

トピック

よくある質問

open-steps とは?
Claude Code、Codex CLI、Cursor CLI、Gemini CLI向けの平易なエージェントスキル。セッション報告を誰にでも分かる一画面の結論にまとめます。 Open Stepsは、コーディングエージェントの作業報告の仕方を変えるエージェントスキル集です。コミットハッシュやエンジニア特有の専門用語を並べる代わりに、作業が完了したか、ユーザーに対応してほしいことがあるか、新たな技術的負債が生じたか、セッションを安全に終了できるかを、明確な結論を添えた短い報告にまとめます。
open-steps は無料で使えますか?ライセンスは?
open-steps は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
open-steps は今もメンテナンスされていますか?
活発にメンテナンス中。open-steps の最終コミットは 2026年10月5日 です。
open-steps は何に使えますか?
AIコーディングエージェントでプロダクトを作る非エンジニアが、作業の完了状況を把握したいとき。 コミットログではなく、平易な状況報告を求める創業者やプロダクトマネージャー。 エージェントの主張を受け入れる前に、別のセッションでその内容を検証したいチーム。 マイグレーションやローンチなど、元に戻しにくい変更に進むかどうかを判断するとき。
open-steps のインストール方法は?
リポジトリをクローンする: git clone https://github.com/kharmanskyi/open-steps.git パックをClaude Codeプラグインとしてインストールする: claude plugin marketplace add ./open-steps && claude plugin install open-steps@open-steps ルーティングブロックをClaude Codeの指示ファイルに追加する: grep -q 'os-done-or-not' ~/.claude/CLAUDE.md 2>/dev/null || cat open-steps/docs/routing-block.md >> ~/.claude/CLAUDE.md
open-steps はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/kharmanskyi/open-steps

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト