[che-apple-mail-mcp] archive-mail 規定的檔名格式 YYYYMMDD 與實務 YYYY-MM-DD 不符

[kiki830621]

Problem

Upgrade report 原文：
「檔名格式不符實務：指令說 `YYYYMMDD_...`，實際全用 `YYYY-MM-DD_Subject-with-dashes.md`」
— Source: plugin-upgrade report on che-apple-mail-mcp (2026-04-14)

commands/archive-mail.md Step 5 規定：

檔名格式：`YYYYMMDD_brief_description.md`

但 tatsuma 專案內 50 個既有歸檔檔都用：

2023-08-28_Re--sabbatical-year.md
2024-03-04_Re--Taxometric-Analysis-R-code.md
2026-03-24_Re--Shall-we-resume-work-on-the-Taxometric-Analysis-paper-al.md

Type

bug

Expected

Step 5 規範改為：YYYY-MM-DD_Subject-with-hyphens.md

• 日期用 ISO 8601 破折號格式（可排序、人類可讀）
• 主旨用原始 subject（把空白、冒號替換為 -），而非 AI 濃縮的 "brief description"
• 若同日同主旨多封，加 -1、-2、-3 後綴

Actual

若模型照指令執行會產生不同格式的檔名，與既有歸檔不一致。

Impact

歸檔的排序、grep、檔名一致性都受影響。今天歸檔時我手動採用了實務格式。

[kiki830621]

Diagnosis

Type

bug（docs 與實作脫節）

Root Cause

原始 archive-mail.md Step 5 規範 YYYYMMDD_brief_description.md（無分隔符、AI 濃縮 subject）。但實務上使用者的歸檔都是人工命名，自然採用 YYYY-MM-DD_Subject-with-hyphens.md：

• ISO 8601 日期可排序
• 原始 subject（破折號替換空白）一看就知道是哪封信
• 同日多封加 -1 -2 -3

規範從未被遵守，但 50 個歷史檔案是「活的 spec」。

Impact

• 檔案：commands/archive-mail.md Step 5 的命名規範段
• 不影響任何既有檔案（改的是未來行為）

Strategy

• Step 5 檔名規範改為：YYYY-MM-DD_{subject-with-hyphens}.md
  • subject 轉換規則：空白 / : / 中英標點 → -；連續 - 合一；trim 50 字
  • 同日同主旨：後綴 -1, -2, ...（第一封不加後綴；第二封起才加）
• 給正反例各一
• 日文/中文 subject 保留 unicode（從 2024-03-26_翻訳のお願い.md 看得出實務允許非 ASCII）

Complexity

Simple（純 spec 更新）

Risks

• subject 轉換規則要明確，否則模型仍會自創縮寫
• 建議在 command 內附「subject → filename」轉換函式的 pseudocode

Depends on

None

Related

#17（內容格式）是姊妹 issue — 一起修比較連貫。

[kiki830621]

Implementation Plan

• 修改 plugins/che-apple-mail-mcp/commands/archive-mail.md Step 5：
  • 檔名規範改為 YYYY-MM-DD_{subject-hyphenated}.md
  • 加入 subject → filename 轉換規則（空白/冒號/中英標點 → -；連續 - 合一；trim 50 字；保留 Unicode）
  • 加入同日同主旨後綴規則（-1, -2, ...；第一封不加）
  • 給 2–3 個正例（含中日文主旨）

Scope check：只改 Step 5 的檔名章節。內容格式段（摘要/待辦）是 #17 的 scope。

Example references：既有 communications/ 的 50 個檔名作為實務基準。

[kiki830621]

Implementation Complete

Changes

• 1985e9d docs(che-apple-mail-mcp): fix MCP prefix, account_name pitfall, filename spec

Files Changed

• plugins/che-apple-mail-mcp/commands/archive-mail.md — Step 5 檔名規範改為 YYYY-MM-DD_{subject-hyphenated}.md；新增：
  • Subject → filename 轉換規則（空白/標點→-；連續合一；trim 50；保留 Unicode）
  • 同日同主旨後綴 -1 -2 -3（第一封不加）
  • 4 個範例表（從 tatsuma/communications/ 抽取，含中日文 subject）

Scope Compliance

只改 Step 5 檔名章節。內容格式（元資料表/摘要/待辦）屬 #17，未動。

PR

#22

Next

verification pending — /issue-driven-dev:idd-verify #16

[kiki830621]

Verify: #16

Engine

Agent Team (5 Claude teammates) + Codex (gpt-5.4 xhigh)

