From 1f9e0b0a03f2e99b41b0b802c3f52c5815a6b079 Mon Sep 17 00:00:00 2001
From: Yige <a@wyr.me>
Date: Fri, 4 Sep 2026 12:22:39 -0400
Subject: [PATCH] =?UTF-8?q?chore(invoice-organizer):=201.0.1=20=E2=80=94?=
 =?UTF-8?q?=E2=80=94=20=E9=87=8D=E6=96=B0=20pin=20=E5=88=B0=E5=B7=B2?=
 =?UTF-8?q?=E5=90=88=E5=B9=B6=20commit=20/=20repin=20to=20merged=20commit?=
 =?UTF-8?q?=20(#121)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## 背景 / Background

接 [#120](https://github.com/desirecore/market/pull/120)。那个 PR
只改了技能内容，**刻意没动版本号与 pin**——`contentSource.ref` 必须指向**已合并的 commit**，而那个
SHA 在合并前并不存在。先 bump 版本会让目录声称 1.0.1、却仍按指向 1.0.0 内容的 pin 去取文件，比不 bump
更糟。这是 #117/#118 那次两步发布的同一条约束。

Follow-up to #120, which deliberately left the version and pin
untouched: `contentSource.ref` must point at an already-merged commit,
which did not exist until #120 landed.

## 改动 / Changes

- `agent.json#contentSource.ref`、sidecar 的 `provenance.content.ref` 与
`governance.compliance.reviewedRef` **三处同步** pin 到 `7560a58`
- 版本 `1.0.0` → `1.0.1`（`agent.json` 与 sidecar `release.version` 两处一致）
- 补 1.0.1 changelog（中英双语）

## 1.0.1 修了什么 / What 1.0.1 fixes

三条都是真机整理实测撞出来的 Agent 侧规格洞，不是模型不听话：

| 缺陷 | 实测现象 | 根因 |
| --- | --- | --- |
| 归档路径 | 五轮里有两轮归成 `<工作目录>/2022/11/增值税电子普通发票/2022-11-18_….pdf`——同时违反「缺
`归档/` 首层」「多插一层 `<发票类型>/`」「日期用 `YYYY-MM-DD` 而非八位连写」三条 |
原文只用一句散文说了路径，上下文压缩后凭印象重建就会漂 |
| 报告文件名 | 三轮全部写出 `报告/整理报告-<运行日期>.md` | 技能只定义了 `报告/<YYYY-MM>.md`，多月场景无从填写
|
| 台账表数量 | 只有 1 张发票时产出三张表（省了「按销售方汇总」） | 技能写了「四张表，顺序固定」但没说「即使为空也必须存在」 |

前两条的共同点：**只跑一遍、或只跑成功的那遍，都看不见**。归档路径在早期几轮全对，是在同一会话被压缩之后才走样的。

All three are spec gaps found by repeated real-machine runs, not model
disobedience — and the first two are only visible across multiple runs
in the same (compacted) conversation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
---
 agents/invoice-organizer/agent.json           | 20 +++++++++++++++++--
 .../catalog-metadata.v1.json                  |  6 +++---
 2 files changed, 21 insertions(+), 5 deletions(-)

diff --git a/agents/invoice-organizer/agent.json b/agents/invoice-organizer/agent.json
index c11c33e..185273c 100644
--- a/agents/invoice-organizer/agent.json
+++ b/agents/invoice-organizer/agent.json
@@ -17,7 +17,7 @@
     "finance",
     "email"
   ],
-  "version": "1.0.0",
+  "version": "1.0.1",
   "updatedAt": "2026-09-04",
   "maintainer": {
     "name": "DesireCore Official",
@@ -124,6 +124,22 @@
     "tools": []
   },
   "changelog": [
+    {
+      "version": "1.0.1",
+      "date": "2026-09-04",
+      "changes": {
+        "zh-CN": [
+          "归档路径改成四条可逐项对照的硬规则（归档/年/月 + YYYYMMDD 八位日期），并写入实测踩到的错误形态",
+          "报告文件名按「本次入账发票的开票月份落在几个 YYYY-MM」决定：同月写 <YYYY-MM>.md，跨月写 <最早>_<最晚>.md；禁止用运行日期命名",
+          "台账四张表必须全建：即使某张表零行也要建出表头，不许因为数据少而省略「按销售方汇总」"
+        ],
+        "en-US": [
+          "Archive path pinned to four checkable rules (归档/year/month + 8-digit YYYYMMDD date), with the observed wrong forms written into the skill",
+          "Report filename now keyed on how many distinct YYYY-MM the run's invoice issue dates span; run-date filenames are forbidden",
+          "All four ledger sheets must always be created with their header row, even when a sheet would be empty"
+        ]
+      }
+    },
     {
       "version": "1.0.0",
       "date": "2026-09-04",
@@ -145,6 +161,6 @@
     "kind": "git",
     "repoUrl": "https://github.com/desirecore/market.git",
     "path": "agents/invoice-organizer",
-    "ref": "42a29e99a06b0387250b31d4bbe1515c7406694f"
+    "ref": "7560a586426f5575eb86b0de0498f9b5cebe1751"
   }
 }
diff --git a/agents/invoice-organizer/catalog-metadata.v1.json b/agents/invoice-organizer/catalog-metadata.v1.json
index 4f9c898..2cd03b6 100644
--- a/agents/invoice-organizer/catalog-metadata.v1.json
+++ b/agents/invoice-organizer/catalog-metadata.v1.json
@@ -30,7 +30,7 @@
   },
   "release": {
     "state": "known",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "versionScheme": "semver"
   },
   "timestamps": {
@@ -58,7 +58,7 @@
       "kind": "git",
       "url": "https://github.com/desirecore/market.git",
       "path": "agents/invoice-organizer",
-      "ref": "42a29e99a06b0387250b31d4bbe1515c7406694f"
+      "ref": "7560a586426f5575eb86b0de0498f9b5cebe1751"
     }
   },
   "governance": {
@@ -75,7 +75,7 @@
     },
     "compliance": {
       "licenseEvidencePath": "LICENSE",
-      "reviewedRef": "42a29e99a06b0387250b31d4bbe1515c7406694f",
+      "reviewedRef": "7560a586426f5575eb86b0de0498f9b5cebe1751",
       "reviewedAt": "2026-09-04",
       "reviewedBy": "yi-ge",
       "upstreamEndorsed": true