关于 sdd-tasks
sdd-tasks 是面向 Claude Code 的技能,可将设计拆解为有序、原子且可验证的实施任务,并保存任务文档供后续流程使用。
主要功能
- 01将设计拆解为任务
- 02任务有序且原子化
- 03规划可验证任务
- 04优先写入磁盘
适用场景
- 01根据设计准备实施工作
- 02为 SDD 变更创建任务计划
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fearovex-labs/ agent-config --skill sdd-tasks安装后在 Claude Code 中输入/sdd-tasks确认已加载。
详细介绍
sdd-tasks
将设计拆解为原子化、有序且可验证的任务计划。
触发条件:/sdd-tasks <change-name>、任务计划、拆解实现、任务拆分、sdd tasks
技能解析
项目本地 → 全局,按以下顺序:
1. .claude/skills/sdd-tasks/SKILL.md (project-local — highest priority)
2. ~/.claude/skills/sdd-tasks/SKILL.md (global catalog — fallback)
完整算法请参阅 docs/SKILL-RESOLUTION.md。
Claude 执行接线
这些说明将上述与工具无关的逻辑绑定到 Claude Code 执行环境。它们属于无法移植到其他工具的执行层。
- 步骤 0 预加载 — 按照
skills/_shared/sdd-phase-common.md的 第 F 节 (项目上下文加载)和 第 G 节(规格上下文预加载)执行。两者均不阻塞。 - 工件读取(步骤 1) — 使用执行环境的
Read("docs/sdd/{change-name}/<artifact>.md")工具读取设计、规格和提案。如果磁盘文件不存在(旧版变更),则回退到mem_search(query: "sdd/{change-name}/<artifact>")→mem_get_observation(id)。如果两者均不存在且 Engram 无法连接,则由编排器内联传入 内容。 - 任务计划持久化(步骤 5) — 以磁盘为主,分两步,先写入磁盘:
Write("docs/sdd/{change-name}/tasks.md", <full tasks markdown>),然后使用topic_key: sdd/{change-name}/tasks、type: architecture、project: {project}保存一个指针和摘要 到mem_save,内容 ="path: docs/sdd/{change-name}/tasks.md\n\n{1-3 sentence summary}"。如果 Engram MCP 无法连接:仍然写入磁盘工件(事实来源);仅跳过 engram 指针。生成的 tasks.md 中的Design:/ 规格审查引用使用engram:sdd/[name]/...指针形式。 - 编排器输出 — 将中立的输出约定作为编排器所需的 JSON 块返回;工件条目为
engram:sdd/{change-name}/tasks,手动下一步为/sdd-apply。不要自行格式化下一步 — 编排器会添加斜杠前缀并渲染。
评论
支持 Markdown