# QA

> [Deprecated] Retired — superseded by the `qa` subagent (fills test gaps from a PR diff) and the `acceptance-test` skill (owns AT records). No longer triggered; the body is kept for provenance. See docs/adr/55-skill-deprecation-convention.md.

- Skill: `kompiro/qa` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kompiro/qa`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kompiro/qa/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kompiro (https://skillmd.com/u/kompiro)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kompiro/qa

---


# QA Checklist Skill

> **⚠️ Deprecated (Retire level — see [ADR-55](../../docs/adr/55-skill-deprecation-convention.md)).**
> Superseded by the **`qa` subagent** (fills test gaps from a PR diff) and the
> **`acceptance-test`** skill (owns AT records). The trigger phrases were removed from
> `description` so this no longer competes with the subagent; the body below is kept for
> provenance only.

`docs/acceptance/` 内の受け入れテスト記録を読み込み、自動検証を実行しつつ手動確認項目をまとめたチェックリストを生成する。

## 手順

### 1. AT ファイルの収集

`docs/acceptance/*.md` を全件読み込む。

フロントマターの `type` フィールドを確認し、`type: product` または `type` フィールドなしのファイルのみを対象とする。
`type: tool` のファイルはスキップする。`type` 区分を採用していない repo では全 AT を対象として扱う。

### 2. 自動検証コマンドの実行

各 AT ファイルの bash コードブロック（` ```bash ` で囲まれた部分）を抽出し、
リポジトリルートで実行する。同じコマンドが複数の AT に登場する場合は1回だけ実行する。

実行結果（成功/失敗）と、テスト件数などの出力サマリーを記録する。

### 3. 手動確認項目の収集

各 AT ファイルから未チェックの `- [ ]` 項目を抽出し、AT ファイルごとにグループ化する。
すでにチェック済みの `- [x]` 項目は含めない。

AT ファイルのセクション見出しには、元の AT ファイルへのリンクを付ける。
リンクパスはリポジトリルートからの相対パス（例: `docs/acceptance/0006-builtin-style-and-reference.md`）を使用する。

### 4. TPL カバレッジヒントの収集（ホスト repo が `docs/test-perspectives/` を採用している場合のみ。ディレクトリが無ければ本ステップをスキップする）

あくまで**ヒント**を集めるステップ。完全な Fit/Gap 分析（TPL チェックリスト項目 × test/AT の網羅 matrix）はホスト repo 側の別ワークフローに委ねる。

- 収集した対象 AT の `**Related TPLs**:` メタ欄から、すでに引用されている TPL の集合を作る
- `docs/test-perspectives/` の `active` な TPL のうち、対象 AT の `type` / 対象モジュールに `scope.packages` / `topic` / `applicable_to` が重なるのに **どの対象 AT からも引用されていない** ものを「未引用 TPL」として挙げる。ホスト repo が `tpl:related <topic>` 等を提供していればそれで候補を絞る
- 引用済みの **proactive** TPL（`discovered_from` が原則ファイル / ADR を指すもの）について、そのチェックリスト項目が対象 AT の AC に転記されているかを軽く突き合わせ、明らかな転記漏れがあれば挙げる（"forward 運用" の取りこぼし検出）
- 何も挙がらなければ「該当なし」とする

### 5. チェックリストの生成

以下の形式で `docs/qa/YYYY-MM-DD-checklist.md` を生成する（今日の日付を使用）。
`docs/qa/` ディレクトリが存在しない場合は作成する。
`## TPL Coverage Hints` 節はステップ4を実行した場合のみ出力する（`docs/test-perspectives/` 不在 repo では節ごと省略）。

```markdown
# QA Checklist — YYYY-MM-DD

## Automated Checks

- [x] <build command> (AT-0001, AT-0006)
- [x] <test command> — 230 tests passed (AT-0001, AT-0006)
- [x] <lint command> (AT-0006)
- [x] <format:check command> (AT-0006)

## TPL Coverage Hints

（`docs/test-perspectives/` を採用する repo のみ。ヒントが無ければ「該当なし」）

- 未引用 TPL: [TPL-XXXXXXXX-XX](docs/test-perspectives/TPL-XXXXXXXX-XX-slug.md) — 観点のタイトル（対象 AT: AT-NN が `topic`/`scope` 上関連しうるが未引用）
- 転記漏れの可能性: TPL-XXXXXXXX-YY のチェックリスト項目「…」が AT-NN の AC に見当たらない

## Manual Checks

手動確認が必要な項目です。アプリを起動して順番に確認してください。

### [AT-0006: Built-in Style & Reference Panel](docs/acceptance/0006-builtin-style-and-reference.md)

#### AC-1: ビルトインスタイルの適用（Phase 1）

##### AC-1.1: ユーザースタイルなしでもデフォルト描画される

- [ ] Memory モードでアプリを開き、サンプル KRS が正しく描画されることを確認
- [ ] user ノードが人型シェイプ（`shape: user`）で表示される
...

---
*Generated by /qa skill — do not commit this file*
```

### 6. 結果の報告

生成したファイルのパスをユーザーに伝える。
手動確認が必要な項目数と、自動検証の結果（全件成功 or 失敗件数）をサマリーとして表示する。
自動検証が失敗した場合は、その旨を強調して伝える。
TPL カバレッジヒントを出力した場合は、未引用 TPL / 転記漏れの件数も併せて伝える。

## 出力先

- `docs/qa/YYYY-MM-DD-checklist.md`（git には追加しない、`.gitignore` 対象）

## 注意事項

- 自動検証コマンドはリポジトリルートで実行する（worktree 内で作業している場合はその worktree ルートで実行）
- コマンドの実行に時間がかかる場合（テストランナーやビルド）はユーザーに進捗を伝える
- 手動確認項目がゼロの場合は「手動確認項目なし」と明記する
- TPL カバレッジヒントは追加情報であり、`docs/test-perspectives/` の有無にかかわらず Automated Checks / Manual Checks の既存出力は一切変えない（no regression）。`docs/test-perspectives/` が無ければ `## TPL Coverage Hints` 節そのものを出さない
- チェックリスト生成後、ユーザーにファイルを開いて確認するよう促す