mcpField
T
trellis-start

trellis-start

github.com/mindfold-aiエージェントワークフロー15.0k132 回インストール4 週間前に更新
リポジトリ

trellis-start について

trellis-start は、Trellis で管理する開発セッションを初期化するスキルです。コーディングエージェント向けに、プロジェクトの状態やワークフロー、次の作業を整理します。

主な機能

  1. 01get_context.py でセッション状態を取得
  2. 02ワークフローの段階と分類ルールを確認
  3. 03関連するガイド索引を検索
  4. 04次に行うタスクを判断
  5. 05関連する Trellis スキルへ作業を案内

活用シーン

  1. 01Trellis の開発セッションを再開
  2. 02進行中タスクの段階と状態を確認
  3. 03実装開始前にガイドを探す

インストール

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

$npx skills add https://github.com/mindfold-ai/trellis --skill trellis-start

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

詳細

セッションを開始する

Trellis で管理された開発セッションを初期化します。このプラットフォームにはセッション開始時のフックがないため、次の手順に従って同等の簡潔なコンテキストを手動で読み込みます。


ステップ 1:現在の状態

本人情報、git のステータス、現在のタスク、アクティブなタスク、ジャーナルの場所。

python3 ./.trellis/scripts/get_context.py

この出力に Trellis update available: で始まる行が含まれている場合は、セッションコンテキストの要約に、その行全体を一字一句そのまま記載してください。操作コマンドのヒントを短縮しないでください。

ステップ 2:ワークフローの概要

フェーズの簡潔なインデックス、リクエストのトリアージルール、計画成果物の要件、ステップ詳細のコマンド。

python3 ./.trellis/scripts/get_context.py --mode phase

完全なガイドは .trellis/workflow.md にあります(必要に応じて読み込んでください)。

ステップ 3:ガイドラインのインデックス

パッケージと仕様レイヤーを確認し、関連するインデックスファイルをそれぞれ読み込みます。

python3 ./.trellis/scripts/get_context.py --mode packages
cat .trellis/spec/guides/index.md
cat .trellis/spec/<package>/<layer>/index.md   # for each relevant layer

インデックスファイルには、実際にコーディングを始める際に読むべき具体的なガイドライン文書が記載されています。

ステップ 4:次のアクションを決める

ステップ 1 で現在のタスクとステータスが分かります。タスクディレクトリを確認してください。

  • アクティブなタスクのステータスが planning で、prd.md がない → フェーズ 1.1。trellis-brainstorm スキルを読み込みます。
  • アクティブなタスクのステータスが planning で、prd.md がある → フェーズ 1 を続けます。軽量なタスクは PRD のみで済ませられます。複雑なタスクには design.md と implement.md が必要です。task.py start の前に、該当するフェーズ 1 のステップ詳細を読み込みます。
  • アクティブなタスクのステータスが in_progress → フェーズ 2 のステップ 2.1。ステップ詳細を読み込みます。
    python3 ./.trellis/scripts/get_context.py --mode phase --step 2.1 --platform codex
    
  • アクティブなタスクがない → まず分類します。簡単な会話や小さなタスクの場合は、このターンで Trellis タスクを作成するかどうかだけを尋ねます。複雑な作業の場合は、Trellis タスクを作成して計画フェーズに入ってよいか尋ねます。ユーザーが拒否した場合、このセッションでは Trellis を使用しません。

スキルの振り分け(クイックリファレンス)

ユーザーの意図スキル
新機能/要件が不明確trellis-brainstorm
コードを書き始めるところtrellis-before-dev
コーディング完了/品質チェックtrellis-check
行き詰まった/同じバグを何度も修正trellis-break-loop
記録する価値のある学びがあったtrellis-update-spec

完全なルールと合理化を防ぐための表は .trellis/workflow.md にあります。

コメント