사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/longcipher/pb-spec --skill pb-refine시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
pb-refine
Apply feedback to an existing spec. This closes the gap between one-shot planning and iterative refinement.
Workflow
1. Locate and load the spec
- List
specs/, find the directory ending with-<feature-name>; on multiple matches take the latest date prefix; on no match, report and stop (/pb-planfirst). - Load
design.md,tasks.md,AGENTS.md(read-only).
2. Apply feedback to design.md
- If behavior changes, update the
TDD & Mutation Testing Strategysection first (type contracts, invariants, test matrix, mutation scope). - Precise edits only — never rewrite whole files, preserve unaffected sections verbatim.
- Update
Status→Revised, add a## Revision Historytable entry (| Date | Change | Reason |).
3. Cascade to tasks.md
- Reset invalidated tasks:
🔄 DCR→🔴 TODO, checkboxes back to- [ ]. - Add new tasks with the next free Task ID; obsolete tasks →
⛔ OBSOLETE. - Update
Context,Verification,Test Coveragewhere affected. - Never modify completed tasks (
🟢 DONE) unless explicitly requested; if a change invalidates them, flag as a warning instead.
4. Validate and report
- Check alignment: every design change has tasks, dependencies stay ordered, no orphaned tasks.
- Run
uv run pb-spec validate --plan <spec-dir>and fix errors. - Summarize: what changed in design.md / tasks.md, warnings, and next step (
/pb-build <feature>).
Decision protocol
Apply given feedback as stated — no multi-turn probing. If the feedback admits two or more genuinely incomparable interpretations that change what gets built, ask the user and wait; otherwise adopt the most reasonable interpretation, record it in Revision History, and proceed.
Edge cases
- No feedback provided → report "No feedback detected."
- Feedback requires an entirely new design → recommend
/pb-planinstead. - Multiple conflicting feedback items → apply in order given, note conflicts in Revision History.
Constraints
- Only modify
specs/<spec-dir>/design.mdandtasks.md. Never source code.AGENTS.mdis read-only. - Incremental update only — never re-run the full planning process.
