SuperAPI AI 工具集

blueprint-status

通用与其它

查看项目

更新于 10-15 23:49

技能介绍

用途:blueprint-status 用于输出当前 blueprint 配置的只读状态报告,包含三层架构明细、文档计数、可追溯性与维护任务健康度,适合审计孤立文档、过期生成内容或检查升级可用性。

主要能力:检查 docs/blueprint/manifest.json 是否初始化;读取 manifest 的版本与配置;统计 docs/prds/、docs/adrs/、docs/prps/ 中的文档数量;统计 ADR 的 domain 标签、关系声明与状态;统计 work-orders 的 pending/completed/archived;解析生成的规则路径并统计规则、自定义技能与命令;检查 feature-tracker.json 的进度与最后同步时间;读取 task_registry 并计算 ok/due/overdue/disabled/never 状态;对比 format_version 判断升级;对生成内容做哈希比对,标记 current/modified/stale;检查 ID 注册表、孤立文档、孤立 issue 与断链;在 monorepo 中按 root/child 角色刷新或引用工作区组合。

使用方式:作为技能调用,支持 --report-only 标志,仅输出状态报告并退出,不进入交互式下一步提示。非 report-only 模式下,会根据检测到的状态动态生成下一步选项,如升级、同步、重新生成、更新 CLAUDE.md、同步功能跟踪器、验证 ADR、同步文档 ID、关联 GitHub issue、执行逾期任务等,并调用对应的 /blueprint:* 命令。

适用场景:需要审计文档可追溯性、发现孤立文档或孤立 issue、检查生成内容是否被修改或过期、查看维护任务是否逾期、确认蓝图版本与配置、在 monorepo 中查看子工作区进度。

限制:该技能为只读报告,不自动执行修复;需要项目已初始化 blueprint,否则提示运行 /blueprint:init;部分统计依赖 manifest、ID 注册表、feature-tracker.json 等文件存在;具体命令行为与插件版本相关,资料未提供完整命令参数与所有边界情况。