关于 do-status
do-status 是用于检查 PRD 任务进度并生成巴西葡萄牙语状态报告的 Agent Skill。它按约定查找 PRD、识别下一项待办任务,并可检查已完成任务的评审文件。
主要功能
- 01按 prd-* 规则定位 PRD
- 02解析任务完成与待办状态
- 03识别下一项及其依赖
- 04可选检查评审文件完整性
- 05输出巴西葡萄牙语报告
适用场景
- 01查看功能 PRD 的任务进度
- 02确定下一个可执行任务
- 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
- 如果用户未提供
[feature-slug],扫描./prds/,查找符合prd-*模式的文件夹。 - 如果只有一个
prd-*文件夹,则自动使用它。如果存在多个,则选择最近修改的文件夹。 - 如果
./prds/不存在或其中没有prd-*文件夹,则停止:“未找到 PRD — 请先运行do-create-prd。”
步骤 2:读取任务
- 读取
./prds/prd-[feature-slug]/tasks/tasks.md。如果该文件不存在,则停止:“未找到 tasks.md — 请先运行do-create-tasks。” - 解析所有任务:
[x]= 已完成,[ ]= 待处理。 - 确定下一个待处理任务(按顺序遇到的第一个
[ ])。 - 检查下一个待处理任务是否存在未满足的依赖项(前面是否有任务仍为
[ ])。
步骤 3:检查产物完整性(可选)
- 对每个标记为
[x]的任务,验证其审查文件是否存在于./prds/prd-[feature-slug]/tasks/[num]_task_review.md。 - 将缺少审查文件的
[x]任务标记为未完成。 - 如果下一个待处理任务当前正在进行,则读取
./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