SuperAPI AI 工具集

dev-board

办公与效率

查看项目

更新于 10-16 14:54

技能介绍

用途

Dev Board 用于从项目 .dev/ 目录中的功能 PRD 数据生成两类产物:一个可在浏览器打开的 HTML 项目看板,以及一份面向干系人的 Markdown 状态总结。它适合在已有 /dev-plan 功能规划流程的项目中使用,帮助团队以统一格式查看各功能的进度与下一步行动。

主要能力

  • 发现项目根目录与 .dev/ 下的功能文件夹。
  • 使用专用子代理 board-generator 解析各个功能的 PRD,返回结构化进度数据。
  • 校验解析结果为 JSON 数组,并检查必需字段与命名规范(camelCase、小写状态值)。
  • 生成 .dev/board.html 看板文件。
  • 生成 .dev/board-stakeholder.md 干系人摘要,纯 GitHub 风格 Markdown,不含 HTML 标签与原始 emoji。

使用方式

技能按步骤执行:

  1. 发现项目根目录:运行 scripts/discover.sh 的 root 命令,将输出存为 $PROJECT_ROOT。脚本路径需使用完整路径并以 $HOME 代替字面主目录。
  2. 发现功能:运行 scripts/discover.sh 的 features 命令。若无 .dev/ 目录或未找到功能,会提示使用 /dev-plan 创建新功能。
  3. 解析功能数据:以功能路径列表启动 board-generator 子代理(subagent_type=dev-workflow:board-generator,model=haiku),提取 Status、Created/Updated 日期、Last Checkpoint、Summary、Phase 进度、Sub-PRD 进度与 Next Action。返回后校验 JSON,并向用户展示解析摘要表。
  4. 生成 HTML 看板:构建 BOARD_DATA 对象(包含 projectName、generatedAt、summary 计数与 features 数组),读取 references/board-template.html,将 <!-- BOARD_DATA --> 注释替换为数据脚本,写入 $PROJECT_ROOT/.dev/board.html。
  5. 生成干系人 Markdown:按状态分组功能,构建包含 Active Features、Completed Features、Needs Attention、Other 等分节的 Markdown,写入 $PROJECT_ROOT/.dev/board-stakeholder.md。
  6. 报告生成结果与功能统计。

适用场景

  • 项目使用 .dev/ 目录与功能 PRD 管理规划,需要查看整体功能进度。
  • 需要向非开发干系人以 Markdown 形式汇报状态。
  • 需要在浏览器中查看可视化项目看板。

限制与约束

  • 依赖 .dev/ 目录中的功能数据,若不存在则无法生成。
  • 解析结果必须通过 JSON 字段校验,否则停止执行,不将异常数据注入模板。
  • 输出与保存文件中不得包含含用户名的绝对路径、密钥、令牌、凭证或个人身份信息;应使用相对路径与不带完整路径的功能名。
  • 脚本调用之间不保留 shell 状态,因此每次调用需提供完整脚本路径。
  • 任何脚本非零退出都需停止并报告错误。