qa
Skill0 starsChanged 6 months agoMITView on GitHub
[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.
In this repository16 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- acceptance-testSkill
- commitSkill
- dependabotSkill
- design-docSkill
- initSkill
- open-prSkill
- pick-issueSkill
- review-docsSkill
- security-alertSkill
- shipSkill
- start-devSkill
- sync-docsSkill
- sync-worktreesSkill
- test-perspectiveSkill
- triage-statusSkill
The file
Files
QA Checklist Skill
⚠️ Deprecated (Retire level — see ADR-55). Superseded by the
qasubagent (fills test gaps from a PR diff) and theacceptance-testskill (owns AT records). The trigger phrases were removed fromdescriptionand model invocation is disabled (ADR-103), 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 では節ごと省略)。
# 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節そのものを出さない - チェックリスト生成後、ユーザーにファイルを開いて確認するよう促す
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

