SuperAPI AI 工具集

invoice-generator

办公与效率

查看项目

更新于 10-23 23:06

技能介绍

invoice-generator 是一个面向 CocoPlus 功能体系的 V2 原生技能契约,用于替代原有的 cocometer/invoice-generator 实现路径。它不是独立的发票产品,而是一份描述“如何正确执行该功能行为”的规范。

用途方面,该技能的目标是在 Coco 原生能力范围内完成发票生成相关功能的确定性行为,产出或更新所属功能文档中约定的产物文件,并保证输出 schema 与现有读取方兼容。

主要能力与约束包括:保留所属功能技能中记录的产物路径、schema 和用户可见输出;不将旧版脚本调用作为实现路径;优先采用确定性的文件解析与结构化产物,避免用自由文本生成机器可读状态;如需外部副作用,沿用所属功能相同的门控与确认语义;在需要时可使用 Read、Write、Edit,仅在宿主明确需要时使用 Bash,需要数据访问时使用 Snowflake 工具,需要独立审查时使用子代理。

使用方式上,执行者应以该契约为依据,读取和写入约定的产物,进行结构化解析,并在退出前确认产物已产出或更新、schema 保持兼容、且不依赖已注册运行时脚本调用。契约还给出反合理化提示:不能因为文件存在就视为完成,小型命令同样会改变状态或引导执行,仍需保留相同的检查与门控。

适用场景为在 CocoPlus 体系内以 V2 原生方式复现发票生成功能的文件处理与产物输出流程。限制在于:具体发票字段、模板、金额计算规则、输出文件格式和外部副作用类型在资料中暂未提供;该技能本身不提供发票业务规则说明。