structured-output 的用途是在最终整理任何评审或分析结果时,按一致的结构格式化交付物,使发现项可比较、可共享,并明确下一步行动。资料指出,它适合在向干系人汇报或提交文档之前使用;不适合在分析过程中采集证据(应使用 proof-of-work),也不适合用于查看改动(应先使用 diff-analysis 或 review-core)。
主要能力与使用方式按四步组织,并配合 TodoWrite 条目推进:第一步选择模板,根据交付物类型选用评审报告(摘要、发现、建议、证据)、PR 描述(摘要、改动、测试计划、备注)、发布说明(亮点、破坏性变更、修复、致谢)或事故报告(时间线、影响、根因、补救);第二步格式化发现,统一使用带严重级别、位置、锚点、类别、描述、证据与建议的结构。严重级别为 CRITICAL、HIGH、MEDIUM、LOW、INFO,按严重级别和文件位置排序。锚点为必填项,需逐字复制所在行的源码文本,不能改写;若锚点未出现在所引用行,该发现会被视为幻觉并丢弃,这一步由 imbue:review-core 第 5 步运行 plugins/imbue/scripts/citation_verifier.py 机械校验;第三步把发现转为行动项,包含负责人与 P1/P2/P3 优先级,并标注依赖;第四步附上附录,含已运行命令的完整证据日志、外部引用与原始数据,保持正文简洁、细节放入附录。
使用限制与注意:触发关键词包括 format、structure、deliverable、report、organize、present、consistent,以及“把结果整理成报告”“统一格式”“便于干系人理解”等表述。资料多处提示“运行带 --help 的命令以验证可用性”,但未给出具体命令名称。输出前需自查:每条发现都有可通过校验器解析的逐字锚点、都有证据引用、严重级别有据、建议具体并指明下一步、无孤立章节或占位文本、格式在目标平台(GitHub、Confluence 等)正确渲染。完成标准是待办完成并产出格式化交付物、遵循所选模板、干系人无需追问即可行动。