mcpField
C
cawplan-testcase-import

cawplan-testcase-import

github.com/cawcutテスト・品質1132 回インストール2 日前に更新
リポジトリ

cawplan-testcase-import について

cawplan-testcase-importは、段階的な確認とプレビューを経てTestRailにテストケースを取り込むエージェントスキルです。INLINEとREQUIREMENTのデータソースに対応し、SuiteやSectionの確認、非同期処理の引き継ぎを扱います。

主な機能

  1. 01INLINEとREQUIREMENTのデータソース
  2. 02取り込み前のSuite・Section確認
  3. 03プレビュー後の確認付き実行
  4. 04A3ケースの取り込みデータへの変換
  5. 05非同期Jobと失敗時の確認

活用シーン

  1. 01展開済みテストケースのTestRailへの取り込み
  2. 02テストポイントからRequirementを更新して取り込み
  3. 03一括取り込みのプレビューと確認
  4. 04非同期Jobの進捗確認や失敗時の副作用確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cawcut/skill-cawplan --skill cawplan-testcase-import

インストール後、Claude Code で/cawplan-testcase-importを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
import-rules.md
ux.md
scripts/
convert_generate_to_import.js

詳細

プロジェクトの README より

CawPlan TestCase Import — A1 用例导入 TestRail

cawplan skill check

硬门禁（MUST）

  1. preview-first → 框 4 执行闸 → execute --confirm；禁止跳闸。
  2. 数据源：已有展开用例 → INLINE；仅测试点 → REQUIREMENT。禁止 source.type=VERSION。
  3. Suite / Section 确认闸：mappings get 后 框 3（Suite）→ 框 3.5（Section 归属）（顺序固定）须用户确认后才可 preview / convert。禁止静默使用 default_suite_id（不做推荐标注）或静默复用/推断 parent_section_id。SUITE_NOT_IN_PROJECT/SECTION_NOT_IN_SUITE/SECTION_NOT_FOUND → 停止。同会话已确认且未换 Suite/Section → 可复用（import-rules §ConfirmState）。框 3.5 每次导入都问，仅 Intent 显式命中或 ConfirmState 复用时免弹。Version 全程无感：不弹窗、不推断确认，仅 Intent 显式命中或用例自带值才写入，否则不传（结果里注明"未指定版本"）。
  4. 用户展示：ux.md §Glossary；preview_id/job_id/UUID 默认隐藏；跟随用户主语言；Agent 自行 AskUserQuestion（不写入 allowed-tools）。
  5. TestRail 超链接：§Preview/§Result/§AsyncHandoff 中 Suite ID、Section ID、Case ID 必须可点击跳转（ux §TestRailLinks）；禁止仅裸数字 ID。
  6. 热接力：P1/P1b → 自动 INLINE，跳过框 0、框 1（ux.md §Trigger）；不跳过 Step 0.6 §StepsCheck；不跳过框 3、框 3.5（除非 ux §Intent 显式命中 Suite/Section，或 §ConfirmState 复用）；Version 无感，不涉及跳过判断。
  7. INLINE body 组装：数据来自同会话 cawplan-testcase-generate 时，禁止手写 camelCase→snake_case 转换脚本或逐条手算 source_case_key/priority——须先落一份与 A3 csv-template-mapping.md 同构的 interim JSON（camelCase，照抄字段，不做映射），框 3/3.5 确认后再用 scripts/convert_generate_to_import.js 转换为 body（import-rules.md §Convert）。convert 因个别用例 steps/expected 不合规失败时，Agent 可读取 <out>.errors.json、征得用户同意后从 interim JSON 摘除对应整条用例重跑（只删条目，不改内容值），不属于此处禁止的"手算字段"。
  8. 异步 Job（to_create > 50）：execute 成功后 禁止默认 jobs poll；须先走 ux §AsyncHandoff + 框 6。仅用户显式选「等到完成」才进入框 6b 等待循环。Job RUNNING 时 禁止 重复 execute。
  9. 失败后重试前必核实副作用：execute（同步或异步）判定失败后（已知错误码或未知错误码），禁止直接复用旧 preview_id 或立即新开 preview 重新 execute——失败可能只是批次级判定，execute 内部可能已产生真实副作用（如 Section 已建到 TestRail）。须先按 import-rules §RetrySafety 核实，再决定下一步。
  10. 步骤门禁（§StepsCheck）：Step 0.6 判定数据源是否全部为标题态（0 条已展开）。全标题 → 框 Steps-confirm（非强制停止，可选「不展开，继续导入」）；≥1 条已展开 → 无感进入 Step 1。用户未选「继续导入」且未改数据源前 禁止 mappings get / preview / execute。推荐先去 A3 展开时 仅引导话术（含 /cawplan-testcase-generate），禁止 Read cawplan-testcase-generate Skill、禁止代用户自动展开。

Reference 加载（MUST）

