Compatibility alias for dev-grill-docs spec-only mode. Assists dev-grill-docs by running its spec-only path. Use only when the user explicitly says dev-spec, asks to preserve an old dev-spec workflow, or explicitly wants spec-only output without CONTEXT.md / ADR updates. For natural requirement-alignment requests such as 先帮我梳理需求, 帮我设计, 写个方案, spec 一下, 设计文档, design this, or scope this out, prefer dev-grill-docs. Do not maintain a separate workflow here: load dev-grill-docs and follow it with --spe
SkillScore55Maintained
Automatic
◆Coding pack
Last verified 8/15/2026
What it changes
Passed 10 of 18 test cases with the skill, and 2 of 18 without it.
Without skill14%
With skill55%
Checks it passed that the model alone missed
The assigned artifact status is STUCK
The artifact path is .claude/artifacts/designs/webhooks.md
The invocation is interpreted as dev-grill-docs --spec-only
and 9 more in the full report
10 fixed2 passed either way9 still failing1 broke
Pass-rate lift
+41 pp
Tokens
-29%
Agent turns
0%
Response time
-49%
Model gemini-3.6-flashMeasured 8/15/2026v112 of 22 cases passed with skill · 18 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 10 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 10
Prompt
Where exactly should the generated design artifact file be placed when invoking dev-spec for a feature named webhooks?
What was checked, without and with the skill
Checked
Without skill
With skill
The artifact path is .claude/artifacts/designs/webhooks.md
Missed
Passed
case-22 · gemini-3.6-flash · 8/15/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md83 lines2 files
Dev Spec
dev-spec is a compatibility alias for dev-grill-docs --spec-only.
Use it when the user explicitly asks for dev-spec, wants old dev-spec compatibility, or explicitly asks for spec-only output without CONTEXT.md / ADR writes. For ordinary requirement alignment, prefer dev-grill-docs. Do not run a separate interview protocol from this file.
Trigger routing
Trigger phrases include:
dev-spec
旧 dev-spec 流程
dev-spec --spec-only
只要 spec
spec-only
Do not capture these generic requirement-intake phrases here; route them to dev-grill-docs:
spec 一下
设计文档
帮我设计
写个方案
这个需求要怎么做
design this
scope this out
Behavior:
Load ../dev-grill-docs/SKILL.md.
Follow the dev-grill-docs workflow with --spec-only.
Produce .claude/artifacts/designs/<feature>.md.
Do not update CONTEXT.md or docs/adr/ unless the user explicitly asks to update persistent docs too.
Output goes to .claude/artifacts/designs/<feature>.md.