← ClaudeAtlas

test-perspectivelisted

Create, update, or deprecate Test Perspective Library (TPL) records in docs/test-perspectives/. Trigger when the user says: "テスト観点", "観点ライブラリ", "TPL", "観点を追加", "TPLを起こす", "TPLをdeprecate", "test perspective", "add TPL", "deprecate TPL", or similar phrases requesting test-perspective record maintenance.
kompiro/hane · ★ 0 · Testing & QA · score 70
Install: claude install-skill kompiro/hane
# Test Perspective (TPL) Skill 再発しうる失敗パターンを、構造化された「観点」として `docs/test-perspectives/` に蓄積・更新・deprecate する。 1 観点 = 1 ファイル。DesignDoc 作成時・新機能実装時・bug 修正時に該当 `topic` / `scope.packages` の観点が参照される状態を作るのが目的。 ## 前提条件 このスキルはホスト repo が **`docs/test-perspectives/`(TPL)を採用している場合のみ** 意味を持つ。 - ディレクトリが存在しない場合は、まず「`docs/test-perspectives/` を新設して運用を始めるか」をユーザーに確認する。始める場合は最初の 1 件をこのスキルで作成し、必要なら `docs/test-perspectives/README.md`(運用方針の入り口)と `TEMPLATE.md`(この skill ディレクトリの [`TEMPLATE.md`](TEMPLATE.md) をコピーする)も用意する - ディレクトリはあるが空 / `README.md` も `TEMPLATE.md` も無い、という状態でも動作する(既存ファイルが無ければスキャンは no-op) ## ホスト repo に依存する慣習 - **`topic` の controlled vocabulary**: ホスト repo が ADR の語彙を持つ場合(例: `docs/adr/README.md` のセクション見出し、`adr.config.json` の `topics` 等)はそれを使い、TPL と ADR で語彙を共有する。持たない場合は free-form の小文字 kebab トピックでよい - **ファイル名規約**: 既定は `docs/test-perspectives/TPL-<番号>-<slug>.md`(見出し `TPL-<番号>`、ゼロ埋めなし、GitHub 番号ベース。詳細は下記「ファイルを作成する」)。ホスト repo が独自の規約(例: 日付ベースの `TPL-YYYYMMDD-NN-<slug>.md`)を持つ場合はそちらを優先する(ADR/AT の命名と同じ「host 独自規約優先」のエスケープ) - **検証ツール**: ホスト repo が `tpl:validate`(frontmatter と一覧表の machine check)等を提供していれば、作成・更新後にそれを実行する。無ければ手動で frontmatter を確認する - **関連 TPL クエリ**: ホスト repo が `tpl:related <topic>` 等を提供していればそれで関連 TPL を一覧する。無ければ `docs/test-perspectives/` 配下の frontmatter(`topic` / `scope.packages` / `applicable_to` / `known_consumers`)を grep する - **定期 deprecation レビュー**: cadence(週次 / 月次 / 半期)と自動化(CI で review Issue を自動生成する等)はホスト repo に委ねる。このスキルは「`active` な TPL を放置しないため定期レビューを推奨」とだけ示す ## 手順 ### 1. モードの判定 ス