Test Bridge
Testing & Qualitytest-bridgeTest 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) のテスト実行・型チェック・テスト記述ガイド
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- 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, normalizeToolResultContentclaude-process.ts— parseRule, matchesSessionRule, buildSessionRule, toolNeedsApproval, ACCEPT_EDITS_AUTO_APPROVEimage-store.ts— ImageStore.extractImagePaths
新しいテスト追加時
- export されている純粋関数があればテスト追加を検討
- internal関数をテストしたい場合は
exportに変更する (テスト可能性のための export は OK) - テスト追加後は型チェックが通ること (
npx tsc --noEmit) も確認