xserver-mcp: Skill for Claude Code

tdd-test-scaffold

xserver-mcp で新しい MCP tool を TDD で追加するとき、RED フェーズの定型作業 ——「テストファイルを作って 3 ケース書いて MSW fixture 組んで IDN アサート入れて destructive ガード確認して」—— を 1 回のやり取りで済ませるスキル。出力は tests/tools/<domain>/<toolName>.test.ts のみ。実装 (src/) は絶対に書かない。

When to use

次のいずれかに当てはまる場面で必ず起動する:

• 新しい MCP tool を追加する (src/tools/<domain>/<tool>.ts を新設する、または tests/tools/... の新規テストファイルを書く)
• 既存ツールにケース追加 (新しい引数・エラーケース・IDN 対応・破壊的ガード追加など)
• ユーザーが「RED」「テスト雛形」「TDD スキャフォルド」「failing test 書いて」と言った
• test-writer または tdd-developer サブエージェントとして RED を書き始めた

When NOT to use

• 既存テストの refactor だけ (ファイル読み込んで直接 Edit で十分)
• src/client/ 層の変更 (transport/retry は integration テストの責務)
• docs/ / .claude/rules/ のみの変更

Pre-scaffold interview

スキャフォルド生成前に、以下を明確化する。ユーザーが既に与えていたら省略。複数不明なときは 1 回のメッセージにまとめて聞く。

1. tool 名 (camelCase) — 例: createDnsRecord, deleteMailAccountBulk, updateDnsRecord
   • ファイル名 (src/tools/<domain>/<name>.ts, tests/tools/<domain>/<name>.test.ts) はこの camelCase
   • MCP 登録名 (create_dns_record など snake_case) は tool.name プロパティで指定され、describe() のラベルもこちら
2. domain — 既存の mail / dns / server / domainVerification、または新規
3. HTTP method + endpoint path — 例: POST /v1/server/{servername}/dns, DELETE /v1/server/{servername}/mail/{mail_account}
4. ツール種別 — read (GET) / write (POST/PUT/PATCH) / destructive (DELETE) / composite (複数 primitive を内部呼び出しする高レベルツール)
5. IDN 入力を受けるか — input に domain または mail_address を持つか

不明点は endpoint を docs/xserver-openapi.json で lookup して推測できる。

Common skeleton (全パターン共通)

installFetchMock は global fetch を vi.fn() ベースのスタブに差し替える単純なモック (MSW ではない)。makeContext は apiKey: "test-key", servername: "sv.example", retry.maxAttempts: 1 の ToolContext を返す。

import { afterEach, describe, expect, it } from "vitest";
import { <toolName>Tool } from "../../../src/tools/<domain>/<toolName>.js";
import { installFetchMock } from "../../helpers/mockFetch.js";
import { makeContext } from "../../helpers/toolContext.js";

describe("<mcp_tool_name>", () => {  // snake_case — MCP 登録名と一致
  let restore: (() => void) | undefined;
  afterEach(() => restore?.());

  // 以下に 3+ ケースを書く
});