capacity-module-index-readreview-2026-06-17

Readability Review: capacity-module / index

• 審查文章：index.md
• 審查日期：2026-06-17
• 讀者人設：產品設計師（不會寫程式、讀得懂技術文章）
• 預設讀者／用途：內部 PO／產品與 reviewer 讀本 Stage 1 紀錄區，確認需求收斂結論可被討論、可交棒 Stage 2

Stage 1 邊界說明：本檔是紀錄區（living doc）。§CAP-UR-N 全域碼、[#N] 追溯連結、答覆(...) 原話、狀態圖示屬可追溯性機制，by-design、未列為缺陷。本報告只審本工具鏈產生的散文（Problem Statement、核心需求、矛盾／衝擊段、未解問題「釐清」）。 修正預覽說明：每筆的 after 是示意、供參考，給作者看到方向長什麼樣；本報告不改原檔、不替作者定稿。

---

兩軸總評

軸	判斷	一句根據
通順（讀得下去嗎）	⚠️	表格與 Q&A 好跟，但三個最關鍵的「這在講什麼」摘要句（Problem Statement、核心需求、下游衝擊）都是單句塞多命題的壓縮密句，讀者在最該讀懂的地方撞牆。
可被討論（找得到地方同意或反對嗎）	✅（偏 ⚠️）	未解問題的編號＋狀態＋建議找誰問、已定向／仍待 Stage 2 的分離都做得很好，reviewer 找得到插話點；唯一弱點是「下游衝擊」三條擠在一格、沒各自錨點。

---

發現清單

🚧 卡關點（通順）

1. Problem Statement（line 13）

   • 現狀：

     內部 PO 想重構產能模型：先前版本以「工作站」為主體、再往下找對應資源，導致使用者填寫困惑與部分排單邏輯無法實作；改採以「資源」為主體的彈性結構（資源各自帶工作能力、隸屬工作站、地理位置與資源間關聯，並以行事曆＋班表＋加班/休息描述可用時間），作為產能真相源頭，透過轉接器餵給粗排等下游模組。

   • 卡在哪：一句塞六件事（舊模型＋它的問題、新模型、資源帶什麼、時間怎麼描述、它是真相源頭、餵下游）。讀者在第一個「這份在講什麼」的位置就要一口氣吞完。
   • 修正預覽（示意）：

     內部 PO 要把產能模型的主體從「工作站」翻轉成「資源」。

     • 為什麼翻轉：舊版先設工作站、再往下找資源，造成填表困惑，部分排單邏輯也做不出來。
     • 新結構：每個資源自己帶工作能力、隸屬工作站、地理位置、與其他資源的關聯；可用時間用行事曆＋班表＋加班/休息描述。
     • 定位：產能模組是產能的真相源頭，經轉接器餵給粗排等下游模組。

2. 核心需求（line 143）

   • 現狀：

     內部 PO 要把產能模型從工作站為主體翻轉成資源為主體的彈性結構——先前「先設工作站、再找資源」造成填寫困惑與排單邏輯無法實作——新結構讓多型資源（機台／模治具／操作人員／換模技師…，不限於此）各自帶……

   • 卡在哪：兩個破折號把「翻轉結論」「舊法問題」「新結構」串成一條長句，讀者抓不到主幹。
   • 修正預覽（示意）：

     核心需求：把產能模型的主體從工作站翻轉成資源。 舊法（先設工作站、再找資源）造成填寫困惑、部分排單邏輯做不出來；新結構讓多型資源（機台／模治具／操作人員／換模技師等，不限於此）各自帶……

3. 下游衝擊段（line 50–52）

   • 現狀：

     「資源為主體」對既有共用 domain-model 的「WorkCenter（工作站）為產能承載主體」是結構性翻轉，且 rough-cut-scheduler 已消費既有產能物件——非矛盾，是 cascade 衝擊。

   • 卡在哪：一句裡同時要消化「結構翻轉」「已被 rough-cut 消費」「這算 cascade 不算矛盾」，又用破折號做揭示。
   • 修正預覽（示意）：

     這項翻轉會往下游衝擊（是 cascade 影響，不是矛盾）：新模型以資源為主體，但既有共用 domain-model 是以 WorkCenter（工作站）承載產能，而 rough-cut-scheduler 已經在消費既有產能物件。

4. 模板指示語殘留（line 12、30、39、62 等 > 區塊）

   • 現狀：

     一句話。寫不出來就回去問。

     每筆對應 raw/ 一個檔或一條連結。照實記，不要美化。

   • 卡在哪：這些是寫給文件作者的鷹架，對 reviewer 是對著喊話的教學語氣（命中文件級判準 D）。
   • 修正預覽（示意）：給 reviewer 看的發布版把這些 callout 隱藏（移除，或收進不渲染的 HTML 註解）；作者編輯版才保留。

🔇 插不上話（可被討論）

1. 下游衝擊段（line 49–52）
   • 現狀：

     下游衝擊（觀察點，非矛盾，留 Stage 2/3）：

     • 「資源為主體」對既有共用 domain-model……
     • 配對特例（同製程、不同工作站；見 #2）……
     • 「資源×時間區段」（見 #7）vs 既有 CapacitySlot「工作站×日」……

   • 卡在哪：三條衝擊擠在同一個 bullet 群、沒各自編號。reviewer 若只想質疑「資源為主體 vs WorkCenter」這一條，沒有可指的獨立錨點。
   • 修正預覽（示意）：比照「未解問題」給每條一個編號錨點 ——

     下游衝擊（觀察點，非矛盾，留 Stage 2/3）

     • 衝擊 1 主體翻轉：資源為主體 vs domain-model 的 WorkCenter 承載產能……
     • 衝擊 2 節點單一對特例：同製程／異工作站（見 #2）挑戰「節點＝單一對」……
     • 衝擊 3 產能鍵：資源×時間區段（見 #7）vs CapacitySlot 工作站×日……

📖 術語裸詞（沒鋪路的前提）

1. 「轉接器 / ACL」（line 13、52、129…）

   • 現狀：

     ……作為產能真相源頭，透過轉接器餵給粗排等下游模組。

   • 卡在哪：「轉接器／ACL」反覆出現卻沒一句定義。
   • 修正預覽（示意）：

     ……透過轉接器（ACL，隔離新舊模型的轉換層）餵給粗排等下游模組。

2. DataBox.changeOverTime（line 76）

   • 現狀：

     但到時候佔用產能時，是要用 DataBox.changeOverTime 去計算。

   • 卡在哪：code identifier 首現沒 gloss，非工程師讀者不知道它是什麼。保留英文名沒問題，缺的是一句說明。
   • 修正預覽（示意）：

     ……用 DataBox.changeOverTime（DataBox 裡記錄的換線時間欄位）去計算。

3. 「節點＝工單-料號-工作站-製程-工序的單一對」不變量（line 51、85）

   • 現狀：

     配對特例（同製程、不同工作站；見 #2）挑戰既有不變量「節點＝工單-料號-工作站-製程-工序的單一對」。

   • 卡在哪：「不變量」加這串「單一對」對非工程師是裸的。
   • 修正預覽（示意）：

     ……挑戰既有不變量（系統一直假設成立的規則）：一個排程節點只對應一組「工單-料號-工作站-製程-工序」。

---

文件級判準對照

判準	命中？	對應發現
A 雙層（白話上層＋深究層）	是	關鍵摘要句缺白話上層（見 🚧1–3）
B 大綱不搶結論、分析節結論先行	—	需求收斂結論擺位恰當
C 標題有資訊	—	各節標題清楚
D 中性專業、不對讀者喊話	是	模板指示語殘留（見 🚧4）
E 分歧攤平、給可指認錨點	是	衝擊段三條缺各自錨點（見 🔇1）

---

統計

• 🚧 4 ｜ 🔇 1 ｜ 📖 3
• 兩軸：通順 ⚠️、可討論 ✅（偏 ⚠️）

---

後續

• 作者拿各筆「修正預覽」當起點自行揉終稿（預覽是示意，本報告不改原檔）
• 優先順序建議：先處理 🚧1–3 三個壓縮密句（影響最大、都在「這份在講什麼」的關鍵位置）
• 模板指示語殘留（🚧4）若屬 requirement-partner 模板的共同現象 → 可回該 skill 模板層處理，而非逐檔改
• 要直接改原檔、整篇順過 → 轉 /humanizer-zh-tw（本 skill 的預覽停在報告示意，不動原檔）

本報告只回報可讀性／可討論性，不評論內容對錯、不代改、不替作者拍板哪裡要改。