inkstone/ISEP
2
0
Fork 0
Code Issues 18 Pull Requests 1 Actions Packages Projects Releases 22 Wiki Activity

身為必須讀完才能開工的人，我要 wiki 太長時有人整理，我才不會面對一個讀不完的必讀檔 #89

New Issue
Closed
opened 2026-08-27 14:31:28 +00:00 by claude-code · 0 comments
claude-code commented 2026-08-27 14:31:28 +00:00
Member
Copy Link
Copy Source

問題

wiki 檔案一直長大，沒有人會回頭整理。leo 2026-08-27 說今天「失去記憶」——而記憶失效的其中一個原因就是：東西還在，但沒人讀得完。

mistakes.md 已經數千行。它是「必讀」等級的檔案，但沒有人真的每次都從頭讀。讀不完的必讀檔，等於沒有。

目標

檔案太長就要整理，而且整理本身要當成一件正式的工作來做，不是順手做。

分兩種處理：

  • 一般 wiki 檔：拆成資料夾＋子檔，原位置留一份目錄（每個子檔一句話說它在講什麼）
  • 必讀單檔（mistakes.md、CLAUDE.md 這種）：
    1. 同類的合併成一條，記「發生過幾次」（「×5」比重複五行有用）
    2. 已經解決的濃縮成一行教訓＋票號
    3. 還是太長 → 整類搬去另一個檔，原檔只留一行指過去

驗收條件

  1. 拿現在的 mistakes.md 壓一次 → 壓完之後同一件事查得到、而且查得比壓之前快
  2. 壓縮前後 → 不能弄丟任何一條教訓（要能逐條對帳）
  3. 壓縮這件事本身 → 要有票、有交付紀錄，不准順手做完沒人知道

deliverable 類型

code（→ PR）

細節

這條在 SOP 裡的位置：S14（wiki 壓縮）。

現況實查（/home/user/inkstoneco/InkStoneCo/system-dev/wiki/，2026-08-27）：mistakes.md 數千行、status.md 與 decisions-summary.md 同樣是千行等級。

為什麼「順手壓縮」被明文禁止：壓縮會弄丟東西，而弄丟的當下沒有人會發現。要留痕才知道哪一版壓掉了什麼。

已經有的、不要重造：wiki-secret-scan.sh（寫進 wiki 前掃機敏值）、wiki-first-search.sh / wiki-first-police.sh（先查 wiki 才准查別的）。這三支管的是「寫進去」和「讀出來」，沒有任何一支管「太大了」。

與 S13 的接口：mistake-needs-ticket-guard.sh 已經逼「往 mistakes.md 寫新教訓要附票號」。做過那一步的條目天然已經是壓縮態（一行＋票號），所以壓縮的主要工作是處理它上線之前累積的那幾千行。

相關既有票：InkStoneCo#95「身為 memory 不靠譜的 agent，我需要能迭代 wiki 的記錄方式」——同一條線，要互相連結。

🔎 為什麼另開一張票而不是貼進既有的（開票時聲明）：wiki-secret-scan 管寫入安全、wiki-first-search/police 管有沒有先查，都不管體積。#95 講記錄方式要能迭代，本票是它的下游具體工項。
當時搜尋：wiki 壓縮 過長 巢狀 mistakes → 命中 60 張。

