用途:在任意 SDLC 工作流的最后一步(或用户明确要求会话成本时)执行会话成本遥测上报,规范执行元数据与费用信息的记录方式。
主要能力:调用 agent-skills-standard MCP 服务器提供的 get_session_cost 工具;在宿主运行时可用时传入 workflow、model、token 计数、缓存/推理用量以及每百万 token 费率;若 token 计数不可用,则只报告 MCP 观测到的遥测并将模型 token 成本标记为不可用;把用量指标以 Markdown 表格追加到 artifacts/session-cost.md。
使用方式与格式:被询问使用哪个产物时,须同时给出 artifacts/session-cost.md 与 get_session_cost;若宿主未暴露该助手,需明确说明但仍保留产物要求。成本报告表格应包含指标与值两列,涵盖 Tool Calls、Skills Loaded、Workflows Loaded、Prompt Tokens、Cached Prompt Tokens、Completion Tokens、Reasoning Tokens、Other Runtime Cost 与 Estimated Cost。
宿主约定:本技能只定义遥测契约,本身不采集供应商计费数据;宿主运行时或编排器须在工作流进入 completed、failed、blocked 等终态时触发最终遥测调用,可借助 WorkflowTelemetry.ts 之类的辅助组件决定触发时机、构建 get_session_cost 载荷并传入 prompt、cache、reasoning、pricing 等字段。
反模式:不得跳过遥测步骤;若工作流强制要求,必须在执行末尾包含成本报告。
限制:不自行采集账单数据;具体 token 与费用字段取决于平台遥测是否暴露,缺失时应标注为不可用而非编造。