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
- License 许可
- MIT
- 所属仓库
- arrrrny/gym
- 最近更新
- 2026-11-11
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- speckit-spec-stats-report
- metadata
- { "author": "github-spec-kit", "source": "spec-stats:commands/speckit.spec-stats.report.md" }
- description
- 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
- compatibility
- Requires spec-kit project structure with .specify/ directory
03 SKILL.md 正文
Spec Stats — Report
Generate the spec portfolio dashboard for the current project.
User Input
$ARGUMENTS
Optional flags:
--json— print the machine-readablestats.jsonto stdout (no files written)--out <path>— write the markdown dashboard to this path (overrides configoutput_path)--render --in <stats.json>— render an existing snapshot instead of re-scanning
Execution
Run the bundled Node engine from the repository root:
node .specify/extensions/spec-stats/scripts/spec-stats.mjs report
# or: node .specify/extensions/spec-stats/scripts/spec-stats.mjs report --json
# or: node .specify/extensions/spec-stats/scripts/spec-stats.mjs report --out /tmp/stats.md
The engine:
- Lists every
specs/<NNN>-<slug>/directory. - Detects each feature's stage (
specified → planned → tasked → implementing → complete) from file presence andtasks.mdcheckbox counts. - Detects whether the TDD extension is installed in this project (
.specify/memory/tdd-profile.mdor.specify/extensions/tdd). When installed, it reads each feature'stdd/test-list.mdand renders the TDD Deep Stats table with columns:#,feature,A(acceptance behaviors),U(unit behaviors),char(characterization behaviors),DONE(behaviors inDONEstate),loop(full/outer-only/inside-out/absent), andtasks.md(updatedwhen TDD markers are present, elseabsent), plus a totals row. - Writes the dashboard to
output_path(default.specify/stats/SPEC-STATS.md) and astats.jsonsnapshot beside it.
Report the output path (or the JSON) back to the user. This command is read-only — it never modifies specs, tasks, or code.
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-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
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