mcpField
D
do-status

do-status

github.com/fabio-barboza开发3075 次安装今天更新
代码仓库

关于 do-status

do-status 是用于检查 PRD 任务进度并生成巴西葡萄牙语状态报告的 Agent Skill。它按约定查找 PRD、识别下一项待办任务,并可检查已完成任务的评审文件。

主要功能

  1. 01按 prd-* 规则定位 PRD
  2. 02解析任务完成与待办状态
  3. 03识别下一项及其依赖
  4. 04可选检查评审文件完整性
  5. 05输出巴西葡萄牙语报告

适用场景

  1. 01查看功能 PRD 的任务进度
  2. 02确定下一个可执行任务
  3. 03发现缺失的任务评审文件

安装

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

$npx skills add https://github.com/fabio-barboza/development-orchestrator --skill do-status

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

详细介绍

状态报告

目录规范

强制要求: PRD 目录必须始终遵循 ./prds/prd-[feature-slug]/ 格式,其中 prd- 是必需前缀。示例:功能 user-auth → 目录 ./prds/prd-user-auth/。扫描 ./prds/ 时,只考虑符合 prd-* 模式的文件夹。

流程

步骤 1:识别目标 PRD

  1. 如果用户未提供 [feature-slug],扫描 ./prds/,查找符合 prd-* 模式的文件夹。
  2. 如果只有一个 prd-* 文件夹,则自动使用它。如果存在多个,则选择最近修改的文件夹。
  3. 如果 ./prds/ 不存在或其中没有 prd-* 文件夹,则停止:“未找到 PRD — 请先运行 do-create-prd。”

步骤 2:读取任务

  1. 读取 ./prds/prd-[feature-slug]/tasks/tasks.md。如果该文件不存在,则停止:“未找到 tasks.md — 请先运行 do-create-tasks。”
  2. 解析所有任务:[x] = 已完成,[ ] = 待处理。
  3. 确定下一个待处理任务(按顺序遇到的第一个 [ ])。
  4. 检查下一个待处理任务是否存在未满足的依赖项(前面是否有任务仍为 [ ])。

步骤 3:检查产物完整性(可选)

  1. 对每个标记为 [x] 的任务,验证其审查文件是否存在于 ./prds/prd-[feature-slug]/tasks/[num]_task_review.md。
  2. 将缺少审查文件的 [x] 任务标记为未完成。
  3. 如果下一个待处理任务当前正在进行,则读取 ./prds/prd-[feature-slug]/tasks/[num]_task.md,以显示子任务级别的进度。

步骤 4:输出状态报告

按照以下格式生成简洁的报告:

📦 [Feature Name] (prd-[slug])

Progresso: X/Y tasks concluídas (Z%)

✅ Concluídas: 1, 2, 3
⏳ Próxima:    4 — [título da task]
⏸️  Pendentes: 5, 6, 7 ... Y

⚠️  Artefatos ausentes: [lista de tasks [x] sem review file, se houver]
🚫 Bloqueios: [tasks com dependências não atendidas, se houver]

输出语言

使用巴西葡萄牙语(PT-BR)撰写报告。

错误处理

  • 如果 ./prds/ 不存在或其中没有 prd-* 文件夹,则停止并提示:“未找到 PRD — 请先运行 do-create-prd。”
  • 如果所选 PRD 中不存在 tasks.md,则停止并提示:“未找到 tasks.md — 请先运行 do-create-tasks。”
  • 如果存在多个 prd-* 文件夹且未指定文件夹,则选择最近修改的文件夹 — 绝不等待用户输入。
  • 如果任务标记为 [x],但缺少其审查文件,则在“缺失产物”下列出此不一致 — 不要修改任何文件。

参考

  • 任务索引:./prds/prd-[feature-slug]/tasks/tasks.md
  • 任务文件:./prds/prd-[feature-slug]/tasks/[num]_task.md

评论

支持 Markdown