Task Execution Simple 是一个用于实现或完成给定工程任务的技能,目标是交付经过验证、可恢复的结果。
用途 它适用于有明确范围的工程任务:实现或收尾一个已提供的任务,并在完成后留下可验证、可恢复的状态。技能强调独立工作,先阅读仓库说明、提供的任务或规格、相关代码与测试,以及当前版本控制状态。只有在缺少行为边界、技术选择或执行顺序决策且会实质性改变结果时,才在编辑前停止,并说明缺失的决策及其原因,以便用户直接解决或记录到合适的工件中。
主要能力
- 编辑前给出简明方案预览:改动面、核心策略、关键约束、验证切入点。对于直接了当的工作不创建正式工件。
- 编辑前选择隔离方式:复用合适的现有隔离;对于默认或共享分支上的非平凡工作、可能与现有脏改动冲突、并行工作或可能跨会话执行的情况,创建分支或 worktree;对于小型安全改动或用户明确指示,则原地进行。
- 只实现给定范围,保留无关的用户改动。
- 运行最相关的实际验证,完成实现审查修正循环,并检查最终 diff。
- 当实现改变文档所述事实或被要求时,更新现有文档或任务状态。
- 在进入下一个任务或路点前,按仓库策略和用户指示,为稳定的范围改动创建内聚的 Git 检查点,并包含事实已改变的任务文档。
- 若检查点有意不可用,报告确切原因和未提交范围,而不是带着已完成工作静默继续。
- 报告结果、验证、残余风险、提交或未提交状态,以及仍待确认的收尾动作。
使用方式 技能以流程化方式工作:先确认任务可实施,再预览方案,选择隔离,实施范围,验证,审查修正,更新文档,创建检查点,最后报告。完成条件为:验收满足、最终验证反映当前代码、审查发现已解决、稳定改动已提交或明确说明。它不要求另一个本地技能、文档布局、跟踪器、分支约定、固定提交序列或审查暂停。
自适应验证 优先使用最高信号的验证切入点:聚焦测试、类型或静态检查、集成检查、构建、运行时演练或针对性手动证据。当完成依赖这些检查时,持久记录命令和结果。若必需检查失败或未运行,不得声称完成,需说明限制。保留现有测试的意图,不得为了通过实现而静默删除、跳过、放宽或重写断言。当有意的行为变更使测试过时,需在任务工件或完成报告中明确变更的契约和替代证据。
自适应 Git 检查点 在实现请求范围内,将分支/worktree 创建和任务范围提交视为常规、可逆的进展,同时保留仓库实践和用户明确指示。在稳定、可审查的边界提交。小型工作优先一个内聚的最终任务提交。仅当各部分可独立理解并验证,或仓库实践要求时才拆分;不要按文件、层、计划步骤或审查轮次制造提交。提交后可通过后续提交或稍后 squash 继续审查。当稳定规格、设计、计划、任务更新和实现构成一个可审查变更时,保持在一起。当另一个会话、协作者或实现步骤将依赖该稳定路点时,可提前提交文档。绝不包含无关的用户改动。当范围改动与无关工作无法安全分离,或用户/仓库禁止提交时,保持未提交并报告原因。
伴随技能 当测试先行开发适合该改动时,使用已安装的 tdd 技能。当存在风险、复杂度或用户要求独立审查时,使用 code-review。对于不稳定的外部事实,使用 research。当执行将由另一位协作者继续时,使用 handoff。这些伴随技能来自 mattpocock/skills,可通过 npx skills add mattpocock/skills --skill <name> 安装。它们是伴随,不是前提。
安全收尾 当验收或状态需要更新时,使用仓库现有的任务工件;否则保持报告简洁。若存在隔离工作,在合并、删除分支或 worktree、丢弃提交或未提交工作前,要求明确确认。使动作和目标明确;合并确认不授权后续删除。绝不从完成请求推断破坏性授权。
适用场景与限制 适用于有明确范围的工程任务实现与收尾,尤其是需要验证、文档更新和 Git 检查点的场景。限制包括:不适用于缺少可实施证据的任务;不要求固定流程或额外工具;不包含具体收费、价格、平台或效果信息(资料未提供)。