OpenParable
Skip to content
← Back to skills

Test Bridge

Testing & Quality
test-bridge

Test Bridge is an Agent Skill for testing & quality published in the K9i-0/ccpocket repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Bridge Server (TypeScript) のテスト実行・型チェック・テスト記述ガイド

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/K9i-0/ccpocket/blob/HEAD/.claude/skills/test-bridge/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/test-bridge, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Bridge Server テスト

実行手順

以下を順番に実行し、全てパスすることを確認する。

1. ユニットテスト

npm run test:bridge

特定ファイルのみ:

cd packages/bridge && npx vitest run src/<filename>.test.ts

ウォッチモード (開発中):

cd packages/bridge && npx vitest src/<filename>.test.ts

2. TypeScript 型チェック

npx tsc --noEmit -p packages/bridge/tsconfig.json

テストファイル (*.test.ts) と vitest.config.ts は tsconfig.json の exclude に入っているため、型チェック対象外。

3. カバレッジ (任意)

npm run test:bridge:coverage

テスト記述規約

ファイル配置・命名

  • テストファイルはソースと同じディレクトリに <module>.test.ts として配置
    • 例: src/parser.ts → src/parser.test.ts
  • vitest.config.ts の include パターン: src/**/*.test.ts

import

import { describe, it, expect } from "vitest";
  • vitest からのみ import する (jest の互換 API は使わない)
  • テスト対象モジュールは .js 拡張子で import する (NodeNext moduleResolution)
    • 例: import { parseRule } from "./claude-process.js";

テスト構造

describe("関数名 or クラス名", () => {
  it("動作の説明 (英語)", () => {
    expect(actual).toBe(expected);
  });
});
  • describe でテスト対象の関数/クラス単位にグルーピング
  • it の説明は英語で、三人称現在形 ("returns null for empty string")
  • 1つの it で1つの振る舞いを検証する

テスト対象の方針

  • 純粋関数・ロジック中心にテストする (高ROI)
  • プロセスspawn, ファイルシステム, WebSocket等の外部依存は対象外
  • 現在テスト対象のモジュール:
    • parser.ts — parseClaudeEvent, claudeEventToServerMessage, parseClientMessage, normalizeToolResultContent
    • claude-process.ts — parseRule, matchesSessionRule, buildSessionRule, toolNeedsApproval, ACCEPT_EDITS_AUTO_APPROVE
    • image-store.ts — ImageStore.extractImagePaths

新しいテスト追加時

  1. export されている純粋関数があればテスト追加を検討
  2. internal関数をテストしたい場合は export に変更する (テスト可能性のための export は OK)
  3. テスト追加後は型チェックが通ること (npx tsc --noEmit) も確認