AGENT SKILL

subagent-driven-development

Use when executing implementation plans with independent tasks in the current session. Dispatches a fresh subagent per task with two-stage review (spec compliance, then code quality).

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
subagent-driven-development
description
Use when executing implementation plans with independent tasks in the current session. Dispatches a fresh subagent per task with two-stage review (spec compliance, then code quality).

03 SKILL.md 正文

Subagent-Driven Development

Execute a plan by dispatching fresh subagents per task, with two-stage review after each.

Core principle: Fresh subagent per task + two-stage review (spec then quality) = high quality, fast iteration.

Continuous execution: Do not pause to check in between tasks. Execute all tasks without stopping. The only reasons to stop: BLOCKED status you cannot resolve, genuine ambiguity, or all tasks complete.

Process

Step 0: Setup

  • Read plan file once; extract ALL tasks with full text and context
  • Create TodoWrite with all tasks
  • Verify git worktree isolation is configured

Per Task:

  1. Dispatch implementer subagent with full task text + relevant context
  2. If implementer asks questions → answer, re-dispatch
  3. Implementer implements, tests, commits, self-reviews
  4. Dispatch spec compliance reviewer — confirms code matches spec
  5. If spec issues → implementer fixes, reviewer re-reviews (loop)
  6. Dispatch code quality reviewer — confirms quality standards met
  7. If quality issues → implementer fixes, reviewer re-reviews (loop)
  8. Mark task complete in TodoWrite

After All Tasks:

  • Dispatch final code reviewer for entire implementation
  • Use finishing-a-development-branch skill

Implementer Status Handling

Status Action
DONE Proceed to spec compliance review
DONE_WITH_CONCERNS Read concerns, address if correctness/scope issues
NEEDS_CONTEXT Provide missing context, re-dispatch
BLOCKED Assess: context problem → more context; reasoning → higher model; too large → break up; wrong plan → escalate

Model Selection

Select the lowest tier that can handle the task:

Scope Claude Code OpenAI Google
1-2 files, clear spec claude-haiku-4-5 gpt-4.1-mini gemini-2.0-flash-lite
Multi-file, integration concerns claude-sonnet-4-6 gpt-4.1 gemini-2.5-flash
Design judgment, broad codebase claude-opus-4-8 o3 / gpt-5.5 gemini-2.5-pro

Review Order (Critical)

Spec compliance MUST be ✅ before starting code quality review. Never skip either review stage.

Red Flags — Never Do

  • Start on main/master branch without explicit user consent
  • Skip either review stage
  • Dispatch multiple implementation subagents in parallel (file conflicts)
  • Make subagent read plan file (provide full text instead)
  • Accept "close enough" on spec compliance
  • Ignore subagent questions before they start work

Integration

Uses: writing-plans (creates the plan), finishing-a-development-branch (completes work) Subagents use: test-driven-development, code-review patterns

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k