Requirement Coverage

• requirements: FULLY（格式、轉換規則、後綴、範例四項皆列）
• codex: PARTIALLY
• logic: PARTIALLY（多處 P1）
• devils-advocate: 找出多個邊界漏洞

Findings

#	Severity	Finding	Source
1	P1	規則「連續 - 合成一個」與範例 Re--sabbatical-year.md、Re--Some-topic.md、Re--Poster-at-九州心理学会-3.md 矛盾。所有範例都保留雙 dash（因為 Re: 轉換後 Re- + 空白 - = Re--）。實務 tatsuma/communications/ 50 個歷史檔案也保留 Re--。結論：規則 bug——應刪除「連續合一」這條，或只合併 3+ 個 dash。	codex + logic
2	P1	「第二封起加 -1 -2 -3」但範例「第三封 -3」應為 -2（1st→無、2nd→-1、3rd→-2）。規則與範例 off-by-one。	logic + devils-advocate
3	P1	「50 字元」未定義單位（Unicode code point / grapheme cluster / UTF-8 byte）。對中日韓文差異巨大：50 bytes ≈ 16 中文字 vs 50 code points = 50 中文字。建議明寫「50 Unicode code points」。	logic + devils-advocate
4	P1	空白 subject / 純標點 subject（"???"）轉換後會產出空字串 → 檔名 2026-04-08_.md（裸底線）。規則無 fallback。建議補「若空字串，用 no-subject」。	logic
5	P1	截斷「50 字元」後未再 trim。若第 50 字元落在 -，產出尾部 -（如 ...long-topic-.md）。規則順序應為「換→合併→截斷→trim」。	logic
6	P2	Step 6 索引範例 20260113_topic.md（L149）與 Step 7 輸出報告 20260113_meeting_request.md（L168-170）仍為舊 YYYYMMDD 格式，與 Step 5 新規則不一致。	codex + logic
7	P2	主旨末尾本含數字（Report 2024）→ 檔名 Report-2024.md；同日第二封 Report-2024-1.md，讀者難分辨 -2024 是主旨還是後綴。建議後綴改 __2 / (2) 或 #2。	logic
8	P3	舊檔 tatsuma/communications/2024-07-14_Re--Taxometric-Analysis-2024710-a.md / -b.md 用字母後綴。新規 -1 -2 -3 與舊慣例並存。需決定：不改舊檔（現狀 OK，follow-up issue）還是遷移（另一個 PR）。	devils-advocate
9	P3	範例覆蓋不足：?、emoji、控制字元未列規則。	devils-advocate

Blocker status

⛔ 5 個 P1 blockers — must fix before merge。Finding #1 與 #2 是規則與範例內部矛盾，#3 #4 #5 是未定義的邊界規則（實作時會失敗）。Finding #6 高度可見（在 command 後段範例），屬 "user-facing inconsistency"。

Scope Check

改動只在 Step 5 檔名段。未動內容格式（#17 scope）、未動 dedup（#18 scope）。scope 合規。

Next

修 5 個 P1 → 推新 commit → re-verify。

[kiki830621]

Closed via PR #22 (merge commit 47bd7f4)

完整流程：idd-issue → idd-diagnose → idd-implement → idd-verify（5 Claude teammates + Codex xhigh）→ fix verify findings → idd-verify round 2 (codex) → merge。

相關 commits：

• 1985e9d initial docs fix
• eace67d README Commands section
• bea990d verify findings fix (PII / filename rules / allowed-tools)
• 4283cc0 zero-arg roadmap strengthening
• 355f84c re-verify partial fixes (grapheme cluster / Step 5 warning)

Follow-up：

• [che-apple-mail-mcp] archive-mail 不支援零參數模式（無法讀取 .claude/emails.md） #13 [che-apple-mail-mcp] archive-mail Markdown 內容格式過度複雜（元資料表+摘要+待辦，實務用簡單版） #17 [che-apple-mail-mcp] archive-mail 的 .email_index.json 去重方案從未實際建立過 #18 [che-apple-mail-mcp] 缺 CLAUDE.md 說明 plugin 能力與 .claude/emails.md schema #19 [che-apple-mail-mcp] archive-mail 的 argument-hint 未標示參數為可選 #21 仍 open，等 /spectra-discuss 對齊 .claude/emails.md schema
• [che-apple-mail-mcp] archive-mail 未下載附件（僅記錄檔名） #23（新）archive-mail 未下載附件 — awaiting diagnose