trellis-spec-bootstrap について
コードベースの実際のコードと構成に基づき、`.trellis/spec/` のガイドラインを作成・更新するスキルです。分析、文書の構成、執筆、検証までを一人の担当者が進めます。
主な機能
- 01リポジトリ構成の分析
- 02仕様書の境界決定
- 03ソースに基づくプロジェクトガイドの作成
- 04整合性の確認とプレースホルダーの除去
活用シーン
- 01初期化した Trellis リポジトリの仕様書作成
- 02リポジトリ変更後のガイド更新
- 03パッケージやレイヤーごとの文書整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ mindfold-ai/ trellis --skill trellis-spec-bootstrapインストール後、Claude Code で/trellis-spec-bootstrapを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/mcp-setup.mdrepository-analysis.mdspec-task-planning.mdspec-writing.md詳細
Trellis Spec の初期化
このスキルを使って、実際のコードベースに基づいて .trellis/spec/ のガイドラインを作成または更新します。1 人の優秀なエージェントが、リポジトリの分析、仕様の範囲の選定、ドキュメントの作成、結果の検証まで、全工程を担当します。このワークフローは、特定のホスト、CLI、エージェントのブランドに依存しません。
ワークフロー
- Trellis が初期化済みであることを確認し、現在の
.trellis/spec/ツリーを調べます。 - 利用可能な最適なツール(GitNexus、ABCoder、言語ツール、ソースの直接確認)を使って、リポジトリのアーキテクチャを分析します。
- 実際のコードベースの構造に即している場合に限り、パッケージやレイヤーごとに仕様の作業を分割します。
- プロジェクト内の具体的なパターン、ファイルパス、例、アンチパターンを用いて、仕様ファイルを補完または再構成します。
- 最終的な仕様に矛盾がなく、テンプレートのプレースホルダーが残っていないことを確認します。
参照先
| 必要な情報 | 参照先 |
|---|---|
| リポジトリのアーキテクチャ分析 | references/repository-analysis.md |
| 仕様作業の分割とタスク計画 | references/spec-task-planning.md |
| 有益な情報を含む Trellis 仕様ファイルの作成 | references/spec-writing.md |
| GitNexus と ABCoder の MCP セットアップ | references/mcp-setup.md |
運用ルール
- テンプレートは契約ではなく出発点として扱います。リポジトリの状況に応じて、仕様ファイルを削除、改名、分割、追加してください。
- 一般論よりもソースに裏付けられたルールを優先します。重要な推奨事項には、実在するファイルまたはローカルで繰り返し使われているパターンを必ず示してください。
- 原則として、実行の担当者は 1 人にします。ヘルパーエージェントは実装上の詳細にすぎず、必須でもユーザーに見える依存関係でもありません。
- 対象プロジェクトですでに標準化されている場合を除き、プラットフォーム固有の手順を書かないでください。
.trellis/spec/にプレースホルダーテキスト、空の見出し、コピーしただけの定型文を残さないでください。
完了条件
.trellis/spec/が、現在のプロジェクトの実態を記述していること。- 関連する各パッケージまたはレイヤーに、実例を含む実用的なコーディングガイダンスがあること。
- 該当しないテンプレートセクションが削除されていること。
index.mdファイルが、最終的な仕様ファイル一式と一致していること。- 必要なセットアップや分析に関する前提が、該当する仕様またはタスクのメモに記載されていること。
コメント
Markdown 対応