القائمة
Spec-driven development workflow for projects that use spec files as both product spec and manual. Use when writing specs, implementing tasks from specs, or updating docs after code changes.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
ALWAYS invoke this skill when user asks to add, create, or track a task — including indirect requests like "make a task for X", "add a task for this", "we need a task to...". Never add tasks manually by editing spec files. Handles full workflow — collect requirements, pick or create the spec, propose text, get approval, save, assign ID, commit.
Use this skill for task format reference and existing-task interactions in .md files — read, edit, rewrite, list, find, filter, summarize, or check status. For adding, creating, or writing a new backlog task, use mdtask-add.
Work one project task end to end — pick, plan, review, execute, review code, update the spec, commit
استنادا إلى تصنيف SOC المهني
| name | sdd |
| description | Spec-driven development workflow for projects that use spec files as both product spec and manual. Use when writing specs, implementing tasks from specs, or updating docs after code changes. |
| disable-model-invocation | false |
No code without a spec. The spec is both the blueprint for the work and the manual for the result.
docs/specs/*.md)[x] and add **Implemented:** bullets inside the task body# Tasks based on what was implementedEach spec file has two parts:
# Tasks; story groups under it use ## headingsThe feature description is the manual. A reader should understand what's available and how to use it without reading the tasks.
Imagine building a smart kettle app.
We start by creating a spec file with tasks. No code yet, just the spec:
# Brewing — Smart Kettle
Wi-Fi kettle with app control.
# Tasks
- [ ] KTL-001 Basic boiling with auto shut-off
Basic boiling makes the kettle useful before advanced presets exist.
Heat to 100°C, beep on completion.
Physical button and app trigger.
Auto shut-off after timeout.
- [ ] KTL-002 Tea presets
Tea presets save users from remembering common brewing temperatures.
Predefined temperature + steep time for common tea types.
Allow user-created custom presets.
- [ ] KTL-003 Schedule boiling
Scheduling makes hot water ready for planned routines.
Set a time for the kettle to start automatically.
Morning routine: wake up to ready water.
No feature description yet — nothing is built.
We implement boiling. After the task is done, two things happen:
[x] with an **Implemented:** block# Tasks# Brewing — Smart Kettle
Wi-Fi kettle with app control.
## Boiling
Tap "Boil" in the app or press the physical button. Heats water to 100°C,
beeps when done. Auto shut-off after 5 minutes.
# Tasks
- [x] KTL-001 Basic boiling with auto shut-off
Basic boiling makes the kettle useful before advanced presets exist.
Heat to 100°C, beep on completion.
Physical button and app trigger.
Auto shut-off after timeout.
**Implemented:**
- Heats to 100°C with ±1° accuracy
- Dual trigger: hardware button and app "Boil" command
- Auto shut-off after 5 minutes of inactivity
- [ ] KTL-002 Tea presets
Tea presets save users from remembering common brewing temperatures.
...
- [ ] KTL-003 Schedule boiling
Scheduling makes hot water ready for planned routines.
...
Tea presets is a different feature — it gets its own section:
# Brewing — Smart Kettle
Wi-Fi kettle with app control.
## Boiling
Tap "Boil" in the app or press the physical button. Heats water to 100°C,
beeps when done. Auto shut-off after 5 minutes.
## Tea presets
Three built-in presets:
- Green tea — 75°C, 2 min steep reminder
- Black tea — 95°C, 4 min steep reminder
- Herbal — 100°C, 6 min steep reminder
Custom presets: Settings → Presets → Add. Set temperature (40–100°C)
and steep time (1–15 min).
# Tasks
- [x] KTL-001 Basic boiling with auto shut-off
Basic boiling makes the kettle useful before advanced presets exist.
...
- [x] KTL-002 Tea presets
Tea presets save users from remembering common brewing temperatures.
Predefined temperature + steep time for common tea types.
Allow user-created custom presets.
**Implemented:**
- Three built-in presets (green, black, herbal)
- Custom presets via Settings → Presets → Add
- Temperature range 40–100°C, steep time 1–15 min
- [ ] KTL-003 Schedule boiling
Scheduling makes hot water ready for planned routines.
...
KTL-003 is still open — no "Scheduling" section yet. It will appear when the task is done.
## Boiling, KTL-002 created ## Tea presets.## Boiling, not create a new section.The rule: match the section to the feature, not to the task.
How to write a task — the format and what belongs in the body — lives in the mdtask skill, the single source. sdd adds only the rhythm: a task is the spec, written before the code, and documented once it's built (see the Cycle above).