trellis-spec-bootstarp について
Trellis Spec Bootstarpは、実際のコードベースをもとに`.trellis/spec/`のガイドラインを作成・更新するスキルです。アーキテクチャ分析から文書化、検証までを案内し、一般的なテンプレートよりソースに裏付けられたルールを重視します。
主な機能
- 01Trellisの初期化状態と既存の仕様ツリーを確認
- 02リポジトリの構成とソースのパターンを分析
- 03実際のパッケージやレイヤーに沿って仕様を分割
- 04パス、例、アンチパターンを含むガイドを作成
- 05整合性を確認しプレースホルダーを除去
活用シーン
- 01既存コードベース向けのTrellis仕様を作成
- 02構成変更に合わせて`.trellis/spec/`を更新
- 03ガイドラインが実際のコードパターンを反映しているか確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/trellis-spec-bootstarpを入力して読み込まれたか確認します。
同梱ファイル
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 対応