mcpField
T
trellis-spec-bootstrap

trellis-spec-bootstrap

github.com/mindfold-ai開発15.0k104 回インストール4 週間前に更新
リポジトリ

trellis-spec-bootstrap について

コードベースの実際のコードと構成に基づき、`.trellis/spec/` のガイドラインを作成・更新するスキルです。分析、文書の構成、執筆、検証までを一人の担当者が進めます。

主な機能

  1. 01リポジトリ構成の分析
  2. 02仕様書の境界決定
  3. 03ソースに基づくプロジェクトガイドの作成
  4. 04整合性の確認とプレースホルダーの除去

活用シーン

  1. 01初期化した Trellis リポジトリの仕様書作成
  2. 02リポジトリ変更後のガイド更新
  3. 03パッケージやレイヤーごとの文書整理

インストール

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

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

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
mcp-setup.md
repository-analysis.md
spec-task-planning.md
spec-writing.md

詳細

Trellis Spec の初期化

このスキルを使って、実際のコードベースに基づいて .trellis/spec/ のガイドラインを作成または更新します。1 人の優秀なエージェントが、リポジトリの分析、仕様の範囲の選定、ドキュメントの作成、結果の検証まで、全工程を担当します。このワークフローは、特定のホスト、CLI、エージェントのブランドに依存しません。

ワークフロー

  1. Trellis が初期化済みであることを確認し、現在の .trellis/spec/ ツリーを調べます。
  2. 利用可能な最適なツール(GitNexus、ABCoder、言語ツール、ソースの直接確認)を使って、リポジトリのアーキテクチャを分析します。
  3. 実際のコードベースの構造に即している場合に限り、パッケージやレイヤーごとに仕様の作業を分割します。
  4. プロジェクト内の具体的なパターン、ファイルパス、例、アンチパターンを用いて、仕様ファイルを補完または再構成します。
  5. 最終的な仕様に矛盾がなく、テンプレートのプレースホルダーが残っていないことを確認します。

参照先

必要な情報参照先
リポジトリのアーキテクチャ分析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 ファイルが、最終的な仕様ファイル一式と一致していること。
  • 必要なセットアップや分析に関する前提が、該当する仕様またはタスクのメモに記載されていること。

コメント