| name | rapt-RAscore |
| description | RAPTor RAscore 需求分析品質評分。讀取 discovery、Gherkin、DBML、glossary、traceability 與 verify report，以 LLM-assisted rubric 產生 advisory-only RAscore、veto、scorecard 與 findings。Use when: /rapt-RAscore、需要評估 Gherkin + DBML 是否可作為 SSoT、Phase 2 後品質評分。 |
| metadata | {"user-invocable":true,"source":"project-level","skill-type":"utility"} |
RAPTor RAscore — 需求分析品質評分
先遵守 rapt-core：
- LOAD REF [rapt-core::principles.md]
- LOAD REF [rapt-core::paths-and-arguments.md]
- LOAD REF [rapt-core::ssot-definition.md]
- LOAD REF [rapt-core::phase-gates.md]
- LOAD REF [rapt-core::cic-note-policy.md]
- LOAD REF [rapt-core::traceability-schema.md]
- LOAD REF [rapt-core::rascore-feedback-policy.md]
- LOAD REF [rapt-core::encoding-policy.md]
TRIGGER
- 使用者執行
/rapt-RAscore 或明確指定本 skill。
- Phase 2（Modeling）之後，需要評估 Gherkin + DBML 是否足以作為 SSoT。
- verify 完成後，需要 advisory-only 的品質評分、scorecard 與 machine-readable findings（供 reconcile / clarify 消費）。
SKIP
.raptor/arguments.yml 不存在：EMIT 錯誤並建議先執行 /rapt-kickoff。- 尚無任何 Gherkin 或 DBML artifact：建議先執行
/rapt-behavior 或 /rapt-modeling。
- 需要驗證或修復規格本身：改用
/rapt-verify 或 /rapt-reconcile；RAscore 不修改任何 SSoT，也不作為 phase gate。
PRINCIPLE: Artifact Output Contract（只寫 RAscore reports）
PRINCIPLE: STRICT SOP
PRINCIPLE: Advisory-only（不是 phase gate）
Artifact Output Contract
| 操作 | 路徑 | 說明 |
|---|
| CREATE / UPDATE | ${paths.reports_dir}/rascore-precheck.json | 靜態預檢 evidence |
| CREATE / UPDATE | ${paths.reports_dir}/rascore-scorecard.draft.json | LLM 逐準則評分草稿 |
| CREATE / UPDATE | ${paths.reports_dir}/rascore-scorecard.yml | deterministic scorecard |
| CREATE / UPDATE | ${paths.reports_dir}/rascore-report.md | 人類可讀總報告 |
| CREATE / UPDATE | ${paths.reports_dir}/rascore-findings.md | Markdown findings |
| CREATE / UPDATE | ${paths.reports_dir}/rascore-findings.json | 機器可讀 findings，供 rapt-reconcile 使用 |
| UPDATE | .raptor/session.md | 追加 RAscore 摘要 |
| DENY | DBML / Gherkin / haARM / haAPI / haPDL | 不修改 SSoT artifact |
| DENY | generated/ | 不產生 downstream artifacts |
| DENY | .raptor/arguments.yml | 不修改 arguments schema |
SOP
步驟 0：READ arguments.yml
READ: .raptor/arguments.yml
ASSERT: 存在，否則 EMIT 錯誤「請先執行 /rapt-kickoff」並停止
ASSERT: 本 skill 為 advisory-only，不阻擋 phase gate
步驟 1：EXECUTE 01-bind-inputs/SOP.md
綁定 discovery、Gherkin、DBML、glossary、traceability 與 verify report。
步驟 2：EXECUTE 02-static-precheck/SOP.md
執行 scripts/rascore_precheck.py，產生：
- Gherkin 結構 evidence
- DBML 結構 evidence
- glossary-aware mapping evidence
- traceability L2 coverage evidence
- seed / constraint 支撐 evidence（若可掃描）
步驟 3：EXECUTE 03-rubric-scoring/SOP.md
LOAD：
- REF [rapt-RAscore::references/rascore-rubric-v01.md]
- REF [rapt-RAscore::references/rascore-llm-judge-prompt.md]
- REF [rapt-RAscore::references/rascore-finding-taxonomy.md]
- REF [rapt-RAscore::references/rascore-action-map.md]
用 LLM-assisted rubric 對 A1-G2 逐準則評分，寫入 ${paths.reports_dir}/rascore-scorecard.draft.json。
再執行 scripts/rascore_calculate.py 產生 ${paths.reports_dir}/rascore-scorecard.yml。
步驟 4：EXECUTE 04-report-rendering/SOP.md
優先執行 scripts/rascore_render.py：
RUN: python {skill_dir}/scripts/rascore_render.py \
--scorecard ${paths.reports_dir}/rascore-scorecard.yml \
--draft ${paths.reports_dir}/rascore-scorecard.draft.json \
--precheck ${paths.reports_dir}/rascore-precheck.json \
--report ${paths.reports_dir}/rascore-report.md \
--findings-md ${paths.reports_dir}/rascore-findings.md \
--findings-json ${paths.reports_dir}/rascore-findings.json
若 render script 不可用，依 references/rascore-report-schema.md 手動渲染，但必須維持欄位一致。
步驟 5：EMIT 完成摘要
RAscore 完成（advisory-only）
分數：{score.total} / 100（{score.grade}）
Veto：{triggered / 未觸發}
主要 findings：
1. {finding}
2. {finding}
3. {finding}
輸出：
- ${paths.reports_dir}/rascore-report.md
- ${paths.reports_dir}/rascore-scorecard.yml
- ${paths.reports_dir}/rascore-findings.md
- ${paths.reports_dir}/rascore-findings.json
