refinement

Solid

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.

AI & Automation 4 stars 0 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
23
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# 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。atom ownership 邊界以 `pipeline-handoff-atom-matrix.md` 為準;SKILL 主文不複製完整 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。 - LOCK 後若下游需要改 `.claude/**`、`.codex/**`、`scripts/**` 等 framework/control-plane source,planned task 的 Allowed Files 必須精確列出這些 path;寫入時會由 `scripts/validate-framework-source-write.sh` 以 active task.md fail-closed 檢查,不接受 事後口頭補 scope。 - DP-backed sou...

Details

Author
HsuanYuLee
Repository
HsuanYuLee/polaris
Created
4 months ago
Last Updated
3 days ago
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

breakdown

Universal planning skill: Bug reads ROOT_CAUSE then estimates; Story/Task/Epic explores codebase then splits into sub-tasks with estimates, and packs each sub-task into a self-contained task.md work order for engineering to consume. Also handles scope challenge (advisory mode). Trigger: 拆單, 'split tasks', 拆解, 'breakdown', 'break down', 子單, 'sub-tasks', 評估這張單, 'evaluate this ticket', 估點, 'estimate', 'scope challenge', '挑戰需求', 'challenge scope', '需求質疑'.

4 Updated 3 days ago
HsuanYuLee
AI & Automation Solid

engineering

Engineer-minded execution orchestrator: takes a planned JIRA ticket and implements it with strict quality discipline — TDD, lint, typecheck, test, behavioral verify, PR. Two modes: first-cut (new implementation) and revision (fix PR review comments by returning to the work order). Local-only workflows may register delivery extensions, but those extensions are not part of the portable skill contract. Supports batch mode via parallel sub-agents. Trigger: "做 PROJ-123", "work on", "engineering", "開始做", "接這張", "做這張", "修 PROJ-123", "fix review on PROJ-123", PR URL (from pr-pickup or direct), or user provides JIRA ticket key(s). NOT for planning: Bug → refinement Bug source mode first; Story/Task/Epic → breakdown first. Key distinction: "下一步" / "繼續" without ticket key → my-triage (zero-input router + resume scan).

4 Updated 3 days ago
HsuanYuLee
Code & Development Listed

refine-spec

Analyze a PM feature spec and draft clarifying questions, feasibility notes, and suggested changes. Use this skill when processing a spec-refinement queue item.

0 Updated 3 days ago
tomharris