mcpField
P
progress-check

progress-check

github.com/tjcagesAgent 工作流685 次安装2 周前更新
代码仓库

关于 progress-check

为耗时任务规范进度更新的 Skill,依据可观察的里程碑和证据,而非经过时间来汇报;也提供按需全局安装该行为的说明。

主要功能

  1. 01设定可观察的里程碑
  2. 02规定进度更新时机
  3. 03及时报告阻碍与完成情况
  4. 04使用单个进度条格式化更新
  5. 05说明全局安装步骤

适用场景

  1. 01汇报耗时任务的进展
  2. 02跨 Agent 会话保持更新规范
  3. 03告知用户任务受阻
  4. 04在多个项目中安装进度规则

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tjcages/skills --skill progress-check

安装后在 Claude Code 中输入/progress-check确认已加载。

附带文件agents/openai.yaml

详细介绍

进度检查

完整方法:METHODOLOGY.md。对话格式: RESPONSE.md。示例:EXAMPLES.md。

选择模式

  • 报告进度: 对符合条件的长时间运行工作,默认采用此模式。
  • 全局安装: 仅当用户要求在多个 Agent 或项目中持续应用此行为时采用。

报告进度

  1. 在估算百分比之前,先定义一小组可观察的里程碑。 根据工作量和风险分配权重,而不是根据已用时间。
  2. 了解工作范围后,发送一次基准更新。
  3. 只有至少经过 30 分钟,并且满足以下任一条件时,才发送常规更新:完成一个里程碑、经验证的进度至少提高 10 个百分点,或下一步行动发生实质性变化。
  4. 如果出现用户可以采取行动的新阻碍,立即报告。完成时立即报告。
  5. 不要重复未变化的进度条,也不要发送常规的“仍在处理”消息。

每次更新最多包含三个简短项目:已完成的证据、当前工作,以及下一步或阻碍。最后单独一行显示一个整体进度条,并将其设为行内代码:

Performance rollout [██████████████████░░] 90%

使用一对反引号设置行内代码样式。不要缩进该行四个空格,也不要使用围栏代码块;两者都会形成独立代码块,界面可能会为其添加标签或使其可复制。

  • 将标签替换为简短的任务专属标签。
  • 使用 20 个格子:█ 表示已完成,░ 表示剩余。
  • 除非完成证据支持 100%,否则向下取整到最接近的 5%。
  • 除非用户要求显示子任务进度条,否则只显示整体进度条。
  • 在多 Agent 工作中,仅由协调者显示整体进度条。
  • 进度行必须是更新的最后内容。显示后立即结束,不附加说明、回顾或结束语。

全局安装

优先通过可用的 Agent Skills CLI 全局安装此技能,让所有受支持的 Agent 使用同一来源:

npx skills add tjcages/skills --skill progress-check -g --agent '*'

如果用户明确要求使用原生的常驻指令,则:

  1. 检查每个已安装 Agent 文档中说明的用户级指令机制。
  2. 合并进度规则,不要覆盖现有指令。
  3. 确保更改可重复执行且不会产生重复效果,并避免使用仓库级指令文件。
  4. 如果某个 Agent 仅支持通过 UI 管理规则,则提供准确的设置位置和可直接复制的内容,不要编造文件路径。
  5. 验证每个已更改的目标,并说明是否需要开启新会话。

不要声称已配置不受支持的 Agent。不要修改无关的偏好设置。

评论

支持 Markdown