SuperAPI AI 工具集

eliteforge-task-progress-tracker

通用与其它

查看项目

更新于 10-15 20:13

技能介绍

用途:为每个具体需求维护一个 Markdown 任务文件,随工作进展持续更新,使计划、TODO、当前状态和进度持久化在仓库中,并支持中断后恢复。默认目录为 docs/tasks/;若用户或其他活跃技能给出明确任务目录,则原样使用该目录,不再在 docs/tasks/ 下重复创建。已知覆盖:当 $eliteforge-google-stitch-onboarding 活跃时,其跟踪文件放在 docs/tasks/google-stitch-onboarding/。

主要能力:文件名格式为 <task-description>.md,task-description 为简短 kebab-case 摘要,优先 ASCII,中文请求转为简短英文 slug;不追加 -status-process、-task、-todo 等固定后缀,除非用户明确要求。已存在匹配文件则更新而非新建,绝不覆盖无关任务文件。状态取值:notrun、running、waiting_human_decision、finished、cancel。进度用百分比格式(如 5%、35%、100%),保持单调递增,除非用户明确变更范围;未真正完成实现与验证前不得设为 100%。

使用方式:开始实质工作前创建或刷新任务文件,包含需求摘要、完成条件、步骤列表、初始状态 notrun、初始进度 0%、可承载提交 id 的步骤备注。实际执行开始时立即更新为 running、5%,并确认工作区可创建 git 提交。每个有意义里程碑后更新同一文件:验收标准与任务复选框、步骤状态、current_step、进度、简短进度日志,以及提交创建后的相关提交 id。最终回复前做最后一次更新:成功完成则 finished、100%;需人类决策则 waiting_human_decision 并记录确切决策;用户停止则 cancel。恢复中断时,读取所选目录下最新匹配文件,检查 current_step、最新步骤备注与最新更新日志,从最近记录的提交 id 继续。

限制:若工作区不是 git 仓库或无法创建提交,需在当前步骤备注与更新日志中记录阻塞,并在继续更多不可恢复更改前告知用户。仅回写已创建提交 id 的记账式更新本身不构成新步骤检查点,应随下一次工作提交或任务停止时的最终记账提交一并持久化。步骤列表即 TODO 列表,不另设脱节的 TODO 区;复选框为实时状态,完成即改为 [x],部分完成或未验证则保持未勾选并说明差距。current_step 须始终对应步骤表中的一行或 completed。范围变更时先更新需求、验收标准与步骤,再继续执行。资料未提供具体安装命令、收费或平台信息。