progress-manager

汇总当前会话的工作进度并持久化到项目的进度文档中,或恢复上次会话的工作上下文让用户能立即继续工作。用于”保存进度/记录进度/更新进度”或”恢复进度/继续上次工作/从断点继续”场景。

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "progress-manager" with this command: npx skills add ava-grace-zoe/kairos/ava-grace-zoe-kairos-progress-manager

progress-manager

使用本技能处理两类动作:

  1. save:保存或更新进度
  2. resume:恢复并继续进度

目录与命名约束

  • 进度目录:docs/progress/
  • 文件名格式:<what>__<updated_at>__<status>.md
  • 状态仅允许:doingblockeddone

字段说明:

  • what:任务标识,使用小写英文和 -(例:resume-skill-redesign
  • updated_at:最后更新时间,格式 YYYYMMDD-HHMMSS,每次 save 时更新(文件重命名)
  • status:当前状态,变更时通过重命名文件更新

save 规则

  1. 文件名优先
  • 用户给了完整文件名时,只更新该文件,不再按 what 自动查找。
  1. what 次优先
  • 用户未给文件名但给了 what 时,仅在该 what 下定位目标;有则更新,无则新建 ...__doing.md
  1. 自动生成
  • 用户既未给文件名也未给 what 时,从当前任务生成 what,先查找该 what 下已有的非 done 文件;有则更新,无则新建 ...__doing.md
  1. 状态通过文件名表达
  • 状态变化通过重命名文件实现。每次 save 同时更新文件名中的 updated_at
  1. 保存输出
  • 返回目标文件路径,并给出当前状态与下一步首要动作。

resume 规则

  1. 文件名优先
  • 用户给了完整文件名时,只恢复该文件,不做自动选择。
  1. what 次优先
  • 用户只给 what 时,仅在该 what 下选目标;默认选最近更新且状态不是 done 的文件。
  1. 自动恢复
  • 用户未给文件名和 what 时:
    • 活跃任务(doing + blocked)> 1 个:先列出概览(what / 状态 / 更新时间),让用户选择。
    • 仅 1 个:直接恢复。
    • 同状态排序:doing > blocked,同状态按更新时间倒序。done 不参与自动恢复。
  1. 找不到明确失败
  • 没有符合条件的 progress 时,直接返回”无可恢复项”,不猜测、不新建。
  1. 恢复输出
  • 当前状态与目标(一句话)
  • 已完成项概要
  • 下一步 1-3 条(可直接执行)
  • 阻塞项(如有)
  • 关键文件列表

进度文件模板

# <title>

- created_at: <YYYYMMDD-HHMMSS>

## 目标

<一句话目标>

## 已完成

- <已完成项>

## 下一步

- <可直接执行动作 1>
- <可直接执行动作 2>

## 阻塞

- 无

## 关键文件

- <absolute-or-repo-relative-path>

质量约束

  1. 不写空泛描述,下一步必须是动作级语句。
  2. 阻塞必须写出依赖对象或解除条件;无阻塞时写“无”。
  3. 若用户输入与目录规则冲突,先归一化文件名再写入。
  4. 默认不删除历史文件;仅在用户明确要求时做清理。

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

cross-review

No summary provided by upstream source.

Repository SourceNeeds Review
General

kairos

No summary provided by upstream source.

Repository SourceNeeds Review
General

kairos

No summary provided by upstream source.

Repository SourceNeeds Review
General

Wechat Mp Writer

WeChat Official Account (公众号) content writer with article formatting, headline optimization, and engagement tips. Use when you need to write WeChat articles,...

Registry SourceRecently Updated