用途:token-report 用于为指定 story 生成 token 用量汇总报告。用法为 /token-report STORY-XXX,参数为 story ID(如 STORY-001、WRKF-1021)。
主要能力:先通过 kb_get_story 定位 story,若 KB 中不存在则提示需先经 KB 工作流创建。随后用 kb_search 查询 type 为 token_usage 的记录,返回各阶段的 phase、input_tokens、output_tokens、timestamp,并按阶段聚合。报告写入 KB:kb_write_artifact,artifact_type 为 evidence,artifact_name 为 TOKEN-SUMMARY。
报告内容:阶段明细表(输入、输出、合计、占比)、成本估算(按 Claude Opus 定价,输入 $0.003/1K、输出 $0.015/1K)、高成本操作(超过 30,000 token 的阶段)、与典型预算的对比及差异百分比、时间线(首末记录与时长)、原始日志。典型预算参考:PM 阶段 50,000,Dev 阶段 100,000,QA 阶段 50,000,完整生命周期 200,000。
前置条件:KB 中必须已有该 story 的 token 记录(通过 /token-log 记录)。若无记录则停止并提示先运行 /token-log。若 KB 查询失败,报告错误并建议检查 KB MCP 服务器是否运行。
输出:生成后报告总 token 数、估算成本、阶段数、最高阶段及预算状态(低于/符合/超出预算),并说明 TOKEN-SUMMARY 已写入该 story。
限制:依赖 KB 与 MCP 环境;成本估算基于资料给出的 Claude Opus 单价,未提供其他模型定价;未提供安装方式与平台信息。