菜单
Artifact file paths, naming conventions, directory structure, and JSON output schemas for QA agents. Use when writing test case files, review reports, coverage reports, or generating execution metrics JSON. Covers the complete workflow artifact directory structure and versioning rules.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
BDD test step format standards for QA test case writing and review. Use when writing Given/When/Then test steps, applying 8-space indentation rules, structuring BDD scenarios, or validating BDD format compliance in test case documents.
Coverage matrix table formats, test pyramid analysis templates, and shift-left recommendation structures for QA coverage analysis and test case review. Use when producing AC coverage matrices, manual test case automation coverage tables, coverage gap analysis, shift-left recommendations, test pyramid analysis, or prioritized action plans.
Multi-source input handling for manual test case generation. Use when the input is NOT a Jira Story ID — covers User Stories, Business Flows/Processes, Use Cases, and REST API endpoint specifications. Covers input type detection, requirements extraction, reference ID generation, and test derivation rules for each source type.
Jira field extraction and validation rules for QA agents. Use when fetching Jira story details, extracting acceptance criteria using customfield_14400, mapping custom metadata fields, validating Story IDs, or reading Jira data for test case generation or coverage analysis.
Organizational test case document template and format enforcement rules. Use when generating manual test case files, formatting test case documents, writing coverage summaries, validating the organizational template structure, or ensuring compliance with the mandatory file format including header, individual test case blocks, feature toggle OFF test case, and coverage summary.
Test design technique reference for QA test engineers. Use when selecting, applying, or validating test design techniques including Equivalence Partitioning (EP), Boundary Value Analysis (BVA), Decision Table, State Transition, Use Case Testing, Error Guessing, Pairwise testing, and Input Field Validation. Covers when to use each technique and common misuse warnings.
| name | artifact-standards |
| description | Artifact file paths, naming conventions, directory structure, and JSON output schemas for QA agents. Use when writing test case files, review reports, coverage reports, or generating execution metrics JSON. Covers the complete workflow artifact directory structure and versioning rules. |
| user-invocable | false |
.github/agent-workflow-artifacts/<STORY-ID>/
├── manual-testcases/
│ ├── <STORY-ID>_testcases.txt ← Generated test cases (Generator)
│ ├── test_creation_summary.json ← Generator execution metrics
│ ├── <STORY-ID>_review_report.txt ← Review output (Reviewer)
│ └── test_review_summary.json ← Reviewer execution metrics
└── analysis/
├── <STORY-ID>_coverage_report.json ← Coverage analysis (Analyzer)
└── <STORY-ID>_coverage_recommendations.txt ← Shift-left action plan
| Artifact | File Name Pattern |
|---|---|
| Test cases | <STORY-ID>_testcases.txt |
| Review report | <STORY-ID>_review_report.txt |
| Coverage report | <STORY-ID>_coverage_report.json |
| Recommendations | <STORY-ID>_coverage_recommendations.txt |
| Generator summary | test_creation_summary.json |
| Reviewer summary | test_review_summary.json |
Versioning: If file already exists → append _v2, _v3 (applies to both .txt and .json files).
Every agent execution MUST capture:
| Field | Format | Capture Point |
|---|---|---|
startedAt | ISO 8601 (2025-01-15T10:30:00.000Z) | When execution begins |
completedAt | ISO 8601 | When execution ends |
duration | Human-readable (2m 34s) | Calculated from start/end |
test_creation_summary.json{
"status": "success",
"storyId": "<STORY-ID>",
"executionMetrics": {
"startedAt": "{{ISO_TIMESTAMP}}",
"completedAt": "{{ISO_TIMESTAMP}}",
"duration": "{{CALCULATED_DURATION}}",
"testCaseCount": 21,
"acCovered": 6
},
"artifacts": {
"filePath": ".github/agent-workflow-artifacts/<STORY-ID>/manual-testcases/<STORY-ID>_testcases.txt",
"fileSize": "45KB"
},
"coverage": {
"totalACs": 6,
"coveredACs": 6,
"coveragePercentage": 100
}
}
test_review_summary.json{
"status": "success",
"storyId": "<STORY-ID>",
"reviewMetrics": {
"reviewStartedAt": "{{ISO_TIMESTAMP}}",
"reviewCompletedAt": "{{ISO_TIMESTAMP}}",
"reviewDuration": "{{CALCULATED_DURATION}}",
"qualityScore": 94,
"totalTestCases": 25
},
"reviewArtifacts": {
"reviewReportPath": ".github/agent-workflow-artifacts/<STORY-ID>/manual-testcases/<STORY-ID>_review_report.txt"
}
}
<STORY-ID>_coverage_report.json{
"status": "success",
"storyId": "<STORY-ID>",
"analysisMetrics": {
"analysisStartedAt": "{{ISO_TIMESTAMP}}",
"analysisCompletedAt": "{{ISO_TIMESTAMP}}",
"analysisDuration": "{{CALCULATED_DURATION}}",
"coverageScore": 78,
"totalTestCases": 45,
"automationGaps": 12
},
"analysisArtifacts": {
"coverageReportPath": ".github/agent-workflow-artifacts/<STORY-ID>/analysis/<STORY-ID>_coverage_report.json",
"recommendationsPath": ".github/agent-workflow-artifacts/<STORY-ID>/analysis/<STORY-ID>_coverage_recommendations.txt"
}
}
.github/agent-workflow-artifacts/_v2, _v3 versioning if the file already exists — never overwrite silently