shiftblame 0.4.0 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-# 🍲 shiftblame
+# shiftblame
 
 ### 推鍋
 
@@ -8,7 +8,7 @@ _一套明確責任歸屬的 Agents 開發框架_
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-compatible-8a2be2.svg)](https://claude.com/claude-code)
-[![Agents](https://img.shields.io/badge/agents-8-blue.svg)](#這是什麼)
+[![Agents](https://img.shields.io/badge/agents-25-blue.svg)](#資源供給機制)
 [![Language](https://img.shields.io/badge/lang-繁體中文-red.svg)](#)
 
 > _「這不是我的鍋。」_
@@ -19,51 +19,44 @@ _一套明確責任歸屬的 Agents 開發框架_
 
 ---
 
-需求從企劃推到上線，經過 **8 層 agent**。每一層該誰負責、出了事該找誰，白紙黑字記在鍋紀錄裡。
+秘書動態掃描 agents 目錄，把正確的需求推給正確的部門。每個部門該誰負責、出了事該找誰，白紙黑字記在鍋紀錄裡。
 
 還沒想清楚？秘書也能幫你**釐清方向**——用結構化問答收斂需求，確認後再推鍋。
 
 ---
 
-## 誰的鍋？
+## 資源供給機制
 
-每個角色都有自己的 `~/.shiftblame/blame/<role>/BLAME.md`，犯錯就記，下次避雷。
+模型分配**按角色類型**，不按部門層級：
 
-### 老闆的鍋
+| 角色類型 | 模型 | 對象 |
+|----------|------|------|
+| **管理層**（調度 sub-agent） | **haiku** | PRD、DEV、QA、QC、SEC、MIS |
+| **執行職級**（sub-agent） | **sonnet**（預設）/**opus**（複雜度 ≥ 80） | 由主管按任務複雜度分配 |
 
-| 情境 | 為什麼是老闆的鍋 | 回退方式 |
-|------|------------------|----------|
-| **大環境問題**：缺 API key、缺套件、缺權限⋯⋯ | 「換更強的 agent 在同一環境裡做得了嗎？」做不了 = 環境的鍋 = 老闆的鍋 | 老闆補好環境條件後重啟 |
-| **老闆明示直接修改**：親口說「直接改」「不用跑流程」 | 老闆下令跳過流程，改壞了自己扛。commit 以 `BOSS-HOTFIX:` 為前綴 | `git revert` |
+---
+
+## 誰的鍋
+
+每個部門都有自己的 `~/.shiftblame/blame/<DEPT>/<role>/BLAME.md`，犯錯就記，下次避雷。
 
 ### 秘書的鍋
 
 | 情境 | 為什麼是秘書的鍋 |
 |------|------------------|
-| **判鍋判錯**：起點層判斷錯誤導致重工 | 秘書職責就是判斷該從哪層開始 |
-| **退回判錯**：老闆說不 OK 時退回了錯誤的層 | 秘書職責就是判斷根因在哪層 |
-| **合併出包**：rebase / merge --squash 過程出錯 | 合併是秘書親自執行的 |
+| **路由判錯**：需求推給了錯誤的部門導致重工 | 秘書職責就是判斷該推給誰 |
+| **退回判錯**：老闆說不 OK 時推給了錯誤的部門 | 秘書職責就是判斷根因在哪 |
 
-### 各層 agent 的鍋
+### 各部門的鍋
 
-| 角色 | 典型犯錯情境 |
+| 部門 | 典型犯錯情境 |
 |------|-------------|
-| `product-planner` | PRD 漏掉老闆明確提到的需求、自作主張加了老闆沒說的東西 |
-| `system-architect` | 技術選型不可行、模組拆分導致後續無法實作 |
-| `project-manager` | 驗收條件與 PRD 矛盾、任務依賴排錯導致卡關 |
-| `quality-assurance` | **測試主管**：拆分任務不當導致測試工程師產出衝突、收合不完整、測試涵蓋度不足。底下三個測試工程師（unit-test-engineer / integration-test-engineer / e2e-test-engineer）的鍋也由主管扛 |
-| `feature-developer` | **開發主管**：拆分任務不當導致職能工程師產出衝突、收合不完整、實作偏離 spec、引入新 bug。底下三個職能工程師（frontend-engineer / backend-engineer / infra-engineer）的鍋也由主管扛 |
-| `quality-control` | e2e 場景遺漏關鍵流程、環境設定錯誤導致假綠 |
-| `audit-reviewer` | 該抓的沒抓到（放水）、退回理由不具體導致重工 |
-| `operations-engineer` | 部署步驟與 dag 不符、上線後 smoke test 沒跑或漏驗 |
-
-### 行政文書的鍋
-
-| 情境 | 為什麼是行政文書的鍋 |
-|------|---------------------|
-| **聚合遺漏**：未掃描到應聚合的舊文件 | 文件聚合是行政文書唯一職責 |
-| **REPO.md 格式錯亂**：聚合後內容不完整或格式錯誤 | 聚合品質由行政文書負責 |
-| **誤刪 STM 檔案**：刪掉應保留的最新 3 筆 | 保留規則由行政文書執行 |
+| PRD | PRD 漏掉老闆明確提到的需求、自作主張加了老闆沒說的東西、技術選型不可行、市調資料不準確 |
+| QA | 測試涵蓋度不足、拆分任務不當導致測試工程師產出衝突 |
+| DEV | 實作偏離 spec、引入新 bug、拆分任務不當導致工程師產出衝突 |
+| QC | 品管場景遺漏關鍵流程、邊緣/模糊測試不足、一致性遺漏、使用者體驗問題 |
+| SEC | 該抓的沒抓到（放水）、退回理由不具體、安全掃描遺漏 |
+| MIS | 環境盤點遺漏、CI/CD pipeline 配置錯誤、合併出包、部署失敗 |
 
 ---
 
@@ -82,103 +75,78 @@ _一套明確責任歸屬的 Agents 開發框架_
  明確              不確定
    │                │
    ▼                ▼
- 老闆原話       ┌──────────────────────┐
- 留底           │ 諮詢模式             │
-   │            │ 結構化問答釐清方向   │
-   │            │ 確認後才推鍋         │
-   │            └──────────┬───────────┘
-   │                       │
-   │◄──────────────────────┘
+ 原話留底      ┌──────────────────────┐
+   │           │ 諮詢模式             │
+   │           │ 結構化問答釐清方向   │
+   │           │ 確認後才推鍋         │
+   │           └──────────┬───────────┘
+   │                      │
+   │◄─────────────────────┘
    ▼
  ┌─────────────────────────┐
- │ 秘書預審（翻成人話）    │ ← 每一層啟動前都要過這個閘門
- │ 老闆只回「OK / 不 OK」  │   老闆不需要知道內部有哪些角色
+ │ 掃描 agents 目錄        │
+ │ 判斷該推給哪個部門      │
  └─────────┬───────────────┘
            │
    ┌───────┴────────┐
    │                │
-  OK                不 OK（附原因或新需求）
+ 預審 OK          不 OK
    │                │
    ▼                ▼
- 啟動該層     秘書判斷根因在哪層，
- agent        把鍋丟給正確的人重跑
-   │
+ 啟動該部門    秘書判斷根因，
+   │           推給正確的部門重做
    ▼
- 產出文件 + commit
+ 收回傳 → 判斷下一步
    │
    ▼
- 下一層繼續（再走一次預審）
+ 完成 → 秘書對照原話 → 呈報老闆
 ```
 
-### 8 層推鍋鏈
+### 需求路由
+
+秘書根據需求性質，把鍋推給對的部門：
 
-| # | 角色 | 產出 | 主要工作 |
-|---|------|------|---------|
-| 1 | product-planner    | prd    | 把老闆原話轉 PRD |
-| 2 | system-architect   | dag    | 技術選型、模組拓撲、檔案結構、介面簽章、部署方案 |
-| 3 | project-manager    | spec   | 功能拆解、驗收條件、任務依賴 |
-| 4 | quality-assurance  | basis  | 依 dag + spec 寫測試（TDD 紅）= **QA 定規則** |
-| 5 | feature-developer  | devlog | 寫最小實作讓測試全綠（TDD 綠） |
-| 6 | quality-control    | e2e    | 使用者視角 e2e 測試並實際執行 = **QC 依規則驗收** |
-| 7 | audit-reviewer     | audit  | 整條鏈路驗收，回傳 ACCEPTED / REJECTED |
-| 8 | operations-engineer| ops    | 在 main 依 dag 方案實際上線 |
+| 需求性質 | 推給 |
+|---|---|
+| 全新功能 / 方向性變更 | PRD |
+| 技術選型 / 工具比較 | PRD |
+| 架構調整 / 技術遷移 | PRD |
+| 加細節 / 改驗收條件 | DEV |
+| 測試不足 / 要補測試 | QA |
+| 已知 bug / 程式修正 | DEV |
+| 使用者體驗問題 | QC |
+| 部署 / 上線方式調整 | MIS |
+| 環境 / 工具問題 | MIS |
+| CI/CD / 自動化調整 | MIS |
 
-**行政文書**不參與 8 層鏈路，只在鏈路完成後進行文件聚合。
+全新功能的典型路徑：`PRD → MIS(環境) → QA → DEV → QC → SEC(安全) → MIS(合併+部署)`，但秘書可依實際需求動態跳過或新增步驟。
 
 ### 檔案結構
 
 ```
-~/.shiftblame/                               # 推鍋產物（家目錄）
-├── blame/                                   # 鍋紀錄（所有 repo 共用）
-│   ├── product-planner/BLAME.md
-│   ├── system-architect/BLAME.md
-│   ├── project-manager/BLAME.md
-│   ├── quality-assurance/
-│   │   ├── BLAME.md                         # 測試主管的鍋
-│   │   ├── unit-test-engineer/BLAME.md      # 單元測試工程師的鍋
-│   │   ├── integration-test-engineer/BLAME.md # 整合測試工程師的鍋
-│   │   └── e2e-test-engineer/BLAME.md       # E2E 測試工程師的鍋
-│   ├── feature-developer/
-│   │   ├── BLAME.md                         # 開發主管的鍋
-│   │   ├── frontend-engineer/BLAME.md       # 前端工程師的鍋
-│   │   ├── backend-engineer/BLAME.md        # 後端工程師的鍋
-│   │   └── infra-engineer/BLAME.md          # 基建工程師的鍋
-│   ├── quality-control/BLAME.md
-│   ├── audit-reviewer/BLAME.md
-│   ├── operations-engineer/BLAME.md
-│   ├── secretary/BLAME.md
-│   ├── administrative-clerk/BLAME.md       # 行政文書的鍋
-│   └── boss/BLAME.md
-└── <repo>/                                  # 每個 repo 各自一個目錄
-    ├── docs/
-    │   ├── prd/<slug>.md
-    │   ├── dag/<slug>.md
-    │   ├── spec/<slug>.md
-    │   ├── basis/<slug>/
-    │   │   ├── unit/...                    # unit-test-engineer 產出
-    │   │   ├── integration/...             # integration-test-engineer 產出
-    │   │   └── e2e/...                     # e2e-test-engineer 產出
-    │   ├── devlog/<slug>/
-    │   │   ├── frontend/...              # frontend-engineer 產出
-    │   │   ├── backend/...               # backend-engineer 產出
-    │   │   └── infra/...                 # infra-engineer 產出
-    │   ├── e2e/<slug>.md
-    │   ├── audit/<slug>.md
-    │   └── ops/<slug>.md
-    ├── REPO.md                            # 文件聚合檔（長期記憶）
-    └── report/
-        └── <YYYY-MM-DD_HHMMSS>-<slug>.md   # 秘書最終對照報告
-
-~/.worktree/                                 # 共享 worktree（家目錄）
+~/.shiftblame/
+├── blame/                                       # 鍋紀錄（所有 repo 共用）
+│   ├── DEV/{fe,be,db}/BLAME.md
+│   ├── MIS/{infra,cicd,cloud}/BLAME.md
+│   ├── PRD/{plan,arch,market}/BLAME.md
+│   ├── QA/{unit,integ,e2e}/BLAME.md
+│   ├── QC/{test,uni,user}/BLAME.md
+│   ├── SEC/{red,white,blue}/BLAME.md
+│   └── SECRETARY/BLAME.md
 └── <repo>/
-    └── <slug>/                              # 前 7 棒的工作目錄
+    ├── {MIS}/<slug>.md
+    ├── {DEV,QA}/<slug>.md
+    ├── {PRD,QC,SEC}/<slug>.md
+    └── REPO.md
 
-<repo>/                                      # repo 根目錄
-├── .shiftblame/                             # symlink 目錄
-│   ├── <repo> → ~/.shiftblame/<repo>/       # 本 repo 的 docs + report
-│   └── blame → ~/.shiftblame/blame/         # 鍋紀錄
+~/.worktree/<repo>/<slug>/                       # 共享 worktree
+
+<repo>/
+├── .shiftblame/                                 # symlink 目錄
+│   ├── <repo> → ~/.shiftblame/<repo>/
+│   └── blame → ~/.shiftblame/blame/
 └── .worktree/
-    └── <slug> → ~/.worktree/<repo>/<slug>/  # worktree symlink
+    └── <slug> → ~/.worktree/<repo>/<slug>/
 ```
 
 ---
@@ -198,21 +166,21 @@ cd /path/to/your/project
 npm install shiftblame
 ```
 
-### 初始化鍋目錄
+### 初始化
 
 安裝完成後，在目標 repo 中執行：
 
 ```
-/shiftblame-link
+/blame-init
 ```
 
-這會在 repo 根目錄建立 `.shiftblame/` symlink 指向 `~/.shiftblame/`。每個要用推鍋的 repo 都要跑一次。
+建立 `~/.shiftblame/` 完整目錄結構、repo 內 symlink、檢查 `.gitignore`。秘書在首次推鍋時也會自動偵測並執行初始化。
 
 ---
 
 ## 使用
 
-在 Claude Code 中用 `/secretary` 顯式呼叫秘書：
+在 Claude Code 中用 `/secretary` 呼叫秘書：
 
 ```
 /secretary 幫我做一個 Markdown 轉 HTML 的 CLI
@@ -222,43 +190,36 @@ npm install shiftblame
 /secretary 我想要一個可以記錄每日心情的終端小工具
 ```
 
-還沒想清楚？也可以直接跟秘書諮詢：
+還沒想清楚？也可以諮詢：
 
 ```
 /secretary 我在猶豫要用 REST 還是 GraphQL，你覺得呢
 ```
 
-```
-/secretary 我不確定這個功能該怎麼做比較好，幫我想想
-```
-
 秘書會用結構化問答幫你收斂方向，確認後才開始推鍋。
 
 ### 聚合鍋紀錄
 
-當各角色的 BLAME.md 累積了一定歷史後，可以執行：
+當各部門的 BLAME.md 累積了一定歷史後，可以執行：
 
 ```
-/shiftblame-reflect
+/blame-reflect
 ```
 
-這會掃描所有角色的鍋紀錄，將「下次怎麼避免」提煉成**常識（規則）**，將「背後的機制」與「為什麼這條規則有效」提煉成**認知（模型）**，重新寫回各角色的 BLAME.md 檔頭。
-
-> **為什麼要用 `/secretary`？** Claude Code 不保證每次都能正確判斷該觸發哪個 skill，顯式呼叫最可靠。
+掃描所有部門的鍋紀錄，將「下次怎麼避免」提煉成**常識（規則）**，將「背後的機制」提煉成**認知（模型）**，寫回各 BLAME.md 檔頭。
 
-秘書接手後會：
+### 秘書接手後
 
-1. 保存你的**原話逐字稿**
-2. 取 slug、建立共享 worktree
-3. 在每一層啟動前先用人話告訴你「接下來要做的事」，你回 OK 才繼續
-4. 全鏈路跑完後，親自對照原話產出**秘書最終確認報告**
-5. 呈報「完全達成 X / 部分達成 Y / 未達成 Z」
-6. 通知**行政文書**進行文件聚合——各部門目錄只保留最新 3 筆，其餘聚合至 `REPO.md`
+1. 掃描 `.claude/agents/` 取得可用部門清單
+2. 保存你的**原話逐字稿**
+3. 每個部門啟動前先用人話告訴你「接下來要做的事」，你回 OK 才繼續
+4. 完成後親自對照原話，呈報「完全達成 X / 部分達成 Y / 未達成 Z」
+5. 完成後親自執行文件聚合
 
 你在過程中只需要：
 
-- ✅ **OK**：繼續推
-- ❌ **不 OK + 原因**：秘書會自己判斷該退回哪一層重跑
+- **OK**：繼續推
+- **不 OK + 原因**：秘書會判斷該推給哪個部門重做
 
 ---
 
@@ -266,4 +227,4 @@ npm install shiftblame
 
 > _「倉庫已經發出來了，接下來怎麼用就不是我的鍋了。」_
 
-MIT 
+MIT

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "shiftblame",
-  "version": "0.4.0",
+  "version": "1.2.0",
   "description": "推鍋",
   "scripts": {
-    "postinstall": "node scripts/postinstall.js"
+    "postinstall": "node scripts/postinstall.js",
+    "preuninstall": "node scripts/preuninstall.js"
   },
   "license": "MIT",
   "repository": {

package/scripts/postinstall.js

@@ -1,26 +1,81 @@
 const { execSync } = require("child_process");
 const path = require("path");
 const fs = require("fs");
+const pkg = require("../package.json");
 
 const src = path.join(__dirname, "..", ".claude");
+const MANIFEST_NAME = ".shiftblame-manifest.json";
+
 const isGlobal = Boolean(
   process.env.npm_config_global === "true" ||
     process.env.npm_config_prefix ===
       execSync("npm config get prefix -g", { encoding: "utf8" }).trim()
 );
 
+let dest, installType;
 if (isGlobal) {
-  const dest = path.join(require("os").homedir(), ".claude");
-  copyRecursive(src, dest);
-  console.log("shiftblame: user 級別安裝完成 → ~/.claude/");
+  dest = path.join(require("os").homedir(), ".claude");
+  installType = "global";
 } else {
-  const projectDir = findProjectRoot(process.cwd());
-  const dest = path.join(projectDir, ".claude");
-  copyRecursive(src, dest);
-  console.log(`shiftblame: repo 級別安裝完成 → ${dest}/`);
+  dest = path.join(findProjectRoot(process.cwd()), ".claude");
+  installType = "local";
+}
+
+// 1. 讀舊 manifest
+const manifestPath = path.join(dest, MANIFEST_NAME);
+let oldFiles = [];
+if (fs.existsSync(manifestPath)) {
+  try {
+    const old = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+    oldFiles = old.files || [];
+  } catch (_) {}
+}
+
+// 2. 掃描 src 建立新檔案清單
+const newFiles = [];
+function collectFiles(dir, base) {
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const rel = base ? base + "/" + entry.name : entry.name;
+    if (entry.name === MANIFEST_NAME) continue;
+    if (entry.isDirectory()) {
+      collectFiles(path.join(dir, entry.name), rel);
+    } else {
+      newFiles.push(rel);
+    }
+  }
+}
+if (fs.existsSync(src)) {
+  collectFiles(src, "");
+}
+
+// 3. 清理舊版殘留（在新版中已不存在的檔案）
+const newSet = new Set(newFiles);
+const staleFiles = oldFiles.filter((f) => !newSet.has(f));
+for (const file of staleFiles) {
+  const filePath = path.join(dest, file);
+  if (fs.existsSync(filePath)) {
+    fs.unlinkSync(filePath);
+  }
 }
+// 清理空目錄
+cleanEmptyDirs(dest, dest);
+
+// 4. 複製新檔案
+copyRecursive(src, dest);
 
-console.log("shiftblame: 請在目標 repo 中執行 /shiftblame-link 初始化鍋目錄");
+// 5. 寫入新 manifest
+const manifest = { version: pkg.version, type: installType, files: newFiles };
+fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+
+// 6. 輸出
+const label = isGlobal ? "user 級別" : "repo 級別";
+console.log(`shiftblame: ${label}安裝完成 → ${dest}/`);
+if (staleFiles.length > 0) {
+  console.log(`shiftblame: 已清除 ${staleFiles.length} 個舊版殘留檔案`);
+}
+console.log("shiftblame: 請在目標 repo 中執行 /blame-init 初始化鍋目錄");
+
+// --- helpers ---
 
 function findProjectRoot(dir) {
   let current = dir;
@@ -49,3 +104,12 @@ function copyRecursive(src, dest) {
     fs.copyFileSync(src, dest);
   }
 }
+
+function cleanEmptyDirs(dir, stopAt) {
+  if (dir === stopAt || !fs.existsSync(dir)) return;
+  const entries = fs.readdirSync(dir);
+  if (entries.length === 0) {
+    fs.rmdirSync(dir);
+    cleanEmptyDirs(path.dirname(dir), stopAt);
+  }
+}

package/scripts/preuninstall.js

@@ -0,0 +1,81 @@
+const { execSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const MANIFEST_NAME = ".shiftblame-manifest.json";
+
+const isGlobal = Boolean(
+  process.env.npm_config_global === "true" ||
+    process.env.npm_config_prefix ===
+      execSync("npm config get prefix -g", { encoding: "utf8" }).trim()
+);
+
+let dest;
+if (isGlobal) {
+  dest = path.join(require("os").homedir(), ".claude");
+} else {
+  dest = path.join(findProjectRoot(process.cwd()), ".claude");
+}
+
+const manifestPath = path.join(dest, MANIFEST_NAME);
+
+if (!fs.existsSync(manifestPath)) {
+  console.log("shiftblame: 未找到安裝紀錄，跳過清理");
+  process.exit(0);
+}
+
+let manifest;
+try {
+  manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+} catch (_) {
+  console.log("shiftblame: 安裝紀錄損毀，跳過清理");
+  process.exit(0);
+}
+
+// 1. 刪除所有追蹤的檔案
+let removed = 0;
+for (const file of manifest.files || []) {
+  const filePath = path.join(dest, file);
+  if (fs.existsSync(filePath)) {
+    fs.unlinkSync(filePath);
+    removed++;
+  }
+}
+
+// 2. 清理空目錄（不刪除 .claude/ 本身）
+cleanEmptyDirs(dest, dest);
+
+// 3. 刪除 manifest
+if (fs.existsSync(manifestPath)) {
+  fs.unlinkSync(manifestPath);
+}
+
+console.log(`shiftblame: 已移除 ${removed} 個檔案`);
+console.log("shiftblame: 反安裝完成（已保留 .claude/ 目錄）");
+
+// --- helpers ---
+
+function findProjectRoot(dir) {
+  let current = dir;
+  while (current !== path.dirname(current)) {
+    if (
+      fs.existsSync(path.join(current, "package.json")) &&
+      current !== path.join(__dirname, "..")
+    ) {
+      return current;
+    }
+    current = path.dirname(current);
+  }
+  return process.env.INIT_CWD || process.cwd();
+}
+
+function cleanEmptyDirs(dir, stopAt) {
+  if (dir === stopAt || !fs.existsSync(dir)) return;
+  try {
+    const entries = fs.readdirSync(dir);
+    if (entries.length === 0) {
+      fs.rmdirSync(dir);
+      cleanEmptyDirs(path.dirname(dir), stopAt);
+    }
+  } catch (_) {}
+}

package/.claude/agents/administrative-clerk.md

@@ -1,132 +0,0 @@
----
-name: administrative-clerk
-description: 行政文書。對專案 docs/ 與 report/ 進行文件聚合，保留最新 3 筆 STM，其餘聚合至 REPO.md。
-tools: Read, Write, Edit, Grep, Glob, Bash
-model: sonnet
----
-
-做文件聚合：掃描各部門 docs/ 與 report/，保留最新 3 筆 STM，其餘聚合至 REPO.md。
-標籤：administrative-clerk（行政文書）
-產出：REPO.md（文件聚合檔）
-- 自己的鍋：`~/.shiftblame/blame/administrative-clerk/BLAME.md`
-
-## 定位
-推鍋鏈的收尾角色（接秘書 step 11 呈報後）。不參與 8 層推鍋鏈，**背行政鍋**。只做一件事：文件聚合。
-
-## 為什麼這層存在
-如果拿掉這層：文件無限累積，agent 每次開工要讀大量歷史，context 爆炸。
-核心問題：控制文件量，維護長期記憶的可用性。
-
-## 唯一職責
-1. 掃描 `~/.shiftblame/<repo>/docs/` 下各部門目錄及 `~/.shiftblame/<repo>/report/`
-2. 每個目錄保留最新 3 筆檔案作為 STM
-3. 將超出 3 筆的舊檔案內容聚合至 `~/.shiftblame/<repo>/REPO.md`
-4. **即使檔案少於 3 筆，仍須將現有內容聚合至 REPO.md**（原檔案保留不刪）
-5. 聚合完成後刪除已聚合的舊檔案（僅刪除超出最新 3 筆的部分）
-
-## 輸入
-`repo` 名稱（由秘書傳入）。
-
-掃描目錄：
-- `~/.shiftblame/<repo>/docs/prd/`
-- `~/.shiftblame/<repo>/docs/dag/`
-- `~/.shiftblame/<repo>/docs/spec/`
-- `~/.shiftblame/<repo>/docs/basis/`
-- `~/.shiftblame/<repo>/docs/devlog/`
-- `~/.shiftblame/<repo>/docs/e2e/`
-- `~/.shiftblame/<repo>/docs/audit/`
-- `~/.shiftblame/<repo>/docs/ops/`
-- `~/.shiftblame/<repo>/report/`
-
-## 工具權限
-- ✅ Read / Grep / Glob：讀 `~/.shiftblame/<repo>/docs/` 與 `~/.shiftblame/<repo>/report/` 下所有檔案
-- ✅ Bash：排序檔案、刪除已聚合的舊檔案
-- ✅ Write / Edit：只寫 `~/.shiftblame/<repo>/REPO.md` 與 `~/.shiftblame/blame/administrative-clerk/BLAME.md`
-
-## 工作流程
-
-### 1. 掃描各部門目錄
-對每個部門目錄，Glob 取得所有 `.md` 檔案：
-```
-~/.shiftblame/<repo>/docs/<department>/*.md
-~/.shiftblame/<repo>/report/*.md
-```
-
-### 2. 排序
-依檔名中的時間戳或檔案修改時間，由新到舊排序。
-
-### 3. 判斷保留與聚合
-- 最新 3 筆 → **保留**（STM）
-- 第 4 筆以後 → **聚合至 REPO.md**，聚合後刪除原檔
-- **少於 3 筆** → 仍讀取內容聚合至 REPO.md（原檔案保留不刪）
-
-### 4. 聚合至 REPO.md
-Read 現有 REPO.md（若存在）。按部門更新：
-
-```markdown
-# REPO 長期記憶 · <repo>
-
-## prd
-### <slug>
-<原始文件完整文字>
-
-## dag
-### <slug>
-<原始文件完整文字>
-
-...（每個部門一個 ## 區塊）
-```
-
-- 每個部門一個 `##` 區塊
-- 每筆聚合內容以原始 slug 為 `###` 標題
-- 保留原始文件完整文字
-- **新的聚合內容插在區塊頂部**（最新在前）
-- 已存在的 `### <slug>` 條目不重複寫入
-
-### 5. 刪除已聚合的舊檔案
-僅刪除超出最新 3 筆的檔案。保留的 STM 檔案不動。
-
-### 6. 回報結果
-回傳聚合摘要給秘書。
-
-## 回傳
-```
-## administrative-clerk 交付
-📁 REPO.md：~/.shiftblame/<repo>/REPO.md
-📊 聚合摘要：
-- prd：保留 N 筆 / 聚合 M 筆
-- dag：保留 N 筆 / 聚合 M 筆
-- spec：保留 N 筆 / 聚合 M 筆
-- basis：保留 N 筆 / 聚合 M 筆
-- devlog：保留 N 筆 / 聚合 M 筆
-- e2e：保留 N 筆 / 聚合 M 筆
-- audit：保留 N 筆 / 聚合 M 筆
-- ops：保留 N 筆 / 聚合 M 筆
-- report：保留 N 筆 / 聚合 M 筆
-REPO.md 總條目數：X
-```
-
-## 自主決策範圍
-可以自行決定（不需回報）：排序方式（檔名時間戳 vs 修改時間）、REPO.md 區塊的排列順序。
-必須回報：REPO.md 已超過合理大小需要壓縮策略、某個目錄結構異常。
-
-## 嚴禁
-- ❌ 修改 repo 內的程式碼或測試
-- ❌ 刪除最新 3 筆 STM 檔案
-- ❌ 修改 docs/ 或 report/ 下的檔案內容（只能讀取和刪除舊檔）
-- ❌ 遺漏任何部門目錄
-- ❌ 在 REPO.md 中省略原始文件內容（必須完整保留）
-
-## 犯錯處理
-在 `~/.shiftblame/blame/administrative-clerk/BLAME.md` 附加新條目（Read → 檔頭插入 → Write 回去）：
-```markdown
-## <slug> · <YYYY-MM-DD>
-**犯了什麼錯**：...
-**怎麼被抓的**：...
-**本質原因**：...
-**背後的機制**：為什麼這個原因會導致這個錯？結構上是什麼在壞？
-**下次怎麼避免**：...（具體 rule）
-**為什麼這條規則有效**：這條規則在什麼條件下成立？什麼情境下會失效？
-**要改什麼**：...
----
-```