refinementlisted
Install: claude install-skill HsuanYuLee/polaris
# Refinement — Architect
`refinement` 是 Architect:把模糊需求變成經技術驗證、可估點、可拆工的藍圖。它擁有
Goal / Background / Decisions / Blind Spots / AC / Technical Approach;不拆子單、不估點、
不寫 code。下游 `breakdown` 才負責 work orders。
## Mandatory Contracts
- 所有 source 先用 `spec-source-resolver.md` 解析;source-mode 細節(DP container path、
JIRA-backed container path、LOCKED scope guard)讀 `refinement-source-mode.md`。
- 開始產生 preview、`refinement.md`、`refinement.json`、JIRA comment draft 或任何
downstream-facing prose 前,先讀 `workspace-config-reader.md`、
`workspace-language-policy.md` 與 `authoring-preflight.md`;root `language` 是起稿語言,
不是送出前翻譯步驟。
- 寫 artifact 前必讀 `pipeline-handoff.md` § Artifact Schemas,再讀
`refinement-artifact.md` / `task-md-schema.md` 等對應 artifact-specific schema。
- Phase 1 / Phase 2 發現 AC、Verify Command、repo script、project handbook 或特定 ticket
需要 framework root toolchain 之外的 CLI / package / local binary 時,必須寫入
`refinement.json` 的 `tool_requirements[]`。工單級或 `runtime_profile=ticket` 的工具只做
downstream handoff,`goes_to_mise=false`,不得建議放進 root `mise.toml`。
- Framework contract change 預設走 DP / ticketless refinement proposal;未經使用者確認
不直接改 skill / rule / reference / validator。
- DP-backed source 沒有特殊施工捷徑;`refinement` 完成後仍必須走與 Epic 相同的正規鏈:
`breakdown -> engineering -> (verify-AC when verification work order / AC artifact exists)`,
Polaris-specific `framework-release` 只能作為 engineering 之後的 local extension tail。
- breakdown → refinement 回流只讀 `refinement-inbox/*.md`;禁止直接讀 engineering raw
sidecar,schem