agentleFS
ykjshenzhen2008-ship-itykjshenzhen2008-ship-it/commercial-real-estate-skills/skills/laoyang-article-excel/SKILL.md

laoyang-article-excel

Skill0 starsChanged 35 days agoMITView on GitHub

把「老杨拆商业」文章里的测算账做成 Excel,并做公式回读校验。当文章正文含测算表格(保本测算/租金承付/成本测算/敏感性分析/业态对照)、用户要求出 Excel 测算表、或要把正文表格图转成可套用参数的计算表时使用。输出老杨视觉规范 xlsx(红#C0392B表头/暗炭#2B2B2B/斑马纹#FBF3EF/末列红字加粗),并在生成后自动校验每个公式单元格的算得值是否等于文章中的数字。触发词:测算表、Excel表格、算账表、表格转Excel、生成Excl、测算模板。

The file

Files
SKILL.md

文章测算表 → Excel(生成 + 回读校验)

何时用

  • 文章正文出现「测算表见 Excel」或用户要求补 Excel
  • 用户说「这些文章里有测算表格的,都要生成 Excel」
  • 已有表格 PNG,需要一份参数可替换、公式可复算的计算表

硬约束(缺一不可)

1. 数据源优先级

  1. 文章正文 prose(最权威 —— 表格图本就由正文生成)
  2. 已有的表格 PNG → 当前模型不支持读图,且本机无 tesseract/ocrmypdf,不要浪费轮次去读图
  3. 用户口述参数

提取方式:读文章 md,逐段找含数字的句子,把参数与结果一起抄出来,先列成清单再写脚本。

2. 生成后必须回读校验(本 skill 的核心价值)

openpyxl 写公式不校验引用。多区块表极易写成空引用(结果恒为 0)或错位引用, 而脚本只会打印「✅ 生成成功」,不会报错。

所以生成后必须跑 scripts/verify_formulas.py,它:

  • load_workbook 读回公式字符串
  • 递归求值(支持 SUM / ROUND / ROUNDUP / 相对引用 / 跨表 $B$5 绝对引用)
  • 与「期望值清单」逐项比对

期望值清单必须来自文章正文,不能来自你自己对公式的理解 —— 否则错位会一起错,校验失效。

3. 取整口径必须与文章一致

文章若按取整值往下算(如「年销售 493 万」实际精确值 492.75), Excel 必须用 =ROUND(原公式,0) 对齐到同一基数,否则下游全部对不上。 派生数字(坪效/成本/利润/净利率)全部挂在取整后的单元格上。

4. 表外数据要标注

若某个池子/加总用到逐年表以外的年份(如 13 年窗口但表内只有 13 行), 必须在 Excel 里用 note 行写明「含 XXXX-XXXX 年数据,未在本表逐年列出」,否则读者无法复算。

步骤

Step 1 · 提取

读文章 md,产出参数清单 + 结果清单(结果即校验用的期望值)。

Step 2 · 写生成脚本

用 scripts/template_generator.py 的骨架(含 put_table / sheet_init / {H} 占位机制)。

行号规划铁律:

  • put_table(ws, header_row, headers, rows) 返回 header_row + 1 + len(rows)
  • 在每个区块上方写注释 # —— XX区:header=N,数据 N+1..N+M ——
  • 跨区块引用用绝对引用 $B$5,并手工推演一遍行号
  • 区块内引用用 {H} / {H+1} 占位符,脚本自动替换为表头行 ± 偏移

Step 3 · 生成 + 校验

PY=$HOME/.workbuddy/binaries/python/envs/default/bin/python
$PY 生成脚本.py
$PY scripts/verify_formulas.py 测算表格/NN_xxx.xlsx --expect expect.json

或直接把期望值写进脚本的 EXPECT dict 跑。

Step 4 · 校验不过怎么改

症状原因
算得 0引用到空单元格 → 行号或列号错位,打印该表所有行的 A 列标签定位
算得值 = 别的行的值行号整体 ±1(多因 r += 1 / r += 2 记错)
算得值对但小数不对取整口径不一致,回到正文确认基准
公式原样显示{H} 占位未替换 → 检查 regex 是否支持 {H+1}(不能只 replace 字面量 {H})

Step 5 · 回填文章

Excel 文件名写进正文(「测算表见同目录 Excel《NN_xxx.xlsx》」), Excel 标题写「源:文章NN 正文」,形成双向可追溯。 若校验过程改了文章数字 → 重新跑 md2docx_v2.py 生成 docx。

老杨视觉规范(写进生成器)

红 #C0392B 表头(白字加粗) / 暗炭 #2B2B2B 正文 / 斑马纹 #FBF3EF(奇数行)
末列红字加粗(结果列) / 字体 PingFang HK / 关网格线 showGridLines=False
可选高亮 #FFF2CC(敏感性/判定行)

运行环境

必须用 $HOME/.workbuddy/binaries/python/envs/default/bin/python (3.11 venv,含 openpyxl/python-docx;managed 的 3.11.9/3.13.12 都没有)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.