sheet-edit 更名 sheet 并扩语义为「读+安全修改」:① 目录/frontmatter/文档全部改名(引用面零残留);description 重写为路由优先——列全格式 xls/xlsx/csv/ods、inspect 读结构与定位、apply/cells 最小改动、自带四重保障、明确「不用于新建工作簿」。命名讨论定稿:弃 excel/xlsx(名字越强,「帮我生成个excel」的误召唤越难用描述压住),sheet 中性、召回靠 description 行补足。② set/cells 的 old 改为可选:省略=断言目标格为空再写入(填空/补列/给插入行补公式的正经出口),非空拒写并报当前值;改已有值必须给 old——保障链不变,只是把「写新内容」纳入技能,杜绝 AI 为此绕道手改。③ skills.js 落地 required 机制:frontmatter required:true → prompt 列表行首标 **required**,用户在 system-prompt 模板写的「Skills marked **required** must be used」条款自此有了作用对象(sheet 首个标记);此前该条款空转。④ 重启验证:skills=data-page,img-utils,sheet,x2pdf,prompt 快照含 **required** sheet 且零 sheet-edit 残留;容器 8 项功能回归全过
This commit is contained in:
@@ -1,16 +1,17 @@
|
||||
---
|
||||
name: sheet-edit
|
||||
description: 结构化修改表格文件。内容定位(列名 + 值),最小改动。支持改值、改公式、插入/删除行列,公式引用自动调整。
|
||||
name: sheet
|
||||
description: 表格文件(xls/xlsx/csv/ods)的读取与安全修改。inspect 看结构/公式/表头定位;apply 按「列名+值」或 cells 地址最小改动,自带 old 校验、全簿逐格自检、公式引用调整与自动重算。不用于新建工作簿、图表生成。
|
||||
required: true
|
||||
---
|
||||
|
||||
# sheet-edit
|
||||
# sheet
|
||||
|
||||
## 调用形式(重要)
|
||||
|
||||
本技能通过 `skill` 工具执行,完整调用是:
|
||||
|
||||
```json
|
||||
{"op": "run", "name": "sheet-edit", "input_args": {"action": "inspect", "file": "预算表.xlsx"}}
|
||||
{"op": "run", "name": "sheet", "input_args": {"action": "inspect", "file": "预算表.xlsx"}}
|
||||
```
|
||||
|
||||
外层 `op`(固定为 run)属于 skill 工具;**下文所有 JSON 示例都是 `input_args` 的内容**,其动作键是 `action`,不要与外层 `op` 混淆。
|
||||
@@ -112,13 +113,14 @@ description: 结构化修改表格文件。内容定位(列名 + 值),最
|
||||
"changes": [
|
||||
{"sheet": "总表", "cells": {
|
||||
"D4": {"old": 157, "new": 190},
|
||||
"F4": {"old": 120, "new": 150}
|
||||
"H4": {"new": "=D4*0.9"}
|
||||
}}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
- 地址从 inspect 的 `preview`(含列坐标提示)/`formulas` 里数出来;允许可选 `$`(`$D$4` 同 `D4`)
|
||||
- 每个地址的 `old` 同样可选(省略 = 空格断言),与 `set` 语义一致
|
||||
- old 校验、合并区防护、全簿逐格自检、LO 重算与列名模式**完全同源**,不是降级通道
|
||||
|
||||
### 定位
|
||||
@@ -135,7 +137,7 @@ description: 结构化修改表格文件。内容定位(列名 + 值),最
|
||||
{"set": {"单价": {"old": 157, "new": 180}}}
|
||||
```
|
||||
|
||||
`old` 必须与实际值一致,否则整体报错,不做任何改动。
|
||||
`old` 可省:**省略 = 断言目标格当前为空再写入**(填空/补列/补公式场景);改已有值必须给 `old`,不一致则整体报错、不做任何改动。
|
||||
|
||||
### 改公式
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
"""sheet-edit 内部库。"""
|
||||
"""sheet 内部库。"""
|
||||
|
||||
|
||||
class UserError(Exception):
|
||||
@@ -1,4 +1,4 @@
|
||||
"""sheet-edit 的各个 op 实现。"""
|
||||
"""sheet 的各个 op 实现。"""
|
||||
import datetime
|
||||
import re
|
||||
import shutil
|
||||
@@ -128,11 +128,20 @@ def apply(args):
|
||||
plan.extend(_resolve_change(wb, ch, header_row))
|
||||
|
||||
for item in plan:
|
||||
if not locate.value_eq(item['expected_old'], item['actual_old']):
|
||||
# csv 往返的空串视同空格;省略 old = 空格断言,给了 old = 精确校验
|
||||
act = None if item['actual_old'] == '' else item['actual_old']
|
||||
exp = item['expected_old']
|
||||
if exp is _MISSING:
|
||||
if act is not None:
|
||||
raise UserError(
|
||||
f"目标格非空,拒绝无 old 写入: {item['sheet']} 第 {item['row']} 行 "
|
||||
f"'{item['col_name']}' 当前为 {act!r}(填空应保证目标为空;改已有值必须提供 old)"
|
||||
)
|
||||
elif not locate.value_eq(exp, act):
|
||||
raise UserError(
|
||||
f"旧值不匹配: {item['sheet']} 第 {item['row']} 行 "
|
||||
f"'{item['col_name']}': 期望 {item['expected_old']!r}, "
|
||||
f"实际 {_json_safe(item['actual_old'])!r}"
|
||||
f"'{item['col_name']}': 期望 {exp!r}, "
|
||||
f"实际 {_json_safe(act)!r}"
|
||||
)
|
||||
|
||||
before = _snapshot(wb)
|
||||
@@ -209,6 +218,9 @@ def _resolve_change(wb, ch, header_row):
|
||||
|
||||
_ADDR_RE = re.compile(r'^\$?([A-Za-z]{1,3})\$?(\d{1,7})$')
|
||||
|
||||
# set/cells 的 old 缺省哨兵:省略 old = 断言目标格当前为空再写入(填空);改已有值必须显式 old。
|
||||
_MISSING = object()
|
||||
|
||||
|
||||
def _resolve_cells(ws, sheet, cells_spec):
|
||||
"""地址模式:cells = {"C5": {"old": ..., "new": ...}, ...}。多级表头等列名不可用场景的正经出口,
|
||||
@@ -227,8 +239,8 @@ def _resolve_cells(ws, sheet, cells_spec):
|
||||
|
||||
|
||||
def _mk_item(ws, sheet, row, col, label, spec, match_info):
|
||||
if not isinstance(spec, dict) or 'old' not in spec or 'new' not in spec:
|
||||
raise UserError(f"'{label}' 的设值必须是 {{\"old\": ..., \"new\": ...}} 格式")
|
||||
if not isinstance(spec, dict) or 'new' not in spec:
|
||||
raise UserError(f"'{label}' 的设值必须是 {{\"new\": ..., \"old\": 可选...}} 格式")
|
||||
actual = ws.cell(row, col).value
|
||||
if isinstance(actual, ArrayFormula):
|
||||
raise UserError(
|
||||
@@ -244,7 +256,7 @@ def _mk_item(ws, sheet, row, col, label, spec, match_info):
|
||||
'col': col,
|
||||
'col_name': label,
|
||||
'match': match_info,
|
||||
'expected_old': spec['old'],
|
||||
'expected_old': spec['old'] if 'old' in spec else _MISSING,
|
||||
'actual_old': actual,
|
||||
'new': new,
|
||||
}
|
||||
@@ -1,6 +1,6 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""sheet-edit 技能入口。接收一个 JSON 参数,按其中 action 键分发(旧键名 op 仍兼容)。"""
|
||||
"""sheet 技能入口。接收一个 JSON 参数,按其中 action 键分发(旧键名 op 仍兼容)。"""
|
||||
import json
|
||||
import sys
|
||||
from pathlib import Path
|
||||
Reference in New Issue
Block a user