mcpField
R
rs-shared

rs-shared

github.com/rootspec開発057 回インストール27 週間前に更新
リポジトリ

rs-shared について

rs-sharedはRootSpecのスキルで共有するリソース集で、単独での呼び出しは想定されていません。プロジェクトや仕様のスキャン、検証、初期化、実装、テストを支援するスクリプトと、フレームワークファイルや参考資料を含みます。

主な機能

  1. 01プロジェクト・仕様のスキャンスクリプト
  2. 026項目の仕様検証
  3. 03初期化とアップグレードの支援
  4. 04実装とCypressテストの補助
  5. 05共有フレームワークファイルと参考資料

活用シーン

  1. 01プロジェクトのフレームワークや設定を調査
  2. 02仕様の構造とカバレッジを検証
  3. 03初期化やフレームワーク更新を準備
  4. 04Cypressテスト結果を生成・報告

インストール

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

$npx skills add https://github.com/rootspec/rootspec --skill rs-shared

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

同梱ファイル

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

00.AXIOMS.md
00.FRAMEWORK.md
README.md
cypress/
rootspec-reporter.ts
fragments/
anti-patterns.md
conventions.md
framework-rules.md
interview-protocol.md
l5-test-dsl.md
l5-yaml-format.md
prerequisites.md
test-runner-contract.md
scripts/
assess.sh
bootstrap-init.sh
build-tests-status.sh
check-app-ready.sh
check-coverage.sh
check-duplicate-ids.sh
check-hierarchy.sh
check-numerics.sh
check-pillar-quality.sh
check-tradeoffs.sh
check-vacuous-assertions.sh
compare-test-runs.sh
compute-spec-hash.sh
detect-prerequisites.sh
detect-stack.sh
dev.sh
filter-stories.sh
gap-analysis.sh

詳細

このスキルには、すべての RootSpec スキルで共有するリソースが含まれています。直接呼び出さないでください。

スキル

スキル目的モード
/rs-initプロジェクトを初期化します — ディレクトリ、基本ファイル、前提条件対話型
/rs-spec仕様を作成または更新します — インタビュー＋検証ループ対話型（スキップ可能）
/rs-impl仕様に基づいて実装します — テスト駆動、自律型非対話型
/rs-validateテストを実行して結果を報告します非対話型
/rs-updateプロジェクトを最新のフレームワークバージョンにアップグレードします対話型

スクリプト

プロジェクトのスキャン
  • scripts/scan-spec.sh — 仕様ディレクトリを特定し、見つかったファイルと不足しているファイルを一覧表示して、バージョンを検出します
  • scripts/scan-project.sh — フレームワーク、ソースディレクトリ、設定ファイルを検出します
仕様の検証
  • scripts/validate-spec.sh — 6 つの検証チェックをすべて 1 回の呼び出しで実行します（階層、数値、重複 ID、柱の品質、トレードオフ、カバレッジ）
  • scripts/check-hierarchy.sh — 仕様レベル間の下位参照を検出します
  • scripts/check-numerics.sh — L1-L4 のハードコードされた数値を検出します
  • scripts/check-duplicate-ids.sh — L5 の重複するストーリー ID を検出します
  • scripts/check-pillar-quality.sh — L1 の柱の数と形式を確認します
  • scripts/check-tradeoffs.sh — L2 に明示的なトレードオフの記述があるか確認します
  • scripts/check-coverage.sh — L4 のシステムを L5 のストーリーと相互参照します
  • scripts/compute-spec-hash.sh — すべての仕様ファイルの決定的なハッシュを計算します
初期化とアップグレード
  • scripts/detect-prerequisites.sh — 開発サーバー、フック、リリース／テストスクリプトを検出します
  • scripts/verify-init.sh — 期待される初期化ファイルがすべて存在するか確認します
  • scripts/gap-analysis.sh — プロジェクトのバージョンを同梱されたフレームワークのバージョンと比較します
実装のサポート
  • scripts/assess.sh — rs-impl に必要な情報（仕様、プロジェクト、ストーリー、規約、フラグメント）を 1 回の呼び出しでまとめて読み込みます
  • scripts/scaffold-cypress.sh — Cypress のインフラストラクチャファイル一式（設定、サポート、DSL、レポーター）を 1 回の呼び出しで作成します
  • scripts/generate-test-file.sh — 仕様 YAML から Cypress テストファイルを作成します（loadAndRun パターンでストーリーを埋め込みます）
  • scripts/init-conventions.sh — package.json、tsconfig、Tailwind の設定、ソースコードから規約を抽出します
  • scripts/generate-test-report.sh — tests-status.json を解析して、合格／不合格／未テストの形式付きレポートを生成します
ストーリーとテスト
  • scripts/filter-stories.sh — ID、システム、優先度、ステータスで L5 のストーリーを絞り込みます
  • scripts/parse-cypress-results.sh — Cypress の JSON 出力を解析し、ストーリー／基準ごとの結果を取得します
  • scripts/build-tests-status.sh — テスト結果を tests-status.json に統合します
  • scripts/compare-test-runs.sh — 2 回のテスト実行を比較し、リグレッション／修正を報告します

同梱ファイル

  • 00.AXIOMS.md — 基盤となる信念（rs-init によってユーザープロジェクトにコピーされます）
  • 00.FRAMEWORK.md — フレームワークの定義（rs-init によってユーザープロジェクトにコピーされます）

フラグメント

  • fragments/framework-rules.md — 参照階層とプレースホルダーのルール
  • fragments/interview-protocol.md — インタビューの方法論
  • fragments/anti-patterns.md — レベルごとの一般的なアンチパターン
  • fragments/prerequisites.md — 前提条件の検出と作成
  • fragments/l5-yaml-format.md — ユーザーストーリーとファインチューニングの YAML 構文
  • fragments/l5-test-dsl.md — テスト DSL のステップリファレンスと拡張機能

コメント

Markdown 対応