trellis-before-dev について
実装前にタスク要件と適用されるプロジェクトガイドラインを読むよう開発者を導く Trellis スキルです。変更範囲を定め、コーディング前に準備を完了する手順を示します。
主な機能
- 01タスク資料の確認
- 02パッケージと仕様レイヤーの特定
- 03適用ガイドラインの選定
- 04共通ガイドの確認
- 05複雑な作業の変更範囲設定
活用シーン
- 01タスク実装前の準備
- 02パッケージのコーディング規約の確認
- 03複数ファイルやレイヤーにまたがる変更の範囲設定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mindfold-ai/ trellis --skill trellis-before-devインストール後、Claude Code で/trellis-before-devを入力して読み込まれたか確認します。
詳細
作業を開始する前に、関連する開発ガイドラインを確認してください。
次の手順を実行してください。
-
現在のタスク関連ファイルを確認する:
- 要件と受け入れ基準については
prd.md - 技術設計については、存在する場合は
design.md - 実行順序と検証計画については、存在する場合は
implement.md
- 要件と受け入れ基準については
-
パッケージとその仕様レイヤーを特定する:
python3 ./.trellis/scripts/get_context.py --mode packages -
次の点に基づいて、タスクに適用される仕様を特定します:
- 変更するパッケージ(例:
cli/、docs-site/) - 作業の種類(バックエンド、フロントエンド、単体テスト、ドキュメントなど)
- タスク関連ファイルで参照されている仕様や調査のパス
- 変更するパッケージ(例:
-
関連する各モジュールの仕様インデックスを確認します:
cat .trellis/spec/<package>/<layer>/index.mdインデックスの 「開発前チェックリスト」 セクションに従ってください。
-
開発前チェックリストに記載されているガイドラインファイルのうち、タスクに関連するものを確認します。インデックス自体が目的ではありません。実際のガイドラインファイル(例:
error-handling.md、conventions.md、mock-strategies.md)を参照して、コーディング規約とパターンを理解してください。 -
共通ガイドは必ず確認します:
cat .trellis/spec/guides/index.md -
重要度の高いタスクでは、コードを書く前に変更範囲を明示します。 次のいずれかに該当する場合は、重要度の高いタスクです:複数のファイルに触れる、レイヤーをまたぐ、公開インターフェースを変更する、または自分が直前に書いたものではないコードを編集する。次の点を書き出してください:
- 現在の動作と期待される動作との間にある、最小の動作上のギャップ
- その動作が実際に存在する場所(最も簡単に介入できる場所ではありません)
- 変更する予定のファイルと、それぞれが必要な理由
- このタスクでは明示的に行わないこと
- 局所的なリファクタリングが必要な場合、動作に変更がないことをどのように示すか
範囲が明確に限定された小規模な変更では、この手順は不要です。そのまま作業してください。
実際の範囲が明らかにこれより大きいと分かった場合は、作業を続ける前に、その旨と理由を伝えてください。自分の判断で変更範囲を広げてはいけません。
-
従う必要のあるコーディング規約とパターンを理解したうえで、開発計画に沿って作業を進めてください。
この手順は、コードを書く前に必ず実行してください。