← ClaudeAtlas

refinementlisted

Iteratively enriches incomplete JIRA Epics into estimation-ready, technically-validated specs. Five modes: batch readiness scan, RD discovery (Phase 0), PM elaboration (Phase 1), technical approach (Phase 2), and multi-round iteration. Phase 1 goes beyond checklist filling — it explores the codebase, hardens AC, and produces a structured artifact for downstream skills. Trigger: "refinement", "grooming", "討論需求", "需求釐清", "補完 Epic", "這張單缺什麼", "brainstorm", "方案討論", "想重構", "tech debt", "batch refinement", "sprint prep", or Epic with sparse content needing enrichment.
HsuanYuLee/polaris · ★ 4 · AI & Automation · score 80
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