task-decomposition
Skill85 starsChanged 6 months agoApache-2.0View on GitHub
Use this skill at Step 4 of the v2 SOP to decompose an OpenSpec change's tasks.md into atomic, prioritized, single-document, ≤2-file-change tasks. Enforces strict separation of frontend vs backend tracks, Chinese naming for task documents, and explicit dependency order. Each task gets its own task document under tasks/, referenced from tasks.md. Chinese trigger examples: "任务拆解", "Step 4", "拆任务", "task 拆分", "前后端分离任务". Do NOT use before openspec-continue-change finalizes specs, do NOT bundle ≥3 files per task. Success = every task ≤ 2 files, every task has its own document, ordering reflects priority + dependency, frontend / backend tracks are separated.
19 other projects use a version of this.
Adopted by
Most recently taken up by
- madeincartel/claude-code-frameworktheir own version, first seen Nov 15, 2026
- baekenough/oh-my-customcodetheir own version, first seen Nov 14, 2026
- MMACABRE/SKILLStheir own version, first seen Nov 8, 2026
- michaelalber/ai-toolkittheir own version, first seen Nov 1, 2026
- mabzhang/opc-toolkittheir own version, first seen Nov 1, 2026
- DevelopersGlobal/ai-agent-skillstheir own version, first seen Oct 25, 2026
Used with
Projects with it also use post-deploy-qa, pre-deploy-qa and 8 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
madeincartelSkillpost-deploy-qa
Post-deploy verification: execute AVP from tech-spec on live environment, verify all acceptance criteria (user-spec + tech-spec), pick up deferred criteria from pre-deploy QA report. Uses MCP tools (Telegram MCP, Playwright, curl, bash).
Also in 3 projects that use this
madeincartelSkillpre-deploy-qa
Pre-deploy acceptance testing methodology: run test suite (unit/integration/E2E), verify acceptance criteria from user-spec and tech-spec. Does not require live environment.
Also in 3 projects that use this
MicrosoftSkilldeploy-pipeline
Triggers a Power Platform Pipeline deployment run for a Power Pages solution. Selects a target stage, validates the package, optionally configures deployment settings (environment variables, connection references), then deploys and polls for completion. Use when asked to: "deploy pipeline", "run pipeline", "trigger deployment", "deploy to staging", "deploy to production", "run power platform pipeline", "deploy solution via pipeline", "promote solution", "push to staging", "push to production".
Also in 3 projects that use this
nilecuiSkilldocumentation-writing
Writing clear, discoverable software documentation following the Eight Rules and Diataxis framework. Use when creating README files, API docs, tutorials, how-to guides, or any project documentation. Automatically enforces docs/ location, linking requirements, and runnable examples.
Also in 3 projects that use this
GitHubSkillproject-planning
USE FOR: planning and updating work on a GitHub Projects board — reading fields and views, adding issues or pull requests as items, setting status and iteration, and posting a status update. NOT FOR: triaging a repository issue backlog, or preparing a release.
Also in 3 projects that use this
- +5 more from madeincartel
Other versions19 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 19
- DevelopersGlobal/ai-agent-skills★ 216same name
- adamentwistle/fable-skills★ 98same name
- baekenough/oh-my-customcode★ 42same name
- d-oit/rust-2026-template★ 15same name
- aws-solutions/konductor★ 12same name
- hieutrtr/ai1-skills★ 8same name
- AgentShekel/agentic-workflow★ 4same name
- karthikrshet/aiskills★ 4same name
- Lukasbrujula/claude-code-framework★ 4same name
- mabzhang/opc-toolkit★ 4same name
9 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository24 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- ask-questions-if-underspecifiedSkill
- audit-snapshot-microSkill
- audit-snapshotSkill
- compliance-precheckSkill
- compliance-reviewSkill
- memory-curateSkill
- mocking-stubbingSkill
- openspec-apply-changeSkill
- openspec-continue-changeSkill
- openspec-new-changeSkill
- openspec-verify-changeSkill
- phi-desensitizeSkill
- prd-authorSkill
- prd-implementation-precheckSkill
- prd-precheckSkill
- prdSkill
- prompt-injection-scanSkill
- quick-fixSkill
- requesting-code-reviewSkill
- systematic-debuggingSkill
- tdd-alignmentSkill
- test-data-generationSkill
The file
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 15 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 78
Write tasks.md index linking to each.
“Common” is measured: kept by at least 6 in 10 of the 15 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Task Decomposition
Translates an implementation-ready change into a queue of bite-sized tasks.
The canonical prompt (verbatim from v1 SOP)
将所有任务进行拆分,其中前端与后端任务要分开,每个任务不超过 2 个文件的改动,每个任务单独任务文档,任务按照优先级排序,任务文档名称和文件夹名称尽可能用中文。
Why these constraints
| Constraint | Why |
| ≤ 2 files | Forces tight blast radius; Agent stays focused; reviews are easy. |
| One doc per task | Audit / trace / parallel review without merge conflicts. |
| Chinese names | Project policy; improves PM legibility. |
| FE/BE separation | Different reviewers; different risk profiles; cleaner deploys. |
| Priority order | First task to clear must unlock the most downstream value. |
Output structure
openspec/changes/<slug>/
├── tasks.md # index, ordered list with links + status checkboxes
└── tasks/
├── 后端-01-用户匹配引擎雏形.md
├── 后端-02-匹配规则配置层.md
├── 前端-01-匹配结果展示页.md
└── ...Each task document:
# 后端-01 · 用户匹配引擎雏形
- **状态**: [ ] 未开始 / [x] 已完成
- **优先级**: P0
- **依赖**: -
- **预计文件**:
- backend/match/engine.py (new)
- backend/match/__init__.py (edit)
- **Spec 引用**: S1-match-engine
- **验收**: <criteria>
- **风险**: <if any>Workflow
- Walk specs/* — derive 1-N tasks per spec.
- Classify each task as Frontend / Backend / Both (Both is rare; usually splits into two tasks).
- Estimate files touched — if > 2, split further.
- Order by P0 → P3.
- Write per-task documents.
- Write tasks.md index linking to each.
Common failure modes
- Mega-task with 5 files — "refactor + add" combo. Mitigation: hard limit, refuse to write a task with > 2 files.
- No priority — "all P0". Mitigation: enforce at most 30% P0 of total.
- Cross-track dependency — frontend task waits on backend task, no annotation. Mitigation: dependencies field is required.
- English-only naming — "task-001-match-engine". Mitigation: project policy is Chinese; apply unless team agrees otherwise.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

