KamiJeong/tech-bridge-book / .agents/skills/speckit-auto
speckit-auto
VerifiedOrchestrate the Codex Spec Kit sub-agent workflow with mandatory token observability.
Spec Kit Auto Workflow
Default mode is gated. Before starting a full workflow, check token-analyzer
availability with .agents/skills/speckit-guards/scripts/guard-token-analyzer-available.sh.
GitHub Issue Trigger Mode
When a GitHub issue has the trigger:speckit-auto and agent:codex labels, or
when its title, body, or comment contains $speckit-auto, treat the issue as an
instruction to run this skill for Codex-only work. Use the issue body as the
feature request and inspect linked comments, checklists, and sub-issues before
starting. /speckit-auto is reserved for Claude issue routing and MUST NOT be
claimed by the Codex issue runner unless the issue also has the agent:codex
label or explicitly contains $speckit-auto.
This trigger does not override normal safety gates. Follow the requested mode
from the issue when present; otherwise use gated. Treat issue template choices
that say "plan first" or "wait for approval" as gated, choices that say "safe,
low-risk changes" as auto-implement, and choices that say "one draft pull
request" as auto-pr. Also treat Korean choices that say "먼저 계획", "승인한
뒤" as gated, "안전하고 작은 변경" as auto-implement, and "검토용 요청서
하나" as auto-pr.
Implementation is allowed only when the issue explicitly requests
auto-implement, auto-pr, or when the user has already approved
implementation in the current conversation. auto-commit and auto-pr are
supported terminal actions, but they still require explicit permission before
Codex commits, pushes, or opens a PR. Stacked PR publication is currently not
supported; use a single draft PR instead.
Use GitHub issue labels as live workflow state:
- Add
trigger:speckit-autoandagent:codexwhen taking the issue. - Add exactly one
mode:*label when the mode is known. - Add
status:in-progresswhen work starts. - Move the active
phase:*label after every completed phase. - Use
status:needs-clarificationwhen a required decision is missing. - Use
status:blockedwhen a stop condition is hit. - Use
status:waiting-reviewafter implementation and review evidence are ready. - Use
status:doneonly after the requested terminal action is complete. - Use
status:failedwhen the workflow cannot continue because validation or a required external operation failed.
Sub-Agent Execution
Run workflow phases through the existing project-scoped Codex sub-agents whenever the phase maps to a dedicated role. Use the role that matches the phase:
speckit-slicer: intake and slicingspeckit-scheduler: schedulingspeckit-specifier: specifyspeckit-clarifier: clarifyspeckit-checklister: checklistspeckit-planner: planspeckit-tasker: tasksspeckit-analyzer: analyzespeckit-implementer: implementspeckit-reviewer: reviewspeckit-integrator: integrationspeckit-token-reporter: token reportingspeckit-committer: commitspeckit-pr-creator: PR creation
Only keep work local when a stop condition, missing agent definition, or runtime limitation prevents safe delegation. When delegation is unavailable, record that limitation in the issue comment and continue only if the requested mode allows it.
Always add an issue comment before starting a phase and after completing a phase. Also add a short comment before any terminal action such as commit, push, or PR creation. Comments should state what Codex is doing, which files or artifacts are in scope, which label changed, and any gate result. Keep comments short and factual.
If the issue is too broad or Codex determines sub-issues are needed, create
sub-issues only in the same GitHub repository. Link them from the parent issue,
label the parent with status:needs-sub-issues and relationship:parent, label
each child with relationship:sub-issue, trigger:speckit-auto, agent:codex,
and the relevant type:*, priority:*, risk:*, and mode:* labels. Add a
parent issue comment explaining the split and the execution order.
Use the GitHub app tools when available for labels, comments, issue creation,
and issue inspection. Use gh only as a fallback when the app tools cannot
perform the needed operation.
Orchestration Order
- intake
- slicing
- scheduling
- per-slice Spec Kit workflow
- implementation
- review
- integration
- token reporting
- commit
- PR creation
After every completed phase, record token usage using token-analyzer when
available or .agents/skills/speckit-guards/scripts/record-token-step.sh when a
phase is custom or unsupported. Token reporting is mandatory before commit or
PR creation.
Intake And Slicing
Accept the feature request and determine whether it should be split before running specify. Treat the request as a slicing candidate when it spans multiple independent deliverables, shared contracts, or more than one implementation area, unless the user or workflow explicitly overrides the decision.
Intake artifacts should capture:
- original request summary
- target epic slug
- proposed slice ids
- explicit overrides
- assumptions
- token run label
Scheduling
For sliced work, build:
- dependency graph
- conflict matrix
- execution plan
- selected strategy
Allowed strategies are single-spec, sequential,
foundation-first-then-parallel, parallel-safe, and stop-and-ask. Use
stop-and-ask when dependency, file, contract, configuration, or repository-state
conflicts are unclear.
Per-Slice Workflow
For each approved slice, run:
- specify
- clarify
- checklist
- plan
- tasks
- analyze
- implement
- review
In plan-only, stop after analyze and token reporting. In gated, ask before
implementation, commit, and PR. In auto-implement, implement only when analyze
passes and the slice is low risk. In auto-commit, validate, token-report, and
commit only when explicit permission is present. In auto-pr, implement,
validate, token-report, commit, push, and create a draft PR only when explicitly
requested.
Integration
After multiple slices are implemented, check cross-slice file conflicts, shared contract drift, integration risks, and merge readiness. Record token analysis for integration.
Commit
Commit only after review and validation pass. Use conventional commits by
default. Commit only intended files, never secrets, and include token-analysis
artifacts only when they belong to the current run. auto-commit is an explicit
permission flag, not a standalone mode, and may be used to authorize the commit
step of an auto-pr run.
Draft PR
Use GitHub CLI. Create draft PRs by default. Never push directly from main,
master, or develop. Include changed files, spec, plan, tasks, tests, risks,
reviewer notes, and token summary. Print PR URLs after creation.
Create exactly one draft PR for the completed workflow. If the work has multiple slices, integrate the completed slices before creating that single draft PR.
Required PR section:
## Token Analysis
- Run label:
- Token report:
- Total tokens:
- Most expensive phase:
- Missing token data:
- Token budget status:
- Notes:
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |