speckit-spec-stats-runs
On-demand execution — reads verified suite command from .specify/memory/tdd-profile.md, runs it for selected specs (--all, spec id/slug, or default active feature), captures pass/fail + duration + tail, appends run record to .specify/stats/runs.json, refreshes dashboard health column
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- speckit-spec-stats-runs
- metadata
- { "author": "github-spec-kit", "source": "spec-stats:commands/speckit.spec-stats.runs.md" }
- description
- On-demand execution — reads verified suite command from .specify/memory/tdd-profile.md, runs it for selected specs (--all, spec id/slug, or default active feature), captures pass/fail + duration + tail, appends run record to .specify/stats/runs.json, refreshes dashboard health column
- compatibility
- Requires spec-kit project structure with .specify/ directory
03 SKILL.md 正文
Spec Stats — Runs
Execute the verified test suite for one or more specs and record the result.
User Input
$ARGUMENTS
Accepted forms:
- (nothing) — run for the active feature (from
.specify/feature.json) <spec><spec>… — run for the named spec directories--all— run for every spec directory--dry-run— print what would run without executing anything
Execution
node .specify/extensions/spec-stats/scripts/spec-stats.mjs runs
# or: node .specify/extensions/spec-stats/scripts/spec-stats.mjs runs --all --dry-run
# or: node .specify/extensions/spec-stats/scripts/spec-stats.mjs runs specs/003-user-auth
The engine:
- Reads the verified full-suite command from
.specify/memory/tdd-profile.md. If absent, it stops and tells the user to run/speckit.tdd.setup— it never invents a command. - Runs that command inside each selected spec directory.
- Captures pass/fail, duration (ms), and the last 5 lines of output.
- Appends a bounded record to
.specify/stats/runs.json.
This is the only Spec Stats command that executes project commands. Honors --dry-run and never mutates a spec or its tasks.
04 同仓库更多 Skills
speckit-tdd-verify
Audit TDD discipline by delegating to zfa tdd verify (mutation testing, evidence integrity); the LLM interprets the verdict and drives remediation
speckit-tdd-setup
Detect the test stack and write .specify/memory/tdd-profile.md; zuraffa-wired projects record zfa commands as the engine
speckit-tdd-run
Drive the red-green-refactor loop by delegating to zfa tdd run (deterministic engine); the LLM handles only honest stops — fixing genuine reds and remediation — never re-driving what zfa drives
speckit-tdd-plan
Derive the feature's test list by delegating to zfa tdd plan (deterministic engine); falls back to LLM-guided derivation only when zfa is unavailable
speckit-spec-stats-report
Main generator — scans all specs/*/, derives per-feature stage, task progress, health, last updated; when the TDD extension is installed, adds a deep TDD table (acceptance/unit/characterization counts, DONE, loop mode, tasks.md state); renders dashboard to configurable output path and writes .specify/stats/stats.json snapshot
speckit-spec-stats-reconcile
Reconcile tasks.md checkboxes against actual implementation — cross-references TDD test-list.md DONE behaviors and file existence to mark tasks that were implemented but never checked