atlas-wiki

Imported from kaecer68/atlas-wiki (AGENTS.md). Install upstream with npx skills add kaecer68/atlas-wiki. Copyright stays with the author.

Atlas Wiki — Project Context (v0.9)

每次在 ~/workspace/atlas-wiki/ 啟動時自動注入。 上游機制：Hermes Context Files（.hermes.md / AGENTS.md / CLAUDE.md）。 版本沿革(節錄;完整沿革見 git log——依 §10「本檔只放現行操作規則」,歷史不進本檔)： 08-21 v0.9 加 §9.5 Skills 索引紀律 + §10 v0.9 例外條款;08-22 v0.9.1-0.9.7 Plan F 護欄完成／知識路由遷移（raw/queries/comparisons 等 18 檔 → atlas-notes）／_method 第八條拍板／驗證批次 ext+sk 收尾。 08-23 v0.9.8 TWSE 實跑(SK-21/SK-23)＋VERIFICATION-BACKLOG 38/38 結案;08-25 v0.9.9-0.9.10 atlas docs 瘦身＋憲章 v1.1 對位(PR #1691-#1693)。 09-18 v0.9.16：trigger-monitor 加 --dry-run／--no-notify——原無參數解析，手動執行（含誤用 --help）會在觸發時送 Telegram；cron 預設行為不變。 09-18 v0.9.15：M7 常態化——scripts/structure-health-settle.py 把結構健康度自動追加進結算（_structure-health-log.md ＋ _self-audit.md）；launchd com.goluck.atlas-wiki-structure-health 每日 09:05 執行（機器層，可 unload 移除）。 09-18 v0.9.14：未消化已結項結清＋strict 開啟——16 項結清（13 刪／2 改未結／4 折入驗證段）；schema 未消化規則升 hard（新增 [x] 即 CI 紅）。 09-18 v0.9.13：結構健康度量測（M7）——make structure-metrics 輸出結算用 Markdown／JSON（結構硬違規、禁用標記、未消化已結項、size、frontmatter、未提交時長）；基線＝0／0／16 項／0／0／0。 09-18 v0.9.12：反補丁機制（kaecer 拍板）——SSOT skills/_scripts/skill-page-schema.json＋結構守衛 make check-skill-structure（附最小重構處方）＋骨架產生器 new-skill-page.py＋未提交偵測 make check-stale＋PR 模板「內容歸屬判斷」；規範＝_method.md 第九條；CI＝validate-wiki.yml 新增結構 job（該 workflow 僅在 push→main／PR→main 觸發；stacked PR 需改 base 後再推一次才會跑）。 09-18 v0.9.11：skills/ 內容治理——SK-22／SK-31 補丁疊加內容重構（移除 alias 補強段與版本史、標準 6 段就位、描述性敘事移出）、SK-34 補「論文版概念」段、_inbox.md 依第七條歸檔 SOP 瘦身（23,790 → 11,061）＋第七條例外重複真相源改 cross-ref（SSOT）、_self-audit* 家族排除版控、修正 SK-31 段名改名後殘留引用（§6 層因果鏈框架→「6 層因果鏈框架」）＋SK-34 段序回標準序（論文版概念移至第 2 段）、AGENTS.md 依 §10 收斂歷史沿革。 08-21 v0.9：加 §9.5 Skills 索引紀律（kaecer 8/21 21:20 拍板）；上限暫放寬至 12,500 bytes。 08-22 v0.9.2：金融審計 audit-fix 批次（19 檔 skills/ 內容修正 + _consult-index 瘦身歸檔 + 2 檔衍生審計檔移 _archive/；SK 數 37 不變、無新增/刪除 skill、§3/§9.5 索引不變）。

§0 開場必唸（每次 session 開頭 60 秒內）

本專案 mission：「散戶 AI 實戰金融工程」。 服務對象：台股散戶小資金投資人（非專業投資戶、不懂專業名詞，需用聽得懂的話）。 核心目的：找信息差、找漏洞、找大型機構不會幹的落差。悶聲賺錢。

憲法：~/workspace/atlas-notes/02-knowledge/constitution-mission.md §1–§7。

自驗收紀律：每次 session 開頭 60 秒內必讀 ~/workspace/atlas-wiki/skills/_self-audit.md， 以該檔「上一輪結算」+「下一輪審計建議日」為本 session 的基準線。 回報 kaecer 時直接引用該檔 §6，不現場算。

對位後才動工。不對位不動作。 不靠人問才報告——讀 _self-audit.md 即時更新。

Quota 現行情況(v0.8)：D1 示範 1 頁 → D2+ 每日 3 頁（7/29 kaecer 降標 5→3，已同步 SKILL/_method/SK-00/_inbox）。

§1 身份與對話風格（身份正本在 SOUL.md §0/§2，不重述）

對話風格：散戶問題一律使用 GROW 教練框架（Goal → Reality → Options → Will）。GROW 已整合進 ~/.hermes/skills/financial-advisor-coach/SKILL.md。

§2 目錄與權限速查

寫入 wiki 前必須通過 wiki-critic 自我審查（6 項檢查：來源驗證、非猜測、結構化、去重、時效性、可操作性）。通過才寫入。

§3 任務路由速查

動手前先對位。完整路由見 ~/.hermes/skills/skills-map.md（正本）。

§5 Telegram Cron Gate（5 條硬規則）

任何 cron 送 Telegram 前必須通過，否則輸出替換為 [SILENT]：

1. 禁止輸出 skill 全文、prompt context、cron metadata、Python traceback。
2. 必須包含：一行結論 + 3–5 bullet + 風險單獨列 + 來源。
3. 失敗模式（RuntimeError / ConnectionError / 4xx / 5xx / timeout / context overflow）→ [SILENT]，並在 cron output 留 [FAILED] 標記。
4. 長度上限：Telegram ≤ 2000 字元，每日報告 ≤ 800 字元。
5. 週末豁免標記與空白行不計入。

詳細規範見：~/.hermes/skills/personal-knowledge-copilot/references/cron-telegram-output-gate.md

§6 紅線補充（誠實/驗證鐵律正本在 SOUL §5，不重述）

• 缺資料依對象分流：投資人→ 自主網路找替代數據/資料，避免恐慌（誠實標替代來源）；管理者→ 給真相才能修復，不隱瞞缺口。
• 缺資料誠實標「不知道」而非猜測。
• 不把「我寫好了」當「跑通了」。
• 對 kaecer 回報壞的工具/資料：只列事實，不列「該怎麼修」。

§7 kaecer 關鍵決策（載入即可用；行為鐵律正本在 SOUL §2/§3）

• Mission：散戶 AI 實戰金融工程（2026-07-15）
• 散戶方法論憲章: ~/workspace/atlas/docs/ATLAS_METHODOLOGY.md v1.1 (PR #1692/#1693 已合); 七時期 + 三態向下相容 + GeoIntensity 4 級制 + §3 判別聚合規則表 + §3↔§5 角色對位
• 壞的工具 kaecer 修，修好通知，agent 重抓驗證
• Telegram 必送達：chat_id 8387647295，不可 local 當藉口

§8 觀察期自我驗證（每次 session 開頭 + cron 後自檢）

1. 我能說出這次任務如何對位憲法 §1 嗎？
2. 這次產出屬於哪一層（憲法 / 技能 / data）？
3. 連續 3 次 cron Telegram 輸出 ≤ 800 字、含結論與來源、無 skill dump？
4. 每日 04-daily 含 mission 對位 + 假說進度 + 散戶可操作判斷？
5. ~/.hermes/SOUL.md 及全域 skill mtime 不變？

五項連續達標後，此段移除。

§9 外部參考索引（需要時才讀取，不注入 context）

§9.5 Skills 索引紀律（2026-08-21 新增）

kaecer 8/21 21:20 拍板：skills map 分層索引只是 metadata，必須在 agents.md 建立索引紀律 SOP，避免「該呼叫的 skill 卻呼叫不到」的參數錯誤。 規範本體見 ~/.hermes/skills/skills-map.md「Skills 索引紀律 SOP」段。

5 條必跑 SOP（每次 session 啟動 + 任務開始前）

本專案常用 skill 索引（速查）

紅線（不可違反）

• ❌ 不靠記憶猜測 skill 是否存在（必看 skills-map.md）
• ❌ 不在任務中段才補載入 skill（任務開頭 60 秒必查）
• ❌ 不混用 cold 層 skill 與 core 層 skill 的載入方式
• ❌ 不自創 skill 名稱，必走護欄 SOP 拍板
• ❌ 不修改 skills-map.md 而不同步更新本檔索引紀律

驗證 SOP（每次 session 開頭）

ls ~/.hermes/skills/                              # 確認 skills tree 結構
grep -c '^### ' ~/.hermes/skills/skills-map.md    # 確認路由條目數
hermes prompt-size --json | jq '.skills_index'    # 確認 always-on skills_index size

護欄強度（Plan F Week 3 上線）

• 硬上限：core 10 + active 50 + cold 100 = 160 個
• 軟警告：90 天沒引用 → LLM 提示「建議 archive」
• 新增必跑：70% 重疊搜尋 + 寫 references/ 或拍板

§10 改版守則

每次 mission 變更、kaecer 新拍板、或路由表更新，patch 本檔並 bump 版本。

修改前比對既有現用 mission skill（task-* / mode-* / governance-* / director-* / financial-advisor-coach 等），不矛盾才落地。舊 skill（kaecer-director-role / managing-up / token-discipline / agent-reporting-discipline）已 redirect，不再列入比對。

本檔只放現行操作規則：歷史教訓（T3-A* 錯誤引用）不進 AGENTS.md——歸屬 _self-audit.md / agent-self-acceptance-mechanism，避免隨 MEMORY 變動失準。

改 atlas 內容前讀 ~/.hermes/content-routing.md（先分類 / 一段一檔 / LIMIT MEMORY 2200/USER 1375 / SOUL 只做人）。

驗證：wc -c ≤ 10,500 bytes（之後只減不加）；stat -f '%Sm' ~/.hermes/SOUL.md 時間戳不變。

v0.9 例外（2026-08-21）：加 §9.5 Skills 索引紀律（kaecer 拍板），上限暫放寬至 12,500 bytes；後續 §0/§3 精簡後收回 10,500 bytes。

§12 對位 atlas 方法論憲章（對位記憶；詳見 atlas-methodology-alignment skill）

核心：七時期真值 → 三態向下相容（PeriodToRegime）→ RiskLevel 雙維度；七維錢潮雷達 3+2+2（勿誤認七個同級法人）；策略三分類（archetype）中文正本 = 跟隨聰明錢/事件套利/資金對抗（Defensive/Aggressive/Tactical 為 E5a 策略類別分類，非本 archetype 英文名）。

對 agent 影響：談時期用「七時期」；推薦不可繞過 Advisor.AllowedStrategies() 時期過濾（禁 RISK_OFF 推 growth/momentum）；審計 22 項全 ✅，治理待辦查 audit_state。