verify-and-coverage
将规格转换为可执行测试(verify.md)并分析覆盖率的工作流程。以Runme.dev格式编写E2E/集成测试。使用场景:(1) 从规格书(spec.md等)创建可执行测试文档时(2) 分析和可视化测试覆盖率时(3) 不使用“verify.md创建”、“覆盖率检查”、“测试文档化”请求时:仅需要单元测试,现有测试框架已足够。
📖 中文导读:将规格转换为可执行测试(verify.md)并分析覆盖率的工作流程。以Runme.dev格式编写E2E/集成测试。使用场景:(1) 从规格书(spec.md等)创建可执行测试文档时(2) 分析和可视化测试覆盖率时(3) 不使用“verify.md创建”、“覆盖率检查”、“测试文档化”请求时:仅需要单元测试,现有测试框架已足够。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: verify-and-coverage description: | 仕様を実行可能テスト(verify.md)に変換し、カバレッジを分析するワークフロー。Runme.dev形式でE2E/統合テストを記述。 使用タイミング: (1) 仕様書(spec.md等)から実行可能なテストドキュメントを作成したい場合 (2) テストカバレッジを分析・可視化したい場合 (3) 「verify.md作成」「カバレッジチェック」「テスト文書化」リクエスト 使用しない場合: ユニットテストのみ必要な場合、既存テストフレームワークで十分な場合 allowed-tools: Read, Bash(runme:), Bash(curl:), Bash(git:*)
実行可能テスト & カバレッジ管理
目的
仕様書(spec.md等)を実行可能なテストドキュメント(verify.md)に変換し、要件カバレッジを管理します。
コンセプト
- verify.md: Runme.dev形式の実行可能テストドキュメント
- coverage.md: 仕様とテストのマッピング・ギャップ分析
ワークフロー
1. verify.md作成
仕様のシナリオを実行可能なテストケースに変換します。
2. カバレッジチェック
仕様の各要件がテストでカバーされているか分析します。
テンプレート
- verify.md: templates/verify-template.md
- README.md: templates/README-template.md
- coverage.md: templates/coverage-template.md
詳細ガイド
Runme.dev統合
verify.mdはRunme.devで直接実行可能です:
# テスト一覧を確認
runme list --filename verify.md
# 特定のテストを実行(<prefix>はchange-idに置き換え)
runme run <prefix>-test-create-resource --filename verify.md
# 全テストを一括実行
runme run --all --filename verify.md
注意: コマンド名はプロジェクト内でユニークである必要があります。<prefix>にはchange-idまたは機能名を使用してください。
テストピラミッドにおける位置づけ
verify.md(統合テスト)は以下をカバーします:
- End-to-Endフロー(UI/CLI → API → DB)
- 外部リソース依存(実際のDB接続、ファイルI/O)
- 複数コンポーネント結合
原則: 可能な限りユニットテストで検証し、外部依存や結合コストが高いものだけverify.mdで確認します。