add-task

add-task 技能概览

add-task 的作用

add-task 技能会根据用户的原始请求，在 .specs/tasks/draft/ 下生成一个任务草稿文件。它适合你在进入规划或实施之前，先得到一个格式统一的任务产物，而不只是随手记一条自由文本备注。这让 add-task skill 很适合用于需要清晰标题、任务类型、依赖关系和保留原始意图的 Project Management 工作流。

适合谁安装

如果你的团队使用 spec 驱动的任务跟踪，把起草和执行分开，或者希望 agent 把零散需求整理成结构化任务文件，就应该安装 add-task。它在任务录入很重要的场景里价值最大：产品运营、工程负责人、AI 辅助 PM 工作流，以及需要可重复“草稿到待办”流程的 repo 维护者。

它的突出之处

add-task 的核心优势在于结构化。它不只是总结需求：它还会帮你归类任务、识别依赖文件，并把输出放到正确的目录里。和一个可能会忘记命名规范、任务类型或文件夹约定的通用 prompt 相比，这样能显著减少猜测成本。

如何使用 add-task 技能

安装并激活 add-task

在 NeoLabHQ/context-engineering-kit 插件集合中使用这个技能，然后把你想要起草的任务请求交给 agent。仓库里给出的安装流程是：

npx skills add NeoLabHQ/context-engineering-kit --skill add-task

安装后，agent 应该接收用户的任务标题或描述，以及任何依赖任务文件。add-task install 这一步很重要，因为这个技能依赖于了解 repo 的路径和文件夹设置，包括 .specs/tasks/draft/。

编写技能可以解析的输入

最好的 add-task usage 是简洁但具体的请求。要包含结果、范围，以及已知依赖。好的输入示例如下：

• Add validation to form inputs
• Create login rate limiting; depends on auth cleanup task
• Refactor task creation flow for mobile users

糟糕的输入则过于模糊，会迫使模型猜测：

• Improve app
• Fix stuff
• Make tasks better

如果请求隐含了任务类型，就直接说明；如果没有，就让技能根据动词和范围自行推断。

先读对的文件

先看 SKILL.md，因为它定义了角色、目标、输入和操作说明。然后再检查任何控制任务命名、工作流或约定的 repo 文件。在这个仓库预览中，SKILL.md 是主要信息来源；这里没有 rules/ 或 references/ 之类的支持文件夹，所以主要风险不是这里缺文档，而是你自己工作区里可能存在本地约定却没有被覆盖。

更容易产出好草稿的工作流

当你的目标是把粗略需求转换成后续可以进入待办或实施阶段的草稿时，就用 add-task。先提供准确的任务意图和依赖；接着让技能把草稿文件写入预期目录；最后检查输出的标题是否清晰、依赖是否准确，以及描述是否保留了用户原意而没有过度润色。

add-task 技能 FAQ

add-task 更适合 Project Management 还是编码？

两者都适用，但主要用途还是面向工程工作的 Project Management。它会生成一个可以接入规划和实施的任务产物。如果你只需要一条快速提醒，普通 prompt 会更简单。

我需要先了解仓库结构吗？

不需要，但你应该知道你的项目是否使用 .specs/tasks/ 或类似约定。如果你的 repo 采用不同的任务文件夹，在依赖默认 add-task 行为之前，先调整输出路径。

什么时候不该用 add-task？

当你已经有一张完整的实现 ticket、任务应该直接进入编码阶段，或者你的 repo 根本不使用草稿任务文件时，就不要用它。在这些情况下，直接 prompt 或其他工作流可能更快。

这个技能适合新手吗？

适合，只要你能用一句话描述任务，并理解基本的依赖命名。主要门槛不在 AI 步骤，而在于你是否知道团队对草稿文件的要求。

如何改进 add-task 技能

给技能更少需要补空的地方

提升质量最大的方式，是把源输入写得更好。要包含动作、目标区域，以及任何阻塞项。比如，Add password reset email retry handling; depends on email queue stability task 就比 Improve reset flow 好得多。这有助于 add-task 保留原始意图，并正确分配依赖关系。

检查标题、类型和依赖

大多数质量不佳的输出都来自三个问题：标题过于宽泛、类型标签过于笼统、缺少依赖链接。先检查这三项。如果标题不是“动词 + 具体对象”的形式，就改写它；如果类型不确定，就在重新运行 add-task skill 前补一句澄清说明。

通过优化提示词迭代，不要直接硬改文件

如果第一版草稿不理想，优先改输入，而不是手工把所有内容补丁式修正。告诉 agent 要保留什么、要重新归类什么，以及它应该依赖哪些文件。这是拿到一个可供下游规划使用的草稿时，最快的 add-task guide 做法。