long · git:20261026.8d01e18 · 2026-10-26 · sha256 2a03176caabc7f6e
long git:20261026.8d01e18A
Immutable. This exact content never changes and is served at /api/v1/blob/2a03176caabc7f6e.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_upsos2gzyzwhmdvu/2a03176caabc7f6e4c61a9780c6414628687c622dd41d4ede92365b02b1e8647.json
Then /plugin install long@markdownregistry-upsos2gzyzwhmdvu in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: long description: 长程调度(/long):Epic→Sprint→Task 三层收敛,跨 Sprint plan/run 链与 checkpoint。 disable-model-invocation: true --- # long **用这个**:跨多个 Sprint 的大目标,模拟程序员「总规划 → 分 Sprint → 每 Sprint plan+run → 归档 → 下一 Sprint」。**不是那个**:单 Sprint 内连跑 → **`/plan` + `/run` 一次**(`AUTONOMOUS:true`);定时保活 → 系统 **loop** skill。 详文:`reference/hierarchy.md` · `reference/pacing-checkpoint.md` · **plan** `reference/autonomy-chain.md` ## 何时进入 - 用户 **`/long <Epic 目标>`** - 「自动规划并做到底」「长程开发」「跨天任务」「像程序员一样自己 plan run」 - **`/long resume`** — 读 `.growing/long-state.json` 续跑 - `/master` 关键词命中(见 **master** `routes.md`) **已有单 Sprint ACTIVE** 且用户只说 `/run` → **不要**拦截,走 **run**。 ## 三层收敛(硬限制) | 层 | 上限 | 载体 | |----|------|------| | Epic → Sprint | ≤5 | `long-state.json` · plan 候选表 | | Sprint → Task | ≤5 | `.growing/plan.md` | | Task 深度 | 仅 L2 | 禁止 Task 子 ID | 超限 → 合并抽象或拆多个 Epic,**禁止**加深层级。详 `reference/hierarchy.md`。 ## 流程 ### 1. Epic 立项(L0) 1. 读 `learn/` · 现有 plan 候选表 · 用户目标 2. 写/更新 `.growing/long-state.json`(schema → `reference/pacing-checkpoint.md`) 3. 拆 **≤5** 个 Sprint(各一句 Goal + 依赖),**AskQuestion** 确认(≤4 项;不可用 → 正文编号) 4. `status: active` · `active_sprint_index: 0` 用户首句已含「自动 plan 并连跑」→ 视作批准 Sprint 列表,但仍须落盘 long-state。 ### 2. Sprint 循环(L1) 对每个 `sprints[i]`,**顺序执行**: | 步 | 动作 | 入口 | |----|------|------| | a | 阶段 1:Goal · Done when · Out of scope | **plan** skill 阶段 1 | | b | 阶段 2:TASK 表 ≤5 + 执行顺序 | **plan** 阶段 2 | | c | handoff:`PLANNING:false` · `PLAN_APPROVED` · `AUTONOMOUS:true` | **plan** 阶段 3 | | d | `gate-check` OK → 实现全部 TASK | **run**(同会话连跑,勿等第二次 `/run`) | | e | Sprint 收尾:verify · archive · plan reconciliation · long-state checkpoint | **run** §Sprint 收尾 + `pacing-checkpoint.md` | | f | `active_sprint_index++`;仍有 Sprint → 回到 a;否则 Epic `completed` | | **Sprint 间**:可选 60–180s 休息或结束会话;跨天用 `/long resume` 或 `/loop`(见 `pacing-checkpoint.md`)。 ### 3. 恢复(resume) ```bash ./.cursor/bin/runner.sh gate-check ``` 1. 读 `long-state.json` + `plan.md` 2. `paused` / `MAX_LOOPS` → 向用户说明 `interrupt_reason`,确认后续 3. 当前 Sprint 未完成 → 续 **run**(ACTIVE) 4. 当前 Sprint 已闭合 → 对下一 Sprint 执行 §2a–f ## 与 plan / run / loop 分工 | 组件 | 职责 | |------|------| | **long** | Epic 外壳 · Sprint 顺序 · checkpoint · resume | | **plan** | 单 Sprint 的 Goal/TASK/handoff | | **run** | TASK 实现 · verify · commit · 单 Sprint 自治链 | | **loop**(系统) | 定时/事件唤醒;long 文档化配合,不修改其源码 | ## 决策打断 与 `workflow.json` → `autonomy.interrupt_on` 一致;另加 Epic 级: | 类型 | long 动作 | |------|-----------| | `decision_needed` | 暂停 Epic 链 · long-state `paused` + `interrupt_reason` | | `blocker` | 同左;用户 `/plan` 后 `/long resume` | | `high_risk` | 必须用户确认 | | `goal_drift` | 停 Epic · 说明偏离点 | | `release` | 交 **release** / 用户明示 | **非决策(勿停 Epic)**:Sprint 内 TASK 切换 · commit · CHANGELOG · README 门面。 ## 禁止 - 绕过 `gate-check` / `task-verify` / `PLAN_APPROVED` - 在 Task 运行中静默插入新 TASK 或新 Sprint - 修改 `run-stop` hooks 默认行为(须单独 Sprint 授权) - 把 long 做成无限任务树生成器 ## 验收(母版 Sprint) 涉及 `.cursor/skills/long/` 变更时,Sprint Done when 含: ```bash bash .cursor/bin/cursor-coherence.sh ``` Epic 全闭合:long-state `status: completed` · plan 无 Active · 候选表更新。