mcpField
S
specsfy-progress

specsfy-progress

github.com/promovaweb开发87440 次安装1 周前更新
代码仓库

关于 specsfy-progress

specsfy-progress 是根据规范文件投影项目整体进度的 Specsfy 技能。它报告门禁、任务、阻塞项和下一项负责技能，不修改规范源文件。

主要功能

  1. 01依据规范状态投影进度
  2. 02报告门禁与任务分母
  3. 03识别阻塞项和下一项就绪任务
  4. 04检查文档状态
  5. 05支持 JSON 输出

适用场景

  1. 01查看多个项目规范的进度
  2. 02查找门禁或检查清单中的阻塞项
  3. 03向其他工具传递进度数据

安装

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

$npx skills add https://github.com/promovaweb/specsfy --skill specsfy-progress

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
specialists.md
scripts/
analyze_context.mjs
progress.mjs

详细介绍

报告整体进度

必须完成的准备工作

执行此 skill 前，必须在项目根目录加载 $specsfy-setup。自动交接时，在 此步骤前重新加载。重用对话中已确认的根目录；如果 setup 指出有待处理事项， 则不要继续。

交互模式

交互模式：sem perguntas。 此 skill 不要提问。展示观察到的进度，并执行适用的下一步交接。

仅从 specs/<estado>/*/spec.md 读取状态。报告是对真实数据源的投影， 而不是第二个状态数据源。

编排对话

完成此步骤或发现其他步骤的工作时，宣布 Pendência detectada: <descrição> — ação: resolvendo nesta etapa，并在属于 本步骤范围时予以解决。需要切换职责时，宣布 Transição automática: $specsfy-progress → $<destino> — motivo: <motivo> — resultado esperado: <resultado>，并立即加载目标 skill，无需请求确认或重复命令。在同一对话中 继续。解决本步骤的必要问题后，宣布 Retomada automática: $<destino> → $specsfy-progress — pendência resolvida: <resultado>，并立即继续本步骤。 每次交接后重新评估状态，避免循环。无需为交接请求确认；敏感操作仍需单独 授权。

执行

在仓库根目录中：

node .agents/skills/specsfy-progress/scripts/progress.mjs .

与其他工具集成：

node .agents/skills/specsfy-progress/scripts/progress.mjs . --json

针对单个规格：

node .agents/skills/specsfy-progress/scripts/progress.mjs . --slug <slug>

查看某个 spec 的上下文成本：

node .agents/skills/specsfy-progress/scripts/analyze_context.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md --json

将文档待处理事项与进度一同投影：

node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \
  --project . --check

node .agents/skills/specsfy-documentator/scripts/build_documentation.mjs \
  --project . --check

将 PENDING 视为交付阻塞项，并宣布 monitor 指示的交接。辅助 skill 更新 文档，或记录并确认无影响评估后，再恢复此 skill。 如果第二条命令表明文档缺失或已过时，宣布交接至 $specsfy-documentator， 重建 docs/，然后恢复进度投影。

不使用 --usage-json 时，结果始终标记为 estimated，并说明所用的启发式方法。 明确提供的指标属于 measured；绝不要将估算值说成实际用量。

解读

  1. 报告 spec、gate、任务和检查清单项的分母。
  2. 根据 Status 展示当前操作和下一步负责的 skill。
  3. 区分已完成的规格、进行中的工作和实际阻塞项。
  4. 如有就绪项，展示下一个就绪的 TNNN/ITEM 对。
  5. 将 Failed 状态的 gate、检查清单不一致或不存在就绪路径的依赖视为阻塞项。单独出现 In Progress 状态的 gate 不代表失败。
  6. 即使所有复选框都已勾选，仍将 monitor_context.mjs 指出的必需文档视为阻塞项。
  7. 根据 $specsfy-documentator 的判断，将缺失或过时的 docs/ 视为交付阻塞项。
  8. 如果现有 spec 要求改变行为或计划，宣布待处理事项并自动加载 $specsfy-update-spec。更新完成并经过所有失效操作后，恢复进度投影。
  9. 如果不存在 spec，保留代码 2。specs/inbox/ 中的捕获项和 specs/backlog/ 中的条目不计入规范进度。如果请求还要求推进已有捕获项，宣布待处理事项并加载 $specsfy-02-backlog；如果已有足够明确的意图和定义，则加载 $specsfy-03-specify。

保留真实数据源

  • 查询期间不要编辑 spec、复选框、测试或代码。
  • 不要统计 research/ 中的 spec.md；发现范围严格限定为 specs/<estado>/*/spec.md。
  • 不要根据提交、文件或聊天记忆臆造进度。
  • 若需更新状态，在同一对话中宣布并自动加载负责的 skill。状态更新后自动恢复进度报告。

汇报

先提供全局摘要，然后列出需要关注的规格、阻塞项和下一步工作。存在可执行步骤时，先说明并自动执行转换。用户要求自动化或结构化数据时，使用 JSON 输出，不要重新解释字段名称。

按需调用专家

仅在为下一项任务提供背景信息时，阅读 references/specialists.md。自动加载负责该任务的基础 skill 或已安装的专家；安装需要获得明确授权。

评论

支持 Markdown