## 問題 wiki 檔案一直長大，沒有人會回頭整理。leo 2026-08-27 說今天「**失去記憶**」——而記憶失效的其中一個原因就是：**東西還在，但沒人讀得完**。 `mistakes.md` 已經數千行。它是「必讀」等級的檔案，但沒有人真的每次都從頭讀。**讀不完的必讀檔，等於沒有。** ## 目標 檔案太長就要整理，而且整理本身要當成一件正式的工作來做，不是順手做。 分兩種處理： - **一般 wiki 檔**：拆成資料夾＋子檔，原位置留一份目錄（每個子檔一句話說它在講什麼） - **必讀單檔**（`mistakes.md`、`CLAUDE.md` 這種）： 1. 同類的合併成一條，記「發生過幾次」（「×5」比重複五行有用） 2. 已經解決的濃縮成一行教訓＋票號 3. 還是太長 → 整類搬去另一個檔，原檔只留一行指過去 ## 驗收條件 1. 拿現在的 `mistakes.md` 壓一次 → **壓完之後同一件事查得到、而且查得比壓之前快** 2. 壓縮前後 → **不能弄丟任何一條教訓**（要能逐條對帳） 3. 壓縮這件事本身 → **要有票、有交付紀錄**，不准順手做完沒人知道 ## deliverable 類型 code（→ PR） --- <details><summary>細節</summary> **這條在 SOP 裡的位置**：S14（wiki 壓縮）。 **現況實查**（`/home/user/inkstoneco/InkStoneCo/system-dev/wiki/`，2026-08-27）：`mistakes.md` 數千行、`status.md` 與 `decisions-summary.md` 同樣是千行等級。 **為什麼「順手壓縮」被明文禁止**：壓縮會弄丟東西，而弄丟的當下沒有人會發現。要留痕才知道哪一版壓掉了什麼。 **已經有的、不要重造**：`wiki-secret-scan.sh`（寫進 wiki 前掃機敏值）、`wiki-first-search.sh` / `wiki-first-police.sh`（先查 wiki 才准查別的）。這三支管的是「寫進去」和「讀出來」，**沒有任何一支管「太大了」**。 **與 S13 的接口**：`mistake-needs-ticket-guard.sh` 已經逼「往 mistakes.md 寫新教訓要附票號」。做過那一步的條目**天然已經是壓縮態**（一行＋票號），所以壓縮的主要工作是處理它上線之前累積的那幾千行。 **相關既有票**：`InkStoneCo#95`「身為 memory 不靠譜的 agent，我需要能迭代 wiki 的記錄方式」——同一條線，要互相連結。 </details> --- > 🔎 **為什麼另開一張票而不是貼進既有的**（開票時聲明）：wiki-secret-scan 管寫入安全、wiki-first-search/police 管有沒有先查，都不管體積。#95 講記錄方式要能迭代，本票是它的下游具體工項。 > 當時搜尋：`wiki 壓縮 過長 巢狀 mistakes` → 命中 60 張。
claude-code added this to the SOP 變成閘 milestone 2026-08-27 14:32:36 +00:00
claude-code added the
s
todo
type
governance
 labels 2026-08-27 14:32:37 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Human
👤 這件事需要 leo 親手批示／動手（花錢・不可逆・品味方向・物理動作）。與 s/* 正交
close
duplicate
重複——關新的、留舊的，並指向舊票
close
human-exec
人執票完成，由人手動關
close
merged
PR merge 自動關（正常路徑）
close
split
太大，已拆成數張子票
close
stale
逾期無資訊，自動關閉
close
transferred
走錯棚，已在正確的 repo 重開
close
wontfix
討論後決定不做（只有 leo 可下此判斷）
hub
Tracking issue——聚合一批 leaf 的 scope 容器，本身不掛 milestone、不對應 PR
 human/exec
👤 這張票的『執行者』是人（GUI-only／實體權限／法定簽署），不是審核。交付物是環境狀態改變，不是 PR
p
high
高——擋住交付或有時間壓力
p
low
低——想做，但晚一點沒關係
s
backlog
驗過了、確定要做，但還沒排進任何 sprint
s
doing
進行中——已 self-assign，現在有人在做
s
pending
卡住——等外部／等依賴，不是沒人做
s
review
PR 已開（含 closes #n），等總管 review 並 merge
s
stage
已部署 stage，等 leo 實際驗收
s
todo
已排進 milestone，等人領票
s
triage
新進來的，還沒驗傷——還沒決定要不要做
type
bug
壞掉的東西
type
chore
雜務、整理、不改行為
type
feature
新能力
type
governance
規範、流程、閘本身
No Label
s
todo
type
governance
Milestone
No items
No Milestone SOP 變成閘
Projects
Clear projects
No project
Assignees
Clear assignees
Leo claude-code (claude-code)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: inkstone/ISEP#89
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?