Converge
Use when the user wants to push all in-flight work forward toward review in one pass — closing gaps across Epics, Bugs, and orphan Tasks. NOT for single-ticket work (use engineering) or read-only triage (use my-triage). Trigger: '收斂', 'converge', '推進', '全部推到 review', '把我的單收一收', 'epic 進度', '離 merge 還多遠', '補全'.From its SKILL.md
npx -y skills add HsuanYuLee/polaris --skill convergeAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 1 command, including `post-task-reflection-checkpoint.md`.
SKILL.md
3.3 KB, 777 tokens by cl100k_base, as published. Nobody here has run it
Converge
converge 是 batch convergence orchestrator:掃描使用者名下 active work,找出離
review / merge 的 gap,提出排序後的推進計畫,經使用者確認後才逐項委派下游 skill。
Contract
converge 不是單張 ticket 施工(用 engineering),也不是 read-only dashboard(用
my-triage)。它可以路由到 breakdown、engineering、check-pr-approvals、
feature-branch-pr-gate.md,但不取代下游 skill 的 gate 或 ownership。
它屬於 mixed reader / routing orchestrator:workspace config 只用來決定 scan scope、
project set、與 reporting defaults,不得把 config read 本身升格成 stage authority。converge
可以提出 route proposal,但 proposal 不等於 workflow transition;只有下游 skill 自己的
shared gate / artifact contract 通過後,狀態才可合法前進。
若使用者指定 Epic key,只掃該 Epic 與子單;未指定 ticket 時掃 assigned active work。
Reference Loading
| Situation | Load |
|---|---|
| Any run | converge-scan-gap-flow.md, workspace-config-reader.md, shared-defaults.md, jira-story-points.md |
| PR / feature branch state | stale-approval-detection.md, feature-branch-pr-gate.md, pr-input-resolver.md |
| Execution after confirmation | converge-execution-flow.md, sub-agent-roles.md, workspace-language-policy.md |
| Report / artifacts | converge-reporting-flow.md, starlight-authoring-contract.md |
Any sub-agent dispatch must include sub-agent-roles.md Completion Envelope.
Flow
- Load workspace config and resolve global mode or Epic-only mode.
- Fetch active assigned tickets and Epic children.
- Scan GitHub PR / feature branch state using the bundled reference scripts where available.
- 分類所有 gap,依「自己可推進、離 review 最近」排序。
- 呈現 Converge Plan,等待使用者明確確認或調整。
- After confirmation, execute selected items through downstream skills.
- Rescan and produce before/after report, skipped items, blockers, and next actions.
Hard Rules
- Do not execute Phase 3 before user confirmation; batch changes need review.
- Do not modify JIRA status directly; downstream skills own status movement.
- Do not parallelize heavy
NOT_STARTEDimplementation tickets. - Do not treat
WAITING_QA/WAITING_RELEASEas gaps. - 不處理其他 assignee 的 tickets,除非使用者明確縮小或改寫範圍。
- External Slack / JIRA / PR-facing text must pass
workspace-language-policy.md. - Markdown artifacts under specs must pass
starlight-authoring-contract.md.
Completion
Return scanned counts, gap counts, selected execution list, per-ticket result, before/after gap matrix, skipped waiting items, failed/blocker items, and follow-up routes.
Post-Task Reflection (required)
Execute post-task-reflection-checkpoint.md before reporting completion.
What ships with it: 40 files
342.2 KB alongside SKILL.md, 32 of them executable
references/
scripts/
- approval-staleness.shruns2.1 KB
- check-feature-pr.shruns8.7 KB
- gate-base-check.shruns7.8 KB
- gate-pr-language.shruns6.3 KB
- gate-pr-title.shruns15.4 KB
- github-rest.shruns9.3 KB
- lib/approval-staleness.shruns2.1 KB
- lib/github-rest.shruns9.3 KB
- lib/main-checkout.shruns1.6 KB
- lib/parse_task_md.pyruns23.8 KB
- lib/pr-approval-count.shruns4.1 KB
- lib/specs-root.shruns3.7 KB
- lib/validate_dp_metadata_1.pyruns10.2 KB
- lib/validate_language_policy_1.pyruns10.0 KB
- lib/validate_specs_collection_shape_1.pyruns2.6 KB
- lib/validate_starlight_authoring_1.pyruns8.3 KB
- lib/validate_task_md_deps_1.pyruns8.3 KB
- lib/validate_task_md.pyruns76.1 KB
- lib/workspace-config-root.shruns2.2 KB
- parse-task-md.shruns228 B
- pr-action-classifier.shruns12.2 KB
- pr-review-state-classifier.shruns7.0 KB
- pr-state-snapshot.shruns20.8 KB
- resolve-pr-work-source.shruns10.2 KB
- resolve-task-md-by-branch.shruns21.4 KB
- sync-spec-sidebar-metadata.shruns9.9 KB
- validate-dp-metadata.shruns793 B
- validate-language-policy.shruns8.1 KB
- validate-specs-collection-shape.shruns4.1 KB
- validate-starlight-authoring.shruns639 B
- validate-task-md-deps.shruns3.6 KB
- validate-task-md.shruns223 B