mcpField
O
openspec-onboard

openspec-onboard

github.com/full-stack-skillsエージェントワークフロー188 回インストール4 週間前に更新
リポジトリ

openspec-onboard について

openspec-onboardは、OpenSpecを初めて使う人向けの対話型チュートリアルスキルです。実際のコードベースを使い、改善点の発見から変更のアーカイブまでを一通り進めます。

主な機能

  1. 01OpenSpecワークフローのガイド付きチュートリアル
  2. 02実際のコードベースの分析
  3. 03実際の変更の作成と実装
  4. 04変更の検証とアーカイブ

活用シーン

  1. 01OpenSpecを初めて実践的に学ぶ
  2. 02プロジェクト作業の前に手順を練習する

インストール

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

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-onboard

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

同梱ファイルagents/openai.yaml

詳細

OpenSpec オンボーディングスキル

OpenSpec のワークフロー全体を、ガイド付きの対話型チュートリアルで学ぶには /opsx:onboard を使用します。このチュートリアルでは、ユーザーの実際のコードベースを使い、実際に改善できる箇所を見つけ、変更を作成して実装し、アーカイブします。

使用するタイミング

  • OpenSpec を初めて使うユーザーが、実践的なチュートリアルを希望する場合。
  • ユーザーが「オンボーディング」「チュートリアル」「OpenSpec の使い方を教えて」と言った場合。
  • 実際の作業に使う前に、ワークフローを学ぶ場合。

前提条件

  • プロジェクトで OpenSpec が初期化済み であること（openspec-initial を参照）。

ワークフロー

  1. オンボーディングを開始する

    • /opsx:onboard を実行します。

  2. チュートリアルのフェーズ

    1. ようこそ、コードベースの分析。
    2. 改善できる箇所を見つける（小規模で安全な変更）。
    3. 変更を作成する（/opsx:new）。
    4. 提案を書く。
    5. 仕様を作成する。
    6. 設計を書く。
    7. タスクを作成する。
    8. タスクを実装する（/opsx:apply）。
    9. 実装を検証する。
    10. 変更をアーカイブする。
    11. まとめと次のステップ。

  3. 対話形式

    • エージェントは、各ステップの実行中にその内容を説明します。
    • どの改善に取り組むかはユーザーが選びます。
    • 作成された変更は実際のもので、保持することも破棄することもできます。

成果物

  • ユーザーの実際のコードベースを使った、提案からアーカイブまでの変更サイクル全体。
  • ユーザーはすべての OPSX コマンドを実際に体験できます。

次のステップ

  • openspec-new または openspec-explore を使って、実際の作業を始めます。

トラブルシューティング

  • 「コマンドが認識されません」：OpenSpec が初期化されていることを確認します（openspec init）。openspec-initial を参照してください。
  • 時間がかかりすぎる：このチュートリアルではワークフロー全体を扱います。15～30 分ほどかかります。

参考資料

コメント

Markdown 対応