hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-issue
hyper-issue
VerifiedUse this skill when the user wants a confirmed finding or a piece of decided work recorded as an implementation-ready issue, wants a fixed batch of open issues selected and grouped into disjoint work lanes, or names issue numbers such as `#1~3` to run as a batch. It investigates only enough to make the issue self-contained, writes the issue in English for a fresh agent with a machine-readable scope block, produces a batch manifest, and hands the lanes to the hyper orchestrator when work should follow. Do not use for implementing the work itself, for general documentation, or for a plan file.
| File | Kind | Size |
|---|---|---|
| SKILL.ko.md | markdown | 18.0 KB |
| SKILL.md | skill md | 16.5 KB |
| assets/evals/hyper-issue-cases.jsonl | other | 12.6 KB |
| references/batch-manifest.ko.md | markdown | 4.2 KB |
| references/batch-manifest.md | markdown | 3.9 KB |
| references/issue-body-template.ko.md | markdown | 4.2 KB |
| references/issue-body-template.md | markdown | 4.1 KB |
| rules/batch-selection.ko.md | markdown | 7.7 KB |
| rules/batch-selection.md | markdown | 7.1 KB |
| rules/issue-contract.ko.md | markdown | 7.9 KB |
| rules/issue-contract.md | markdown | 7.4 KB |
references/batch-manifest.ko.md
View on GitHub# Batch Manifest
`.hyper/issues/<slug>/batch.md`를 쓰기 전에 이 참고 파일을 사용한다. 명세 형식, 레인 표, 핸드오프 줄을 소유한다.
## Contents
- 형식
- 규칙
- 레인 분할 예
## 형식
```markdown
# Batch: <slug>
- 생성 일시: YYYY-MM-DD HH:MM
- 저장소: <owner/repo>
- 질의: `<그대로의 질의>` | 번호: `<적힌 그대로의 번호>` -> <전개한 목록>
- 수집: <반환 행 수> / 총계 <total> | 페이지 <n>개 | 잘림 없음 (번호 모드: 남김 <k> / 지목 <n>)
- 대상 브랜치: <base branch>
- 레인 상한: <n>
- 차단: <none | 차단 요인, 줄마다 하나>
## Issue 목록
| # | 이슈 | 제목 | 분류 | 크기 | 레인 | 순서 | verify |
|---|---|---|---|---|---|---|---|
| 1 | #12 | <제목> | bug | s | orders-idempotency | 1 | `bun test src/api/orders.test.ts` |
| 2 | #14 | <제목> | task | m | docs-parity | 1 | `bash scripts/check.sh` |
## Lane 표
| Lane | 이슈 순서 | 쓰는 경로 | 근거 |
|---|---|---|---|
| orders-idempotency | #12 | src/api/orders.ts, src/api/orders.test.ts | 1 |
| docs-parity | #14 | skills/**/*.md | 1 |
## 그래프
- 간선: #12 -> #14 (직접 선언 아님, `touches` 겹침 아님, 선언 순서만)
- 순환: <none | 순환 경로>
## 공백과 차단
- <이슈> - `hyper:` 블록 없음, `## Scope`에서 재도출함
- <이슈> - `size: l`, 배정 전 분할 필요
- #<n> - 제외: <pull request | closed | not found | read failed>
## 핸드오프
- 배치 명세: `.hyper/issues/<slug>/batch.md`
- 이슈 <n>건, 레인 <m>개, 차단 <k>건
- 다음 단계는 이 파일을 고정 입력으로 읽는다. 목록을 바꾸지 않는다.
- 다음 단계: hyper (넘김, YYYY-MM-DD HH:MM) | 없음 (<--no-run | --from-hyper | 실행 가능한 레인 없음>)
```
## 규칙
- `## Issue 목록`의 순서는 선택 시점의 정규 순서다. 나중에 다시 정렬하지 않는다.
- `## Lane 표`는 레인별 쓰는 경로의 합집합을 적어, 레인이 서로 겹치지 않음을 한눈에 확인하게 한다.
- 이슈가 하나뿐인 레인도 적는다. 레인은 병렬성이 아니라 쓰기 집합이다.
- `## 그래프`는 간선과 그 출처를 적는다. 직접 선언, 겹침 도출, 순서만.
- `## 공백과 차단`은 모든 이슈에 파싱 가능한 블록이 있고, 분할이 필요 없었고, 뺀 번호가 없었던 경우가 아니면 비어 있지 않다. 그런 경우에도 `none`을 명시한다.
- 핸드오프 줄의 개수는 표에서 읽어 센다. 추정하지 않는다.
- `대상 브랜치`에는 사용자가 납품 대상으로 지목한 브랜치만 적는다. 지목이 없으면 `미정 (사용자 지정 없음)`으로 적는다. 배치는 기준 브랜치를 지어내지 않는다. 통합 기준은 계획 단계가 정하고, 푸시 여부는 사용자의 납품 단어가 정한다.
## 레인 분할 예
이슈 세 개가 들어온다.
- `#21`은 `src/api/a.ts`와 `src/api/a.test.ts`를 쓴다. `size: s`
- `#22`는 `src/api/a.ts`를 쓴다. `depends_on: [21]`
- `#23`은 `docs/api.md`를 쓴다.
결과: `#21`과 `#22`가 경로를 공유하므로 의존 순서의 한 레인이 된다(`21` 다음 `22`). `#23`은 자기 레인이다. 레인 두 개가 동시에 돌 수 있고, 두 레인이 같은 경로를 쓰지 않는다.
`src/api/a.ts`와 `docs/api.md`를 모두 쓰는 `#24`가 추가되면 `21`/`22` 레인에 합류하고, `#23`은 그 뒤로 밀린 합쳐진 레인에 들어간다. 쓰기 집합을 겹치지 않게 유지하려면 레인을 합치는 것 외에 방법이 없기 때문이다.
## Sources
> 확인 2026-11-07.
| Claim | Source |
|---|---|
| 정규 목록 고정, 레인별 순서, 다음 단계가 그대로 읽는 명세 | [kdy1-scripts slop-fix-batch](https://github.com/kdy1/kdy1-scripts) |
| 서로 겹치지 않는 쓰기 집합이라는 레인 규칙과, 공유 파일이 레인을 하나로 강제하는 점 | [automazeio/ccpm](https://github.com/automazeio/ccpm) |
| 동시 에이전트 변경 사이의 충돌률이 분리 이유라는 근거 | [AI Agent PRs on GitHub](https://arxiv.org/abs/2607.04697) |
### 근거 등급
`LOCAL` - 명세 형식과 레인 표는 이 패키지의 설계이고, 고정 규칙은 위 선행 사례를 각색했다.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 197k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |