跳到正文
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(原文)

安装前可以查看交给 AI 代理的指令内容。

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 / 1000 字

此表单受 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-architecture36062026年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-architecture36062026年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-architecture36062026年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-architecture36062026年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-architecture36062026年10月23日 更新

查看 puncsky 的全部技能

报告此技能的问题