时机Read禁止
交互 / 路由 / Preview / 报告 / 错误 / 异步ux.md 对应 §一次性 Read 全部 references
body 字段 / 转换 / CLI / BE 缺口 / 异步 / 确认态 / 步骤门禁import-rules.md 对应 §—

禁止：直连 TestRail API、持有 TestRail Key、跳过 preview。

允许命令

用途命令
映射qa-insights testrail mappings get <product_id>
Section 查找（框 3.5 按名称查找时用）qa-insights testrail sections list <product_id> <suite_id> [--refresh]
新建 Suite（框 3「新增」分支用）qa-insights testrail suite-create <product_id> --name <name>
刷新 Requirementapi GET .../qa/requirements/<id>、.../testpoints（仅 REQUIREMENT 源）
INLINE 转换（同会话 A3 用例）node scripts/convert_generate_to_import.js <interim_json> --suite-id <n> [--version-name "x.x.x"] [-o <out.json>]
预览qa-insights testrail import preview <product_id>
执行qa-insights testrail import execute <product_id> --preview-id <id> --confirm
异步jobs get（默认，查 progress）· jobs poll（仅用户明确要求等到完成且接受长时间阻塞）

Workflow

Step动作Detail
0解析 product_id、数据源、source.typeux §Trigger · ux §Intent · import-rules §数据源
0.5缺上下文 → 框 0/1ux §Prompts
0.6§StepsCheck：全标题态 → 框 Steps-confirm；≥1 已展开 → 无感下一步import-rules §StepsCheck · ux §StepsConfirm · P1/P1b 仍须本步
1mappings get；记录 suites[]、default_suite_id、testrail_originimport-rules §Suite · ux §TestRailLinks
1.5框 3 Suite → 框 3.5 Section 归属（如选「已有」，sections list 匹配）（顺序固定；可复用 §ConfirmState）ux §SuiteConfirm · ux §SectionConfirm · 先于 convert/preview
2组装 body（INLINE + A3 → interim JSON → convert 用已确认 suite_id/parent_section_id，version_name 若命中 Intent 或用例自带则一并带上）import-rules §body · §Convert · §Section · §Version
3import preview；ux §Preview 表头含 Suite+版本；存 preview_idto_fail>0 → 框 5，停止
4框 4 执行闸（重复 Suite+版本）ux §Prompts · to_create>50 → ux §AsyncEstimate
5import execute --confirm同步 → Step 7；job_id → Step 6a
6a异步交付（默认）ux §AsyncHandoff · 框 6 · import-rules §AsyncJob
6b等到完成（可选）jobs get 循环 · ux §AsyncProgress · ux §AsyncTimeout
7导入报告ux §Result

T1 衔接：同会话 cawplan-testcase-generate → 本 Skill（INLINE）。先 Step 0.6（全标题则 Steps-confirm；用户选继续或无步骤则进 Step 1）→ 落 interim JSON → 框 3/3.5 确认 → convert_generate_to_import.js → preview。Requirement 直导（客户端无 steps）在 Step 0.6 视同全标题，走同一 Steps-confirm。

换 Suite / 换 Section 归属：用户说换 Suite/Section → 清除对应 §ConfirmState → 重走框 3（连带清 Section）或框 3.5 → 须新 preview。换版本：用户提到新版本 → 直接更新 confirmed_version_name（无需弹窗）→ 须新 preview。

异步续接：同会话「查导入状态」→ jobs get（ux §Intent）；须已存 job_id + product_id。

错误（Agent）

code处理
TESTRAIL_UNAVAILABLEux §Errors；勿重复 execute
PREVIEW_EXPIRED重新 preview（Suite/版本仍有效则复用 §ConfirmState）
SUITE_NOT_IN_PROJECTux §Errors；停止
SECTION_NOT_IN_SUITE / SECTION_NOT_FOUNDux §Errors；重走框 3.5
SUITE_CREATE_RATE_LIMITED / SUITE_MODE_NOT_SUPPORTEDux §Errors；改走框 3「已有」分支
validation / 缺 source.type自行修复；不向用户暴露
auth/403ux §Errors
UNKNOWN（Job 超时）jobs get 对账 · ux §AsyncTimeout
CONFIRMATION_REQUIRED补 --confirm
Job RUNNING（6a 后查状态）jobs get → ux §AsyncProgress；勿重复 execute
execute 返回 failed === to_create 且 failed_cases[].error 单一import-rules §Diagnosis；大概率系统性问题而非本批数据问题；先走 §RetrySafety，不引导"改数据重试"
不在本表中的未知 codeux §UnknownError；停止，不擅自重试；整理 product_id/preview_id/job_id/错误码/failed_cases 样例供用户判断是否上报

References

  • ux.md — 友好名、路由、Suite/Section 确认、版本无感规则、Preview、异步、报告、错误、未知错误兜底
  • import-rules.md — 数据源、Suite/Section/Version、ConfirmState、body、Convert、CLI、异步 Job、失败信号识别、重试前副作用核实、BE 缺口

コメント

Markdown 対応