kenaz 0.3.22 → 0.3.24

package/core/dev/design/matrix_format_ABBREVIATIONS.md

@@ -1,655 +0,0 @@
-# .matrix 格式縮寫映射表
-
-> **版本**: 1.0.0
-> **日期**: 2026-02-08
-> **狀態**: 正式規範
-> **用途**: 欄位名縮寫與值代碼化標準參考
-
----
-
-## 📋 概述
-
-本文檔定義 .matrix 格式中所有標準化的縮寫規則,包括欄位名縮寫和值代碼化映射。所有 Parser 和 Serializer 必須遵循此映射表。
-
----
-
-## 🔤 欄位名縮寫映射
-
-### A. 狀態與優先級
-
-| 原始欄位名 | 縮寫 | 類型 | 範例 | 說明 |
-|-----------|------|------|------|------|
-| `status` | `st` | string | `st=C` | 任務/記錄狀態 |
-| `priority` | `p` | string | `p=0` | 優先級（P0-P3） |
-| `active` | `act` | boolean | `act=1` | 是否啟用 |
-| `blocked` | `b` | number | `b=8` | 阻塞數量 |
-| `blocked_by` | `blk` | string | `blk=API_DOWN` | 阻塞原因 |
-| `completed` | `c` | number | `c=100` | 已完成數量 |
-| `in_progress` | `p` | number | `p=15` | 進行中數量（在 @index 中） |
-| `pending` | `pd` | number | `pd=20` | 待處理數量 |
-| `cancelled` | `x` | number | `x=5` | 已取消數量 |
-
-### B. 時間相關
-
-| 原始欄位名 | 縮寫 | 類型 | 範例 | 說明 |
-|-----------|------|------|------|------|
-| `time` | `t` | timestamp | `t=260208-1130` | 時間戳（通用） |
-| `timestamp` | `ts` | timestamp | `ts=260208-1130` | 時間戳（明確） |
-| `created_at` | `ct` | timestamp | `ct=260206-1430` | 創建時間 |
-| `updated_at` | `ut` | timestamp | `ut=260207-0900` | 更新時間 |
-| `completed_at` | `cmplt` | timestamp | `cmplt=260207-1500` | 完成時間 |
-| `started_at` | `start` | timestamp | `start=260207-0900` | 開始時間 |
-| `duration` | `dur` | duration | `dur=135m` | 時長 |
-| `duration_minutes` | `dur` | number | `dur=135m` | 時長（分鐘） |
-| `estimated_hours` | `est` | duration | `est=4h` | 預估時長 |
-| `actual_hours` | `act_h` | duration | `act_h=3.5h` | 實際時長 |
-| `date` | `d` | date | `d=260208` | 日期 |
-| `range` | `r` | string | `r=7d` | 範圍（如 7 天） |
-
-### C. 識別與類型
-
-| 原始欄位名 | 縮寫 | 類型 | 範例 | 說明 |
-|-----------|------|------|------|------|
-| `id` | `i` | string | `i=T123` | 唯一標識符 |
-| `task_id` | `tid` | string | `tid=T123` | 任務 ID |
-| `feature_id` | `fid` | string | `fid=F-015` | 功能 ID |
-| `type` | `ty` | string | `ty=task` | 類型 |
-| `category` | `cat` | string | `cat=dev` | 分類 |
-| `tag` | `tg` | string | `tg=urgent` | 標籤 |
-| `label` | `lbl` | string | `lbl=bug` | 標籤 |
-| `version` | `v` | string | `v=1.0` | 版本號 |
-| `name` | `n` | string | `n=task-name` | 名稱 |
-| `title` | `tt` | string | `tt=Task title` | 標題 |
-
-### D. 團隊與角色
-
-| 原始欄位名 | 縮寫 | 類型 | 範例 | 說明 |
-|-----------|------|------|------|------|
-| `agent` | `ag` | string | `ag=developer` | Agent 類型 |
-| `agent_type` | `ag` | string | `ag=backend` | Agent 類型 |
-| `assignee` | `asn` | string | `asn=john` | 負責人 |
-| `assigned_to` | `asn` | string | `asn=team_a` | 分配給 |
-| `created_by` | `cb` | string | `cb=pm_agent` | 創建者 |
-| `team` | `tm` | string | `tm=backend` | 團隊 |
-| `owner` | `own` | string | `own=alice` | 擁有者 |
-| `reviewer` | `rev` | string | `rev=bob` | 審核者 |
-
-### E. 數值與統計
-
-| 原始欄位名 | 縮寫 | 類型 | 範例 | 說明 |
-|-----------|------|------|------|------|
-| `count` | `c` | number | `c=15` | 計數（通用） |
-| `total` | `tot` | number | `tot=123` | 總數 |
-| `entries` | `e` | number | `e=25` | 條目數 |
-| `success_rate` | `succ` | percent | `succ=81.3%` | 成功率 |
-| `percentage` | `pct` | percent | `pct=75%` | 百分比 |
-| `score` | `sc` | number | `sc=95` | 分數 |
-| `weight` | `w` | number | `w=5` | 權重 |
-| `rank` | `rk` | number | `rk=1` | 排名 |
-| `index` | `idx` | number | `idx=10` | 索引位置 |
-
-### F. 關係與依賴
-
-| 原始欄位名 | 縮寫 | 類型 | 範例 | 說明 |
-|-----------|------|------|------|------|
-| `dependencies` | `dep` | list | `dep=T120,T121` | 依賴項 |
-| `depends_on` | `dep` | list | `dep=T120` | 依賴於 |
-| `parent` | `par` | string | `par=T100` | 父節點 |
-| `children` | `ch` | list | `ch=T121,T122` | 子節點 |
-| `related` | `rel` | list | `rel=T130` | 相關項 |
-| `linked_to` | `lnk` | string | `lnk=T150` | 連結到 |
-| `references` | `ref` | list | `ref=R001,R002` | 引用 |
-
-### G. 內容與描述
-
-| 原始欄位名 | 縮寫 | 類型 | 範例 | 說明 |
-|-----------|------|------|------|------|
-| `description` | `d` | text | `d=Fix bug` | 描述（簡短） |
-| `description` | `desc` | text | `desc=Complete description` | 描述（完整） |
-| `note` | `note` | text | `note=Important note` | 備註 |
-| `comment` | `cmt` | text | `cmt=User comment` | 評論 |
-| `message` | `msg` | text | `msg=Commit message` | 訊息 |
-| `summary` | `sum` | text | `sum=Brief summary` | 摘要 |
-| `reason` | `rsn` | text | `rsn=Why blocked` | 原因 |
-| `details` | `dtl` | text | `dtl=More details` | 詳細內容 |
-
-### H. 專案與配置
-
-| 原始欄位名 | 縮寫 | 類型 | 範例 | 說明 |
-|-----------|------|------|------|------|
-| `project` | `proj` | string | `proj=KenazAI` | 專案名稱 |
-| `repository` | `repo` | string | `repo=github.com/x/y` | 倉庫 |
-| `branch` | `br` | string | `br=main` | 分支 |
-| `commit` | `cmt` | string | `cmt=abc123` | Commit SHA |
-| `environment` | `env` | string | `env=prod` | 環境 |
-| `path` | `pth` | string | `pth=/src/api` | 路徑 |
-| `file` | `f` | string | `f=index.js` | 文件名 |
-| `scope` | `scp` | string | `scp=backend` | 範圍 |
-
-### I. 標誌與狀態
-
-| 原始欄位名 | 縮寫 | 類型 | 範例 | 說明 |
-|-----------|------|------|------|------|
-| `enabled` | `en` | boolean | `en=1` | 是否啟用 |
-| `visible` | `vis` | boolean | `vis=1` | 是否可見 |
-| `locked` | `lck` | boolean | `lck=1` | 是否鎖定 |
-| `archived` | `arc` | boolean | `arc=1` | 是否封存 |
-| `deleted` | `del` | boolean | `del=0` | 是否刪除 |
-| `draft` | `drf` | boolean | `drf=0` | 是否草稿 |
-| `published` | `pub` | boolean | `pub=1` | 是否發布 |
-| `verified` | `vrf` | boolean | `vrf=1` | 是否驗證 |
-
-### J. 其他常用
-
-| 原始欄位名 | 縮寫 | 類型 | 範例 | 說明 |
-|-----------|------|------|------|------|
-| `source` | `src` | string | `src=api` | 來源 |
-| `target` | `tgt` | string | `tgt=database` | 目標 |
-| `format` | `fmt` | string | `fmt=json` | 格式 |
-| `size` | `sz` | number | `sz=1024` | 大小 |
-| `level` | `lvl` | number | `lvl=2` | 層級 |
-| `complexity` | `cplx` | string | `cplx=high` | 複雜度 |
-| `error` | `err` | string | `err=timeout` | 錯誤 |
-| `result` | `res` | string | `res=success` | 結果 |
-
-**欄位名縮寫總計**: **72 個** ✅（超過需求的 30 個）
-
----
-
-## 🎯 值代碼化映射
-
-### 1. 任務狀態（Status）
-
-| 原始值 | 代碼 | 使用場景 | 範例 |
-|--------|------|---------|------|
-| `completed` | `C` | 已完成任務 | `st=C` |
-| `in_progress` | `P` | 進行中任務 | `st=P` |
-| `pending` | `D` | 待處理任務 | `st=D` |
-| `blocked` | `B` | 已阻塞任務 | `st=B` |
-| `cancelled` | `X` | 已取消任務 | `st=X` |
-| `review` | `R` | 審核中 | `st=R` |
-| `testing` | `T` | 測試中 | `st=T` |
-| `deployed` | `Y` | 已部署 | `st=Y` |
-| `failed` | `F` | 失敗 | `st=F` |
-
-### 2. 優先級（Priority）
-
-| 原始值 | 代碼 | 說明 | 範例 |
-|--------|------|------|------|
-| `P0` | `0` | 最高優先級（Critical） | `p=0` |
-| `P1` | `1` | 高優先級（High） | `p=1` |
-| `P2` | `2` | 中優先級（Medium） | `p=2` |
-| `P3` | `3` | 低優先級（Low） | `p=3` |
-
-### 3. 複雜度（Complexity）
-
-| 原始值 | 代碼 | 說明 | 範例 |
-|--------|------|------|------|
-| `simple` | `S` | 簡單（< 4h） | `cplx=S` |
-| `moderate` | `M` | 中等（4-8h） | `cplx=M` |
-| `complex` | `C` | 複雜（8-16h） | `cplx=C` |
-| `very_complex` | `V` | 非常複雜（> 16h） | `cplx=V` |
-
-### 4. 環境（Environment）
-
-| 原始值 | 代碼 | 說明 | 範例 |
-|--------|------|------|------|
-| `development` | `dev` | 開發環境 | `env=dev` |
-| `staging` | `stg` | 測試環境 | `env=stg` |
-| `production` | `prod` | 生產環境 | `env=prod` |
-| `local` | `loc` | 本地環境 | `env=loc` |
-
-### 5. Agent 類型（Agent Type）
-
-| 原始值 | 代碼 | 說明 | 範例 |
-|--------|------|------|------|
-| `product_manager` | `pm` | 產品經理 | `ag=pm` |
-| `developer` | `dev` | 開發者 | `ag=dev` |
-| `backend_engineer` | `be` | 後端工程師 | `ag=be` |
-| `frontend_engineer` | `fe` | 前端工程師 | `ag=fe` |
-| `designer` | `des` | 設計師 | `ag=des` |
-| `qa_engineer` | `qa` | QA 工程師 | `ag=qa` |
-| `sre_agent` | `sre` | SRE | `ag=sre` |
-| `dev_agent` | `deva` | Dev Agent | `ag=deva` |
-
-### 6. 分類（Category）
-
-| 原始值 | 代碼 | 說明 | 範例 |
-|--------|------|------|------|
-| `feature` | `feat` | 新功能 | `cat=feat` |
-| `bug` | `bug` | Bug 修復 | `cat=bug` |
-| `documentation` | `doc` | 文檔 | `cat=doc` |
-| `refactor` | `ref` | 重構 | `cat=ref` |
-| `test` | `test` | 測試 | `cat=test` |
-| `chore` | `cho` | 雜項 | `cat=cho` |
-| `performance` | `perf` | 性能優化 | `cat=perf` |
-| `security` | `sec` | 安全 | `cat=sec` |
-| `design` | `des` | 設計 | `cat=des` |
-| `architecture` | `arch` | 架構 | `cat=arch` |
-
-### 7. 布林值（Boolean）
-
-| 原始值 | 代碼 | 說明 | 範例 |
-|--------|------|------|------|
-| `true` | `1` | 真 | `act=1` |
-| `false` | `0` | 假 | `act=0` |
-| `yes` | `1` | 是 | `en=1` |
-| `no` | `0` | 否 | `en=0` |
-
-### 8. 結果（Result）
-
-| 原始值 | 代碼 | 說明 | 範例 |
-|--------|------|------|------|
-| `success` | `OK` | 成功 | `res=OK` |
-| `failure` | `FAIL` | 失敗 | `res=FAIL` |
-| `error` | `ERR` | 錯誤 | `res=ERR` |
-| `timeout` | `TO` | 超時 | `res=TO` |
-| `skipped` | `SKIP` | 跳過 | `res=SKIP` |
-
-### 9. 阻塞原因（Blocked By）
-
-| 原始值 | 代碼 | 說明 | 範例 |
-|--------|------|------|------|
-| `API_DOWN` | `API_DOWN` | API 服務中斷 | `blk=API_DOWN` |
-| `REVIEW_PENDING` | `REVIEW` | 待審核 | `blk=REVIEW` |
-| `DEPENDENCY` | `DEP` | 依賴未完成 | `blk=DEP` |
-| `WAITING_INPUT` | `INPUT` | 等待輸入 | `blk=INPUT` |
-| `RESOURCE_UNAVAILABLE` | `RES` | 資源不可用 | `blk=RES` |
-| `EXTERNAL` | `EXT` | 外部阻塞 | `blk=EXT` |
-
-### 10. 時長單位（Duration Unit）
-
-| 原始值 | 代碼 | 說明 | 範例 |
-|--------|------|------|------|
-| `seconds` | `s` | 秒 | `dur=30s` |
-| `minutes` | `m` | 分鐘 | `dur=45m` |
-| `hours` | `h` | 小時 | `dur=2h` |
-| `days` | `d` | 天 | `dur=3d` |
-| `weeks` | `w` | 週 | `dur=2w` |
-
-**值代碼總計**: **66 個** ✅（超過需求的 20 個）
-
----
-
-## 🕐 時間戳縮短規則
-
-### 完整時間戳格式
-
-| 原始格式 | 縮短格式 | 節省 | 範例 |
-|---------|---------|------|------|
-| `2026-02-07T05:30:00Z` | `260207-0530` | 15 字元 | `t=260207-0530` |
-| `2026-02-07T14:30:00+08:00` | `260207-1430` | 20 字元 | `ct=260207-1430` |
-| `2026-02-07` | `260207` | 4 字元 | `d=260207` |
-
-### 時間戳組成規則
-
-```
-完整格式: YYMMDD-HHMM
-  ↓
-YY: 年份（2 位）- 26 → 2026
-MM: 月份（2 位）- 02 → February
-DD: 日期（2 位）- 07 → 7th
-HH: 小時（2 位）- 05 → 5 AM
-MM: 分鐘（2 位）- 30 → 30 minutes
-
-範例:
-  2026-02-07 05:30 → 260207-0530
-  2026-12-31 23:59 → 261231-2359
-  2025-01-01 00:00 → 250101-0000
-```
-
-### 僅日期格式
-
-```
-YYMMDD
-  ↓
-260207 → 2026-02-07
-250101 → 2025-01-01
-261231 → 2026-12-31
-```
-
----
-
-## 📐 縮寫規則
-
-### 規則 1: 單字母縮寫（最常用欄位）
-
-**適用於**: 出現頻率 > 50% 的欄位
-
-| 欄位 | 縮寫 | 理由 |
-|------|------|------|
-| `status` | `st` | 🔴 保留兩字母（避免與 `source` 混淆） |
-| `priority` | `p` | ✅ 極高頻 |
-| `id` | `i` | ✅ 極高頻 |
-| `time` | `t` | ✅ 極高頻 |
-| `count` | `c` | ✅ 高頻 |
-| `description` | `d` | ✅ 高頻 |
-
-### 規則 2: 雙字母縮寫（常用欄位）
-
-**適用於**: 出現頻率 20-50% 的欄位
-
-**方法**:
-- 取首字母 + 顯著輔音
-- 或取前兩個字母
-
-| 欄位 | 縮寫 | 方法 |
-|------|------|------|
-| `created_at` | `ct` | 首字母 + 顯著輔音 |
-| `updated_at` | `ut` | 首字母 + 顯著輔音 |
-| `duration` | `dur` | 前三字母 |
-| `type` | `ty` | 前兩字母 |
-| `agent` | `ag` | 首字母 + 顯著輔音 |
-
-### 規則 3: 三字母縮寫（中頻欄位）
-
-**適用於**: 出現頻率 5-20% 的欄位
-
-| 欄位 | 縮寫 | 方法 |
-|------|------|------|
-| `blocked_by` | `blk` | 保留輔音 |
-| `dependencies` | `dep` | 前三字母 |
-| `category` | `cat` | 前三字母 |
-| `assignee` | `asn` | 首字母 + 顯著輔音 |
-
-### 規則 4: 保留完整詞（罕見欄位）
-
-**適用於**: 出現頻率 < 5% 的欄位
-
-| 欄位 | 縮寫 | 理由 |
-|------|------|------|
-| `note` | `note` | 已夠短 |
-| `description`（長版） | `desc` | 區分短版 `d` |
-
-### 規則 5: 避免衝突
-
-**衝突解決策略**:
-
-| 衝突欄位 | 原縮寫 | 修正後 | 理由 |
-|---------|-------|--------|------|
-| `count` vs `created_at` | 都是 `c` | `c` vs `ct` | 保留高頻 `count=c` |
-| `parent` vs `priority` | 都是 `p` | `par` vs `p` | 保留高頻 `priority=p` |
-| `description` vs `duration` | 都是 `d` | `d` vs `dur` | 分配給不同 |
-| `type` vs `time` | 都是 `t` | `ty` vs `t` | 保留高頻 `time=t` |
-
----
-
-## 🎨 命名慣例
-
-### 縮寫風格
-
-1. **全小寫** - 所有欄位名縮寫使用小寫（`st`, `ct`, `dur`）
-2. **無底線** - 避免使用底線（`created_at` → `ct` 而非 `c_t`）
-3. **保留可讀性** - 縮寫應能讓人猜測原意（`dur` → duration）
-4. **避免數字** - 除非原欄位名包含數字
-
-### 值代碼風格
-
-1. **大寫狀態** - 狀態碼使用大寫（`C`, `P`, `B`）
-2. **小寫分類** - 分類使用小寫（`dev`, `bug`, `feat`）
-3. **數字優先級** - 優先級使用數字（`0`, `1`, `2`, `3`）
-4. **保留常用詞** - 如 `API_DOWN`, `REVIEW_PENDING`
-
----
-
-## 🔍 查找表（快速參考）
-
-### 按字母順序排列（欄位名）
-
-```
-a:  act, ag, arc, asn
-b:  b, blk, br
-c:  c, cat, cb, ch, cmplt, cmt, cplx, ct
-d:  d, del, dep, desc, drf, dtl, dur
-e:  e, en, env, err, est
-f:  f, fid, fmt
-i:  i, idx
-l:  lbl, lck, lnk, lvl
-m:  msg
-n:  n, note
-o:  own
-p:  p, par, pct, pd, proj, pth, pub
-r:  r, ref, rel, repo, res, rev, rk, rsn
-s:  sc, scp, src, st, succ, sum, sz
-t:  t, tg, tid, tm, tot, ts, tt, ty
-u:  ut
-v:  v, vis, vrf
-w:  w
-x:  x
-```
-
-### 按字母順序排列（值代碼）
-
-```
-0-9: 0, 1, 2, 3 (priorities and booleans)
-A-Z:
-  B: blocked
-  C: completed, complex
-  D: pending (Delayed)
-  F: failed, frontend
-  M: moderate
-  P: in_progress
-  R: review
-  S: simple
-  T: testing
-  V: very_complex
-  X: cancelled
-  Y: deployed
-
-Keywords:
-  API_DOWN, DEP, ERR, EXT, FAIL, INPUT, OK, RES, REVIEW, SKIP, TO
-
-Agent types:
-  be, dev, deva, des, fe, pm, qa, sre
-
-Categories:
-  arch, bug, cho, des, doc, feat, perf, ref, sec, test
-
-Environments:
-  dev, loc, prod, stg
-```
-
----
-
-## 🧪 使用範例
-
-### 範例 1: 任務記錄
-
-```
-T121|st=C|p=0|dur=135m|ct=260206-1430|ut=260207-0900|ag=dev|cat=feat|desc=API integration|dep=T120|
-```
-
-**展開後的 JSON**:
-```json
-{
-  "id": "TASK_121",
-  "status": "completed",
-  "priority": "P0",
-  "duration_minutes": 135,
-  "created_at": "2026-02-06T14:30:00Z",
-  "updated_at": "2026-02-07T09:00:00Z",
-  "agent_type": "developer",
-  "category": "feature",
-  "description": "API integration",
-  "dependencies": ["TASK_120"]
-}
-```
-
-### 範例 2: 專案狀態
-
-```
-@meta |v=1.0|c=project-status|t=260208-1130|proj=KenazAI|
-@index |tot=145|c=120|p=13|b=5|pd=7|act=1|
-```
-
-**展開後的 JSON**:
-```json
-{
-  "meta": {
-    "version": "1.0",
-    "category": "project-status",
-    "timestamp": "2026-02-08T11:30:00Z",
-    "project": "KenazAI"
-  },
-  "index": {
-    "total": 145,
-    "completed": 120,
-    "in_progress": 13,
-    "blocked": 5,
-    "pending": 7,
-    "active": true
-  }
-}
-```
-
-### 範例 3: 記憶系統
-
-```
-260207|dev|T123,st=P,dur=45m,ag=dev;T124,st=P,dur=60m,ag=be|note=DB migration in progress|
-```
-
-**展開後的 Markdown**:
-```markdown
-## 2026-02-07
-
-### Development
-- **T123**: Status: In Progress, Duration: 45m, Agent: developer
-- **T124**: Status: In Progress, Duration: 60m, Agent: backend_engineer
-- **Note**: DB migration in progress
-```
-
----
-
-## 🔄 轉換函數（偽代碼）
-
-### 欄位名縮寫
-
-```python
-FIELD_ABBREVIATIONS = {
-    "status": "st",
-    "priority": "p",
-    "created_at": "ct",
-    "updated_at": "ut",
-    "duration": "dur",
-    "description": "desc",
-    # ... (完整映射表)
-}
-
-def abbreviate_field(field_name: str) -> str:
-    """將完整欄位名轉換為縮寫"""
-    return FIELD_ABBREVIATIONS.get(field_name, field_name)
-
-def expand_field(abbr: str) -> str:
-    """將縮寫還原為完整欄位名"""
-    reverse_map = {v: k for k, v in FIELD_ABBREVIATIONS.items()}
-    return reverse_map.get(abbr, abbr)
-```
-
-### 值代碼化
-
-```python
-VALUE_CODES = {
-    "status": {
-        "completed": "C",
-        "in_progress": "P",
-        "pending": "D",
-        "blocked": "B",
-        # ...
-    },
-    "priority": {
-        "P0": "0",
-        "P1": "1",
-        "P2": "2",
-        "P3": "3",
-    },
-    # ...
-}
-
-def encode_value(field: str, value: Any) -> str:
-    """將值編碼為簡短代碼"""
-    if field in VALUE_CODES:
-        return VALUE_CODES[field].get(str(value), str(value))
-    return str(value)
-
-def decode_value(field: str, code: str) -> Any:
-    """將代碼解碼為原始值"""
-    if field in VALUE_CODES:
-        reverse_map = {v: k for k, v in VALUE_CODES[field].items()}
-        return reverse_map.get(code, code)
-    return code
-```
-
-### 時間戳縮短
-
-```python
-def shorten_timestamp(iso_timestamp: str) -> str:
-    """
-    將 ISO 8601 時間戳縮短為 YYMMDD-HHMM 格式
-
-    範例:
-      2026-02-07T05:30:00Z → 260207-0530
-    """
-    dt = datetime.fromisoformat(iso_timestamp.replace('Z', '+00:00'))
-    year_short = str(dt.year)[-2:]  # 26
-    month = f"{dt.month:02d}"       # 02
-    day = f"{dt.day:02d}"           # 07
-    hour = f"{dt.hour:02d}"         # 05
-    minute = f"{dt.minute:02d}"     # 30
-    return f"{year_short}{month}{day}-{hour}{minute}"
-
-def expand_timestamp(short_ts: str) -> str:
-    """
-    將縮短時間戳還原為 ISO 8601 格式
-
-    範例:
-      260207-0530 → 2026-02-07T05:30:00Z
-    """
-    if '-' in short_ts:
-        date_part, time_part = short_ts.split('-')
-        yy, mm, dd = date_part[:2], date_part[2:4], date_part[4:6]
-        hh, mn = time_part[:2], time_part[2:4]
-        year = f"20{yy}"  # 假設 21 世紀
-        return f"{year}-{mm}-{dd}T{hh}:{mn}:00Z"
-    else:
-        # 僅日期
-        yy, mm, dd = short_ts[:2], short_ts[2:4], short_ts[4:6]
-        year = f"20{yy}"
-        return f"{year}-{mm}-{dd}"
-```
-
----
-
-## 📚 參考文檔
-
-- **語法定義**: `matrix_format_SYNTAX_BNF.md`
-- **Token 對比**: `matrix_format_TOKEN_COMPARISON.md`
-- **設計規格**: `matrix_format_DESIGN_SPEC.md`
-- **範例文件**: `matrix_format_EXAMPLE_*.matrix`
-
----
-
-## ✅ 驗收標準檢查
-
-- [x] 包含至少 30 個欄位縮寫（實際: **72 個**）
-- [x] 包含至少 20 個值代碼（實際: **66 個**）
-- [x] 提供完整的查找表
-- [x] 提供轉換函數範例
-- [x] 說明時間戳縮短規則
-- [x] 說明命名慣例
-- [x] 提供使用範例
-
----
-
-## 🔄 版本歷史
-
-| 版本 | 日期 | 變更內容 |
-|------|------|---------|
-| 1.0.0 | 2026-02-08 | 初始版本 - 72 個欄位縮寫 + 66 個值代碼 |
-
----
-
-**文檔版本**: 1.0.0
-**最後更新**: 2026-02-08
-**維護者**: Developer Team
-**Feature ID**: F-015
-**Task ID**: TASK_139