task-state

用途

Task State 用于在现有跟踪器或最小化 Markdown 工件中维护一个可恢复的任务检查点。它强调维护检查点，而不是过程日志。适用于工作被规划、暂停、交接、阻塞或完成时。

查找仓库中已有的 issue、任务文件、清单、路线图条目或其他状态约定，并就地更新。
若不存在现有约定且持久检查点有用，建议最小的、与仓库一致的 Markdown 记录。
使用验收复选框作为主要进度记录，并根据定义设置 planned、in-progress、blocked 或 completed 状态。
仅添加当前分支所需的状态：工作继续时更新已满足的验收；停止或交接时仅添加另一会话无法轻易重建的恢复检查点；阻塞时记录阻塞项；完成时用一份最终验证摘要替换临时恢复状态。
报告状态、验收、阻塞项和最终验证之间的任何不一致。
当证据明确支持非破坏性更改时，更新过时状态；当验收本身模糊或更改会隐藏未完成范围时，进行询问。

查找仓库中已有的状态约定并就地更新。
若无现有约定且需要持久检查点，提出最小的、与仓库一致的 Markdown 记录。
使用验收复选框记录进度，并设置状态。
根据当前分支添加所需状态：继续、停止/交接、阻塞或完成。
报告状态、验收、阻塞项和最终验证之间的不一致。
当工件陈述当前事实且不保留常规活动时完成。仅当没有本地格式适用时，使用 references/task-state-template.md。不要求文档目录、标签、分支方案或固定转换顺序。
在有里程碑上下文时，仅更新选定的任务，并将其结果或阻塞项返回给工作流；里程碑放置、发现的工作路由和关闭仍由工作流负责。

仅在可观察条件满足并验证后标记 [x]。当任何部分仍未完成时，保持复合标准开放。将规格、设计、计划和 research 视为输入而非进度。工件存在通常是可见的；仅当链接能实质性改善导航时才添加链接。Grilling 是可选的，不留下任务状态标记。

仅在工作停止、交接或阻塞，且实时仓库检查无法恢复足够上下文时创建检查点：

在无中断的执行-审查循环中，直接处理发现。在停止边界，仅保留否则只存在于聊天中的未解决发现：陈述具体发现、受影响表面和所需后续行动，或链接已拥有它们的持久 PR/审查评论。移除已解决的发现，而不是保留审查历史。

将任务语义恢复保留在检查点中。仅针对安全继续所需的非显而易见的分支、工作树、未提交或瞬态状态添加单独的工作状态说明；对于普通事实，优先使用实时版本控制检查。完成时移除两者。

当已安装且跨人员继续需要比此检查点更多的操作细节时，使用 handoff。它来自 mattpocock/skills，可通过 npx skills add mattpocock/skills --skill handoff 安装。

将常规测试、构建、lint 和格式化运行保留在执行上下文中，并在需要时针对当前代码重新运行。任务不携带运行命令历史。

仅当中间验证消除重大风险且昂贵或无法重现、依赖外部系统，或独立于普通代码更改仍然有效时，才保留中间验证。记录其结论和范围。

完成时，在最终更改后写一份简洁的最终验证摘要。陈述检查或审查、其结果以及它们所证明的验收。当存在已验证的修订、PR、CI 运行、发布或工件时，链接它们。仅日期或命令不能证明任何东西。

当时机影响后续选择时，仅保留观察到的信号：当前优先级的 Why now、真实前提条件的 Start when，或延迟工作的 Revisit when。省略缺失的时机上下文，而不是编造日期、优先级或依赖关系。运行时行为属于规格；路线图放置属于规划系统。

在提出关闭操作前，检查当前分支、工作树、未提交更改和仓库策略。将这些操作保留为显式门控：

通用回复如“continue”、“finish”或“clean up”不确认合并、删除或丢弃。合并确认不意味着后续删除确认。优先使用可恢复的清理，并说明哪些仍可恢复。

适用于需要维护任务检查点的软件开发工作流，尤其是在工作被规划、暂停、交接、阻塞或完成时。适合希望以最小化、与仓库一致的方式记录任务状态，并避免过程日志的团队。

该技能不要求文档目录、标签、分支方案或固定转换顺序。它不编造日期、优先级或依赖关系。运行时行为属于规格，路线图放置属于规划系统。关闭操作需要明确确认。