跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

bcc-plan-spar

BCC align+lock+review PLAN.md for one slice (no product code). Slash: /bcc-plan-spar · chat: bcc:plan-spar · "lock PLAN" · spar the plan. Args: rounds=N (auto-review cap), review=self|subagent|cli|auto|off. Grill until clear enough (no default Q&A quota). Hand off to bcc-clean-cut after human APPROVE.

bo-cao · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add bo-cao/breaking-coding-chaos --skill bcc-plan-spar

技能说明


name: bcc-plan-spar description: > BCC align+lock+review PLAN.md for one slice (no product code). Slash: /bcc-plan-spar · chat: bcc:plan-spar · "lock PLAN" · spar the plan. Args: rounds=N (auto-review cap), review=self|subagent|cli|auto|off. Grill until clear enough (no default Q&A quota). Hand off to bcc-clean-cut after human APPROVE. argument-hint: "slash: /bcc-plan-spar · chat: bcc:plan-spar · [topic] [rounds=N] [review=…]" metadata: short-description: "BCC plan align + review"

bcc-plan-spar

Job: solid coding contract for one slice —

  1. Human grill (Q&A until clear enough — no default turn quota) → clear sub-plan intent
  2. Lock PLAN.md (+ CONTEXT / ADRs)
  3. Auto review (rounds = review budget, multi-backend) → live results → main agent iterates PLAN
  4. Human final gate → APPROVE / amend / stop
  5. Hand off to bcc-clean-cut (implement — not this skill)

Deep source: grill-with-docs Act 1 (grill + domain) + Act 2 (bounded review, CLI fallback).
Formats: CONTEXT-FORMAT.md, ADR-FORMAT.md, PLAN-FORMAT.md.


Workflow preflight (required — before Phase 0/1)

Do not start grilling or rewriting PLAN.md until this check runs.
If anything is ambiguous → ask the user one clear question (with a recommended answer). Do not invent workflow state.

1. Snapshot disk (read if present)

PathAsk
plans.md / progress.md / findings.mdIs there a global endeavor map? Where are we?
PLAN.mdIs there an active coding brief? Draft or locked? Which slice?
CONTEXT.md / docs/adr/*Domain language already started?
.bcc/session.jsonActive slice / prior approve (see SESSION.md)
Chat this sessionDid user already APPROVE implement / skip align?

Echo a one-line status, e.g.:

preflight · throughline=yes|no · PLAN=missing|draft|locked|stale? · slice=? · session=… · recommend=grill|reuse-PLAN|hand-off-clean-cut|ask-user

2. Hard rule: throughline before plan-spar

CheckRequired
plans.md exists with a non-empty Goal (and preferably a hardpoint map)Yes

If missing or empty:

  1. Do not start Phase 1 grill for a multi-step endeavor.
  2. Tell user: “bcc-plan-spar runs only after throughline. Run /bcc-throughline first (or Mode A /bcc-breaking-coding-chaos).”
  3. Offer to load bcc-throughline now.

Exception: user explicitly says one-off micro task and refuses a cockpit — then ask once to confirm; if they insist, proceed but still create a minimal plans.md Goal line when possible (preferred) rather than silent skip.

3. Is bcc-plan-spar the right skill right now?

SituationSuitable?Do this
No usable throughline (plans.md)Nobcc-throughline first (hard rule above)
User wants status / reprioritize onlyNobcc-throughline or main skill status
User wants code now and PLAN locked + APPROVEDNobcc-clean-cut
User wants code now but PLAN missing / draftYesAlign/lock here (after throughline OK)
User names a hardpoint on the mapYesProceed; update single root PLAN.md in place for that work
Existing PLAN.md is for previous workYesOverwrite/refresh PLAN.md for the new hardpoint (global history stays in throughline trio — not in PLAN)
Trivial one-liner / pure discussionUsually noSkip or ask

No formal state machine. Infer from docs + chat; suggest next step if wrong skill.

4. Ask the user when uncertain

One question + recommended default:

  1. Throughline missing — create now?
  2. Which hardpoint on the map?
  3. Refresh PLAN.md for this hardpoint (yes)?
  4. Align vs code (plan-spar vs clean-cut)?

5. After preflight OK → Phase 0

Only then: scope hardpoint, then Phase 1 grill / lock.


Tunables

Parse from invocation (e.g. /bcc-plan-spar auth rounds=3 review=auto):

ArgDefaultMeaning
rounds / MAX_REVIEW_ROUNDS3Only budgeted loop: auto-review rounds after PLAN is locked. Set at spar start. 0 = skip auto review (human gate still required).
reviewauto when rounds>0, else offReview backend (see below)
PLAN_FILEPLAN.mdCoding brief path
LOG_FILEPLAN-REVIEW-LOG.mdAppend-only live review transcript

Not a tunable by default: Phase 1 human Q&A has no default turn quota. Grill until the agent judges clear enough (or the human locks / stops).
Optional override only if the user explicitly passes grill_rounds=N / MAX_GRILL_ROUNDS=N — treat as a soft safety ceiling, not a target to fill. Do not invent or announce a default grill cap.

review modes (simplified)

ModeWho reviewsWhen to use
autosubagent if spawn works; else self. If user set review=cli and a CLI exists, may use CLIDefault
subagentFresh reviewer subagent (read-only) — preferred isolationStronger critique vs builder
selfSame agent, critic stance onlyAlways available 保底
cliOptional local CLI (e.g. codex exec -s read-only if installed)User opts in; fallback to self on failure
offSkip auto reviewHuman gate only after lock

Do not require multi-agent products or cross-org setups. One host + optional subagent/CLI is enough.

Echo once before Act 1 (grill has no round count):

bcc-plan-spar · topic=… · review_rounds=3 · review=auto · PLAN_FILE=PLAN.md · LOG_FILE=PLAN-REVIEW-LOG.md


Flow (fixed order)

Preflight  Workflow fitness (throughline? PLAN? right skill?) — ask if unsure
Phase 0    Scope slice (+ read thro
阅读完整来源 ↗