본문으로 건너뛰기
cccskills
무료GitHub에 공개

loopx

Work through a `.pm` workstream backlog one actionable item at a time. Triage pending milestones, tasks, and inbox notes, then implement and ship them, close items already satisfied, block work with an unblock condition, or remove invalid items until no actionable work remains.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

Autonomously drain a `.pm` workstream item by item — triage every pending milestone, task, and inbox note, then implement and ship it, close it as already done, block it with an unblock condition, or delete it as invalid, and keep going until nothing actionable remains. Use when the user explicitly invokes /loopx or asks to loop, drain, or work through a whole workstream's backlog (e.g. `/loopx w1`). Sequential, not interval-based; not for timed polls, a single task, or ordinary edits.

puncsky/system-design-and-architecture스타 3,606(GitHub 3,606 + cccskills 0)

실행 점수 미검증

설치 방법 보기

이럴 때 유용합니다

  • Draining a workstream backlog
  • Reviewing pending milestones and tasks
  • Resolving open inbox notes

포함된 파일(1)

  • SKILL.md5.6 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Task: Drain a .pm workstream item by item

Usage: /loopx <wN>

Repeatedly pick the next actionable pending item in workstream <wN> (a pending milestone, a pending task in a live milestone, or an open inbox note), triage it, act, /ship it, and continue until nothing actionable remains. Every item ends in exactly one place: implemented and shipped, closed as already done, moved to blocked/ with an unblock condition, or deleted as invalid. Composes /pm (only writer to .pm/), your own writing work, and /ship. If you can name the next pick, keep looping — don't pause for a checkpoint or ask the user to re-run.

A pending item is a claim that the work is still wanted and undone. Boards go stale; never start on the strength of a checkbox alone.

If $ARGUMENTS is empty, STOP and ask which workstream.

Preconditions (once)

  1. git branch --show-current is main; else STOP and ask.
  2. git status — pre-existing uncommitted changes you didn't make (other than ignorable .DS_Store) must not ride along; surface and ask.
  3. .pm/<wN>/README.md exists; else STOP.
  4. Read .pm/DO_NOT_DO.md; a conflict is a delete reason.

(There is no stop-hook guard in this repo; the Exit rules below are the only enforcement.)

The loop

1. Pick

List .pm/<wN>/m*/, *.md, done/, blocked/. Checkbox and disk must agree; if not, trust task files and repair via /pm. Order: (1) lowest-numbered actionable pending milestone, its tasks in depends_on order; (2) lowest-numbered open inbox note; (3) a blocked item whose unblock condition now verifiably holds (/pm unblock). Honor depends_on; scan all later items before concluding none are actionable. Announce the pick. Nothing actionable → Exit.

2. Triage (before writing)

Read the item fully. Establish what is true on main with evidence: git log and grep the cited paths, check whether the chapter/file already exists in en/ and zh-CN/, run the DoD checks. Announce outcome + evidence:

OutcomeWhenAction
Work on itstill wanted, acceptance not yet trueone-line plan → step 3
Close as already doneacceptance already holds (incl. both languages, indexes, checks)/pm done; ship board move alone: chore(pm): close <target> — already satisfied by <SHA>
Block itwanted but can't proceed: needs author/user decision, missing source material, unavailable tooling (e.g. no calibre for PDF build), unverifiable claim/pm block <target> <reason> with Unblock:; ship alone: chore(pm): block <target> — …
Delete as invalidconflicts with DO_NOT_DO.md, superseded/duplicate, or targets removed content/pm drop <target> <reason>; ship alone: chore(pm): drop <target> — …

User-routed/approved items you merely doubt are blocked, never deleted. Closing tasks (Reader surface, Simplify, Verification) are real work.

3. Implement

Do the writing/editing following AGENTS.md:

  • Both languages: en/ and zh-CN/ change together; identical filenames; slug/id equal filename; only title/tags translated; never renumber.
  • New chapter → also README.md, SUMMARY.md, zh-CN/README.md.
  • Cross-refs use https://tianpan.co/notes/<slug>; local images in images/ as ../images/<file>; diagrams via the mermaid skill.
  • Checks before shipping: front-matter/parity check (diff <(ls en) <(ls zh-CN), slug==filename), no broken relative links, make build when gitbook/calibre exist (otherwise say it was not run).
  • Don't fabricate facts, numbers, or references; verify or cite.
  • Keep board in sync with /pm done <target> per finished item — never hand-edit board state.

4. Ship

Invoke /ship for this item (content + .pm/ moves together, or board move alone). One board outcome per ship; never batch items. Never ship red — run checks as their own command and read the result before committing.

5. Continue

Re-scan immediately and pick again. Between items write one sentence: what shipped and what's next. Long queue / long session / several ships is not an exit.

Handling a block

Report item, blocker, and unblock; don't stop while independent work remains. Preserve partial work (stash or branch) — don't ship half-work. Block individual tasks in place when only some are stuck; block the milestone when all open tasks are. Skip dependents of blocked work automatically. Don't retry an unchanged blocker.

Exit

Only when: Done (nothing pending), Blocked (all remaining items blocked or depend on blocked work), or Hard stop (user interrupt/runtime limit/lost push access). Final report: shipped items with SHAs, closed-with-evidence, blocked-with-conditions-and-owners, deleted-with-reasons (and any proposed DO_NOT_DO.md entry), and for a hard stop the next actionable pick.

Guardrails

  • Triage before writing; every item ends somewhere; one outcome per ship.
  • /pm owns .pm/. Doubt is a block, not a delete.
  • The board is public: no secrets or private references anywhere, including commit messages.
  • Stay in <wN>. Report honestly: skipped checks, partial work, closes-by-triage.

Arguments

$ARGUMENTS

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Answer questions about a book, its chapters, or system design by consulting relevant material without changing files. For repository questions, ground the response in the source and cite file paths and lines; use web search for general topics when freshness matters.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Asking about a book or chapter
  • Getting an explanation of system design
  • Checking repository material without edits
puncsky/system-design-and-architecture3.6천2026년 10월 23일 업데이트

mermaid

무료

Create concise Mermaid architecture diagrams from a chapter, system, component, dependency flow, or supplied description. The skill checks the diagram syntax before presenting the diagram and a brief explanation of its key flow.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Diagramming a system or its components
  • Showing dependency and call directions
  • Turning a chapter topic into a diagram
puncsky/system-design-and-architecture3.6천2026년 10월 23일 업데이트

pm

무료

Manage and inspect a book project's public work board: organize workstreams, notes, milestones, and tasks, and update their status as work changes. Use it to materialize proposals, track blockers, or check current board state.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Check open milestones, tasks, and blockers
  • Add a roadmap note or milestone to the board
  • Mark completed or blocked work
puncsky/system-design-and-architecture3.6천2026년 10월 23일 업데이트

Break down a book roadmap topic into prioritized milestone and task proposals, considering reader impact, scope, dependencies, and effort. The skill outputs text for a separate board workflow to apply; it does not write board files.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Turn a book improvement idea into milestone proposals
  • Prioritize roadmap work by reader impact
  • Break a goal into sized tasks with dependencies
puncsky/system-design-and-architecture3.6천2026년 10월 23일 업데이트

ship

무료

Prepare pending changes on the tracked working branch for publishing: check the branch and repository state, rebase on the latest origin changes, commit selected files, and push. It is intended for an explicit ship or publish request.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Publish finished changes from the current branch
  • Commit and push selected pending files
  • Update the branch with origin before shipping
puncsky/system-design-and-architecture3.6천2026년 10월 23일 업데이트

puncsky의 스킬 모두 보기

이 스킬의 문제 신고