Skip to content
cccskills
FreePublished on GitHub

Test Naming and Structure

Ensure tests use clear naming and cover edge cases with proper describe/it structure.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Pattern declaration

Primary pattern: Reviewer Secondary patterns: Inversion Why: テスト命名・構造チェックはチェックリスト型評価が主だが、テストファイルが差分に含まれない場合は実行を止める必要がある。

Rule / ルール

  • describe/it/test の命名を一貫させ、期待される振る舞いを明示する
  • 正常系だけでなく境界・異常系もテストする
  • テストデータの重複を避け、セットアップは共通化する

Heuristics

  • it('works') のような曖昧な名前
  • 異常系テストや境界値が欠落
  • 重複したモックデータやセットアップコード

Good / Bad Examples

  • Good: it('returns 422 when payload is invalid')
  • Bad: it('should work')
  • Good: 境界値・例外ケースを含む複数の it ブロック

Actions / 改善案

  • 期待されるステータスや値を含む名前に変更する
  • エラーケース・境界値のテストを追加する
  • beforeEach/ヘルパーでセットアップを共通化する

Non-goals / 扱わないこと

  • テストフレームワークの選定や移行。
  • テストケース自体の追加・削除の大規模再設計。
  • 実装コードの命名改善。

Pre-execution Gate / 実行前ゲート

このスキルは以下の条件がすべて満たされない限りNO_REVIEWを返す。

  • 差分にテストファイル(*.test.*, *.spec.*)の変更が含まれている
  • 差分にテストの命名・構造に影響する変更がある(コメントやフォーマットのみの変更ではない)
  • inputContextにdiffが含まれている

ゲート不成立時の出力: NO_REVIEW: test-naming — テスト命名・構造チェックの対象となるテスト変更が検出されない

False-positive guards / 抑制条件

  • 既存の命名規約に沿った変更であり、差分で逸脱がない。
  • テストが自動生成され、命名規約が別途管理されている。

評価指標(Evaluation)

  • 合格基準: 指摘が差分に紐づき、根拠と次アクションが説明されている。
  • 不合格基準: 差分と無関係な指摘、根拠のない断定、抑制条件の無視。

人間に返す条件(Human Handoff)

  • 仕様や意図が不明確で解釈が分かれる場合は質問として返す。
  • 影響範囲が広い設計判断やトレードオフは人間レビューへ返す。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

<What this skill does>

The English summary is being prepared. Showing the original description.

s977043/river-review7Updated Oct 23, 2026

画像・ボタン・フォーム要素に適切なアクセシブルネームがあるか確認する。

The English summary is being prepared. Showing the original description.

s977043/river-review7Updated Oct 23, 2026

Ensure ADRs capture context, decision, alternatives, tradeoffs, and follow-ups in a way that prevents future drift.

The English summary is being prepared. Showing the original description.

s977043/river-review7Updated Oct 23, 2026

敵対的分析手法を統合したレビューの entry skill。認知バイアス対策の3手法 (Pre-mortem / War Game / Logic Torturing)と、宣言・主張と実態の乖離を突く claim-vs-actual 検出3パターン(Self-Contradiction / Refactor-Claim Audit / Cross-File Leakage)へルーティングし、通常のレビューでは見えない設計の盲点・ 防御の穴・論理の弱点・宣言と実装のズレを可視化する。

The English summary is being prepared. Showing the original description.

s977043/river-review7Updated Oct 23, 2026

Review changes to the Agent Skills import/export bridge for path safety, round-trip fidelity, and validation correctness.

The English summary is being prepared. Showing the original description.

s977043/river-review7Updated Oct 23, 2026

Checks whether AI-assisted work defines review criteria, accessible context, explicit review loop, human judgment boundary, and feedback capture before delegating to an agent.

The English summary is being prepared. Showing the original description.

s977043/river-review7Updated Oct 23, 2026

See all skills by s977043

Report a problem with this skill