GridCraft 场景操作手册,按业务场景提供具体 CLI/MCP 命令、参数与检查步骤。使用前先读取真实输入,再按类别选择流程;示例数据不代表实际业务事实,每条默认新建空文件,不直接覆盖原稿。
场景分类 finance(2条):报价明细、折扣与税额、商品毛利与零收入边界。 operations(4条):库存低于安全线的补货清单、费用报销超限复核、交付验收比例与缺失项、项目任务表结构化与冻结表头。 analysis(4条):供应商多维加权评分、销售额排行且整行保持对应、销售区域汇总并建立图表、月度增长率与零基期处理。 quality(2条):订单重复键标记而不删记录、受控状态下拉录入。
调用与会话 宿主已打开内嵌编辑器时,使用同一 MCP 会话,等待 editor_status 就绪;读取宿主工具 schema 后以 run_command {"command":"方法ID","params":{…}} 逐条执行。工具名与参数因宿主适配有差异,不能把独立 CLI 文件改动称为同画面编辑。
独立 CLI 语法:gridcraft-cli run --cmd <id=JSON> --out output.xlsx --quiet。每个 --cmd 值为方法 ID、等号、JSON 对象组成的一个 argv 参数。整组步骤放在同一次 run 中,避免光标、当前表格、图形选择丢失。以 0.7.0 原生 CLI 命令目录为观察依据,执行前查询实际版本和 schema。保存后新进程重开,检查内容、公式或对象;导出格式另行检查。
读取数据 gridcraft-cli cat 返回格式化显示值,例如 35.0%。读取计算值应在 run 中执行 sheet.read {"range":"E2","formulas":false,"formatted":false};读取公式另行调用 formulas:true;不要将显示文本解析成底层金额或比率。
技能商店场景经验 遇到保留可重算的报价模型、标记重复而不丢失记录、增长率的零基期边界时,读取商店工作流适配,使用对应的 Craft 方法和实际结果检查。上游技能不作为运行依赖。
相关办公模板技能(开发候选,尚未进入主市场新版本,使用新建的本任务工作表,不覆盖原表) 跨午夜班次工时与缺失行核对:gridcraft-shift-timesheet;安装:npx skills add full-aigc-skills/gridcraft-skills --skill gridcraft-shift-timesheet。 固定名义年利率等额月供、零利率与无效期数检查:gridcraft-fixed-payment;安装:npx skills add full-aigc-skills/gridcraft-skills --skill gridcraft-fixed-payment。 周一起始、闰年与相邻月日期的月历模板:gridcraft-month-calendar;安装:npx skills add full-aigc-skills/gridcraft-skills --skill gridcraft-month-calendar。
限制说明 结构化步骤含测试输入的可观察断言;命令证据仅证明方法在固定运行时被观察,不证明场景效果已验收。来源与许可记录借鉴的 GitHub 工作流事实,正文与参数例子为原创适配,未执行外部 Office 脚本。真实业务及宿主同步仍需验收。