关于 atomic-tasks
atomic-tasks 是面向编码工作的流程技能,将较大工作拆成可验证、可独立提交的原子任务,并为每项任务使用新鲜的子 Agent 上下文。
主要功能
- 01拆分为原子任务
- 02编写含成功标准的短计划
- 03为子 Agent 使用新上下文
- 04每项任务单独提交
- 05继续前验证任务结果
适用场景
- 01将大型功能拆成可管理的编码任务
- 02减少委派任务间的上下文残留
- 03让 Git 历史便于审查和回退
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ thebeardedbearsas/ claude-craft --skill atomic-tasks安装后在 Claude Code 中输入/atomic-tasks确认已加载。
详细介绍
原子任务 — GSD 模式(Get Shit Done)
灵感来自 gsd-build/get-shit-done(Lex Christopherson,已被 Amazon/Google/Shopify/Webflow 采用)。
目标:通过将工作拆分为原子任务,并在上下文全新的子 Agent 中执行,来对抗上下文腐化(上下文使用量超过约 50% 后,质量开始下降)。
GSD 模式的 5 个步骤
1. 拆分工作 — 拆分
将功能拆分为原子任务:
- 每项任务都能用 1-3 句话描述
- 每项任务都能在 < 30 分钟内完成
- 每项任务都能独立测试
- 每项任务都能作为一个原子提交提交
❌ MAUVAIS : "Ajouter le système d'authentification"
✅ BON :
1. "Créer la table users avec migration"
2. "Implémenter POST /auth/register avec validation email"
3. "Implémenter POST /auth/login retournant JWT"
4. "Ajouter middleware JWT verification"
5. "Tests d'intégration du flow login"
2. 短计划 — 为每项任务制定短计划
为每项原子任务制定一个短计划:
- 1 个目标
- 最多 3-5 个步骤
- 明确的成功标准(测试通过、端点有响应、文件存在)
3. 全新的子 Agent 上下文 — 每项任务都使用全新上下文
基本规则:每项原子任务都在上下文全新的子 Agent 中执行(通过 Task tool,或在任务之间使用 /clear)。
| 原因 | 影响 |
|---|---|
| 启动时上下文 < 30% | 回复质量最高 |
| 没有上一项任务的残留内容 | 完全避免跨任务混淆 |
| 优化 token 成本 | 无需重复读取累积的上下文 |
| 可并行处理 | 多个子 Agent 可同时运行 |
实现方式:
- 使用
Agenttool,设置subagent_type=general-purpose或专用类型 - 仅传递必要的上下文(而非整个项目)
- 要求在结束时提供简洁的报告(< 200 词)
4. 原子 Git 提交 — 原子提交
每项任务 = 1 次提交。绝不在一次提交中混合 2 项任务。
✅ BON :
commit 1 : "feat(auth): add users table migration"
commit 2 : "feat(auth): implement register endpoint"
commit 3 : "feat(auth): implement login endpoint"
❌ MAUVAIS :
commit 1 : "feat: auth system + bug fixes + refactor"
好处:git bisect 更高效,回退更精准,审查更容易。
5. 验证目标 — 验证每个目标
开始下一项任务前,明确验证目标是否已达成:
- 编写的测试通过
- 端点返回正确的 HTTP 状态码
- 构建成功
- Linter 检查通过
- 用户可观察到预期行为
**规则:**不能说“我觉得应该能运行”。没有证据,就不算完成。
需要应用此模式的信号
- 上下文使用量 > 50%
- 任务持续 > 1 小时且没有中间交付物
- Claude 的回复变得不那么准确
- 需要重新解释已经说过的内容
- 一项请求包含多项职责
应避免的反模式
| 反模式 | 为什么不好 |
|---|---|
| 大杂烩式会话 | 在 1 个会话中做所有事情 = 必然导致上下文腐化 |
| 无法测试的任务 | 无法验证 = 永远无法算作“完成” |
| 混合提交 | 无法审查,回退风险高 |
| 任务之间不清除上下文 | 任务间相互污染 |
| 过度规划 | 改 1 行代码却列出 10 个步骤 = 额外开销 |
与 Claude Craft 集成
/workflow:analyze— BMAD 分析阶段必须产出原子任务/common:ralph-run— Ralph 必须围绕原子任务迭代,每轮处理一项- Agent tool — 每项复杂任务都委派给一个全新的子 Agent
- Rule 12 (context-management) — 不相关任务之间必须使用
/clear - Rule 23 (karpathy-principles) — 每项任务的代码量应保持最少
资源
- gsd-build/get-shit-done
- Rule
.claude/rules/01-workflow-analysis.md - Rule
.claude/rules/12-context-management.md - Command
/common:sub-agents-patterns
**最后更新日期:**2026-04-15 **版本:**1.0.0
评论
支持 Markdown