charted-green について
実装済みコードのある TODO テストを一つずつ有効化し、各テストの合格に必要な変更だけを行うテスト用スキルです。指定された設計ドキュメントの進捗も更新し、テストが通った時点で停止します。
主な機能
- 01設計ドキュメントを唯一の基準として使用
- 02実装済みテストを一つずつ有効化
- 03現在のテストに必要な変更だけを実施
- 04指定された進捗チェックボックスを更新
- 05変更ごとにテストを実行
活用シーン
- 01テストファイルの TODO を段階的に実装
- 02現在のテストに実装範囲を限定
- 03設計ドキュメントで完了作業を記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ marmicode/ skills --skill charted-greenインストール後、Claude Code で/charted-greenを入力して読み込まれたか確認します。
詳細
コンテキスト
- designDocPath: $ARGUMENTS[0]
- testFilePath: $ARGUMENTS[1]
目標
${designDocPath} の設計ドキュメントを唯一の信頼できる情報源として、${testFilePath} のテストを段階的に有効化します。
手順
${testFilePath}の各テストを次のように分類します。
- 実装済みのテスト:実際のテストコードを含むテスト(空またはコメントのみではないもの)
- 空のテスト:空、またはコメントのみのテスト — 完全に無視してください
- 実装済みの各テストについて、
it.todo(...)をit(...)に変更します。ただし、必ず一度に1つのテストだけを変更し、そのテストが成功するために必要な最小限の実装のみを行ってください。それ以上は行わないでください。
現在のテストに直接関係のないものは、何も実装しないでください。
-
現在のテストが成功したら、
${designDocPath}の進捗を更新します(下記の「設計ドキュメントの進捗」を参照)。 -
これらのテストが成功したら終了します。
-
実装済みの項目が完了し、安全に使用できる場合は、その項目の作業中を示す JSDoc(@deprecated 🚧 work in progress)を削除します。
設計ドキュメントの進捗
各テストが成功するたびに、${designDocPath} を更新して完了した作業を反映します。
🚧 を ✅ に、- [ ] を - [x] に変更します。設計ドキュメントのそれ以外のテキスト、見出し、図、構成は編集しないでください。
次のセクション内の項目のみチェックしてください。
- PR's Testing Strategy — 有効化したテストに一致する
### 🚧 {test_title}見出し。 - PR's Tasks — 作業が完了し、成功したテストで検証済みの
- [ ] ...taslk description...項目すべて。 - PR Plan — PR のすべてのタスクとテスト戦略の項目にチェックが付いた場合の
## 🚧 {pr_title}項目。
Implementation Details の項目が完了しているか判断できない場合は、チェックを付けないでください。
ルール
空のテストは実装しないでください。
テストは絶対に実装しないでください。
他の手段をすべて試した後の最終手段としてのみ、テストを編集してください。
設計ドキュメントの編集は、チェックボックスの変更、または 🚧 から ✅ への置き換えのみです。${designDocPath} の内容を言い換えたり、並べ替えたり、追加・削除したりしないでください。
変更を加えるたびにテストを実行してください。現在のテストが成功した場合にのみ、次のテストに進んでください。
利用可能な場合は Wallaby Skill を使ってテストを実行してください。利用できない場合は、プロジェクトで推奨されている方法でテストを実行してください。