/codex-pro:config skill 名稱與系統「設定」撞名，建議 rename

[kiki830621]

Problem

Original text（使用者於 codex-pro 專案跑 /codex-pro:config 後的回饋）:

❯ /codex-pro:config
You've reached your Fable 5 limit. Run /usage-credits to continue or switch models with /model.
 這邊會跟設定狀名，skill名稱要改掉

— Source: 使用者對話回饋，2026-07-07

詮釋：/codex-pro:config 這個 skill 的名稱 config，加上其 description 的 trigger keywords 含「config, settings, 設定, 配置」等泛用詞，會與 Claude Code 內建的系統「設定」／ /config 命令語意撞名（使用者原文「設定狀名」應為「設定撞名」的 typo）。使用者要求 rename 此 skill。

註：原文第 2 行「You've reached your Fable 5 limit...」是 Claude Code harness 在 Fable 5 額度用盡時插入的系統訊息，不是 config skill 的輸出，與本問題無關 —— 僅恰好出現在同一畫面，特此記錄避免誤導。

Type

refactor

Expected

• skill 名稱不與系統「設定」／內建 /config 撞名，使用者能一眼分辨兩者。
• description 的 trigger keywords 不含過度泛用的「設定 / 配置 / settings / config」，避免 Claude 在無關情境誤觸此 skill。

Actual

• plugins/codex-pro/skills/config/SKILL.md frontmatter name: config。
• 該 description 的 Trigger keywords 明列：profile, config, settings, 設定, 配置, which model, which max-time, show profile, view config, codex-pro profile —— 其中「設定 / 配置 / settings / config」與系統設定概念直接重疊。

Impact

• UX 混淆：使用者難分辨 /codex-pro:config（顯示 codex-pro 已 resolve 的 profile）與系統 /config（Claude Code 全域設定）。
• 誤觸風險：泛用 trigger keyword 讓 Claude 在使用者想找系統設定時可能誤選此 codex-pro skill。namespace prefix（codex-pro:）擋得住 slug 字面撞名，但擋不住語意層的 trigger-keyword 撞名。
• 跨檔改動範圍（供 diagnose 參考，非本 issue 決定）：rename 會牽動 skills/config/ 目錄名、SKILL.md frontmatter、.claude-plugin/marketplace.json、plugins/codex-pro/.claude-plugin/plugin.json（若列舉）、CLAUDE.md 內多處 /codex-pro:config 引用、以及 tests/ 的 namespace consistency grep。

Proposed rename 候選（open — 待 /idd-diagnose 或 /spectra-propose 決定，非本 issue 拍板）

• profile — skill 功能即「display resolved profile」，語意最貼切且完全不與「設定」撞名（推薦起點）。
• show-profile / view-profile — 保留動詞，明示 read-only display 屬性。
• 無論選哪個名稱，一併收斂 trigger keywords，移除泛用的「設定 / 配置 / settings / config」，只保留 profile 相關詞。

---

Current Status

Phase: closed
Last updated: 2026-07-12 by idd-close cluster (via idd-update)

Key Decisions

• Catch-up verify PASS（pai-ensemble 6-AI、18 findings 分類完畢）：/codex-pro:config skill 名稱與系統「設定」撞名，建議 rename #2 (comment)
• In-scope 殘留 4 項已修（commit 77c4239）：cancel shorthand、裸「取消」、result 泛用 keyword、stale count
• Test 防線 findings 併入 review/rescue resolver 缺 no-profile default 的 behavioral 斷言（follow-up finding from #3） #4 scope（anti-guard / negative 斷言 / result enum）；trace 路徑殘留由 specs 的 trace 註解區塊殘留舊 no-prefix skill 路徑（follow-up finding from #3） #5 cover

Scope Changes

• (none — verify-fix 均屬原 rename scope 殘留)

Blocking

• (none)

Commits

• 43b7b67 rename-skills-codex-prefix（主實作，2026-07-08）
• 77c4239 fix: clean rename residue（verify-fix，2026-07-12）
• Tag：idd-2-verified

[kiki830621]

Diagnosis

Type

refactor（專案級命名慣例變更 — scope 已由「rename config」擴大）

Root Cause / Analysis

原 issue #2 的問題是 config 與系統「設定」撞名。使用者於 diagnose 階段擴大了解法方向：

使用者原文（2026-07-07）:
「我覺得應該要叫做 codex-config，這裡面每一個skill都前面加上codex prefix好像比較好」

意圖從「rename 一個 skill」升級為「替全部 9 個 skill 統一加 codex- prefix」的命名慣例。措辭「好像比較好」顯示這是傾向、尚未拍板。

撞名有兩個獨立機制，需分開對付：

1. 名稱 token fuzzy-match — 使用者/Claude 打 config 時，codex-pro:config 被列出。codex- prefix 讓名稱更 distinctive，但 codex-config 仍含 config 子字串 → fuzzy-search「config」照樣命中。若要「完全」不撞，功能名得改掉 config（例如 codex-profile）。
2. trigger-keyword 語意 auto-select — 這才是讓 Claude 在無關情境誤選此 skill 的主因。config/SKILL.md description 明列 config, settings, 設定, 配置。不論名稱怎麼改，都要一併清掉這些泛用 keyword，否則改了名字、關鍵字還在，照樣誤觸。

Impact

Live blast radius（要改）：188 refs / ~27 檔

• README.md(25)、CLAUDE.md(18)
• 9 個 plugins/codex-pro/skills/*/SKILL.md — skill 之間密集交叉引用（cancel 提到 review/rescue/adversarial-review/status/result；config 提到 setup/status/result/cancel…），必須原子式一起改，否則家族不一致
• 10 個 openspec/specs/*/spec.md — per-skill frozen contract 目錄（spec dir 名目前 1:1 對應 skill 名）
• 5 個 tests：result.sh(9)、e2e-checklist.md(5)、status.sh(2)、static.sh(2 — namespace consistency grep)、lib/e2e-claude-print.sh(1)
• plugin.json(prose) + in-progress change harden-producer-heading-reliability/design.md(1)

Frozen archive（禁改）：295 refs 全在 openspec/changes/archive/** — archive-first plugin 保護 + 歷史記錄（記錄當時的真相）。不可 sed 全掃 481 refs，只動 live 的 188。

先例：archive 已有 2026-05-20-consolidate-naming 與 marketplace-pivot 兩個 Spectra change → 本專案 CLAUDE.md 明訂「重大 namespace 變更走 Spectra」。

Strategy（high-level — 細節待 spectra-discuss 對齊）

• /spectra-discuss 對齊命名 scheme：config 確切名、redundancy 接受度、keyword 政策、spec-dir 政策
• rename 9 個 skill 目錄 + 各 SKILL.md name: field
• 更新全部 live /codex-pro:* 交叉引用（188 refs、跳過 archive）
• openspec/specs/* 目錄同步 rename（或明確 decouple invocation-name 與 spec-name）
• 清掉各 skill description 的泛用 trigger keyword（設定/配置/settings/config）
• 改寫 CLAUDE.md 命名慣例段（見下 Risks — 這是明文反轉已 documented 的「final convention」）
• 更新 README + tests（static.sh namespace grep、e2e-checklist.md）
• bash tests/run.sh 全綠 + tests/e2e-checklist.md（namespace 級變更需手動跑）

Conflict Class

B_resource_serialize — 共享資源 = 整個 /codex-pro: invocation namespace + per-skill openspec/specs/ 樹；此變更是 wholesale rewrite，無法與任何其他觸及這些檔案的改動 interleave。（單一 issue 走 Spectra，非 idd-all batch，故此欄位主要為 informational。）

Complexity

Spectra

• Layer 2（necessary）命中：改動對外暴露的 plugin skill 觸發面（所有 invocation 名）+ 修改 10 個 published spec 的 normative 內容。
• Layer 3 命中 3 項：
  1. 修改既有 published spec 的 normative behavior（per-skill spec dir 全動）
  2. 影響 2+ 既有 specs 需 consistency-check（實為全部 10 個）
  3. Architectural decision with long-term maintenance implications（命名慣例 = 會被 future skill authors 繼承的結構性決定）
• 專案先例：CLAUDE.md 明訂 namespace 變更走 Spectra（consolidate-naming / marketplace-pivot 前例）。

→ Next: /spectra-discuss（default — 存在多個 open questions，見 Risks/Residue）。

Vagueness Pre-check

• V1（vague WHAT）: 3 — WHAT 清楚（全 skill 加 codex- prefix）；殘留的是命名 taste-decision，非需求模糊。
• V4（vague ACCEPTANCE）: 3 — 完成定義可枚舉（9 skill renamed + 188 live refs 更新 + tests 綠 + CLAUDE.md 改寫）。
• Triggered: no — 兩軸皆 ≤ 3。

Risks

• 漏改某個交叉引用 → 家族不一致（static.sh namespace grep 應能抓，須確保它覆蓋 rename 後的名稱）。
• 誤 sed 到 archive/ → 破壞 frozen 歷史記錄（archive-first 會擋 destructive op，但 Edit/Write 也被擋，須繞開）。
• openspec/specs/ dir rename 若 Spectra 工具用 spec-id 索引，改名可能斷連 → discuss 需確認 spec-name 是否綁 invocation-name。
• 反轉 documented「final convention」：CLAUDE.md 現寫「所有 skill 觸發名統一形如 /codex-pro:<skill>… 此為 final naming convention，無下次 reverse 計畫」。本變更明文推翻它 —— 不是 bug，是 deliberate 決策反轉，須在 change proposal 誠實記錄「為何反轉」。
• codex-pro:codex-* redundancy：「codex」出現兩次，未來可能被嫌冗長 → bikeshedding 風險。trade-off：家族一致/distinctive vs 視覺冗長。
• 既有使用者肌肉記憶斷裂：invocation 名全變。但 plugin 目前以 local dev 為主、對外採用低，現在改成本最低。

Residue

使用者要的其實是「一個自洽、distinctive、永不與系統命令撞名的 skill 家族」這個美學/一致性 horizon。機械 rename 能 operationalize 其中大部分，但「codex-config 讀起來對不對 vs codex-profile 更精準」是只有使用者能拍板的品味判斷 —— 不靜默丟棄，列為 spectra-discuss 的首要議題。

Sister Concerns Filed (mid-diagnose)

(none surfaced) — 分析中浮出的相鄰項（trigger-keyword genericness、CLAUDE.md「final convention」失效、plugin.json description 膨脹）皆已納入本變更 scope 或屬同一 refactor，無獨立旁支 issue 需開。

Checklist synced at close time（2026-07-12）— rename 於 commit 43b7b67 落地（Spectra change archived、370 tests 綠）、殘留於 77c4239 清理；catch-up verify PASS。

[kiki830621]

Verify: #2

Engine

pai-ensemble 2.18.0 (canonical #207) — 4 IDD lenses + DA + Codex (gpt-5.5), model: opus（6/6 agents、0 error、937s）

驗證性質

Catch-up verify — 對已 ship 4 天的 commit 43b7b67（rename-skills-codex-prefix，47 檔）事後補驗；後續 #3 model bump 已疊其上，findings 均已對 repo 現況核實。

要求覆蓋率

2/2 — 9-skill codex- 前綴 rename ✓（370/370 tests、無裸名 invocation 殘留）；trigger keyword 去泛用化 ✓ 核心案例（config 的 設定/config 撞名已解），但殘留少數未列舉泛用詞（見 findings，已修）

Findings（合併後，18 raw → 分類）

#	Severity	Finding	Source	Action
1	MEDIUM	cancel SKILL.md 殘留舊裸名 shorthand :rescue / :adversarial-review（×2 處，中英文各一）	codex	In-scope fix ✅ 已修（77c4239）
2	MEDIUM	cancel 帶裸「取消」trigger keyword — 同 issue #2 要消除的誤觸 class（DA 修正：severity 偏高、屬未列舉殘留非 requirement 違反）	agents:requirements + DA	In-scope fix ✅ 已修 — qualify 為「取消 codex」等（77c4239）
3	LOW	result keywords 殘留泛用「看完整 / detail」（DA 抓到、全 lens 漏）	agents:devils-advocate	In-scope fix ✅ 已修（77c4239）
4	LOW	codex-config 自稱「第 10 個 user-facing capability」stale count	codex	In-scope fix ✅ 已修（77c4239）
5	MEDIUM	live specs 的 trace 註解 code-list 指向 rename 前舊路徑（+ config spec 新舊路徑混列）	codex, agents:requirements	Follow-up → #5 已 cover（diagnose 已把 scope 實測擴為 122 處 / 10 檔）
6	LOW×3	tests 防線缺口：config.sh 主動 whitelist 設定/配置（anti-guard）、缺 negative keyword 斷言、result --latest 無 enum 驗證（garbled codex-codex-*）	codex, agents:regression+logic+DA	Follow-up → 併入 #4 scope（user 裁決 2026-07-12，見 #4 scope-change comment）
7	MEDIUM	archive proposal/design 低估 status/result 的 trigger-keyword contract 變更	codex	Dismissed — archive 是歷史紀錄不改；contract 實質已在 spec delta 正確落地
8	MEDIUM	proposal 宣稱更新的 3 檔未出現在 diff	codex	Refuted — repo 現況 grep 零裸名殘留；artifact 措辭不精確非漏改
9	LOW	setup spec delta 未 pin path/name 與 blanket wording 不符	codex	Dismissed — archive artifact 措辭；active spec 行為正確
10	INFO	rename 在 0.5.1 未 bump version 下 ship（breaking invocation）	agents:regression	Stale — 已被 0.6.0（ea5f6a8）superseded
11	INFO	clean 確認：無 prompt-injection、跨模型一致	codex, agents:requirements	—

Scope Check

乾淨 — commit 43b7b67 內容全屬 rename scope；verify-fix 追加 3 檔 5 處一行級修正（77c4239），均屬 issue #2 原始 scope 的殘留清理。

Verify-fix 後全量回歸

bash tests/run.sh 全綠（370/370、10 layers）

Aggregate

PASS — 0 blocking 殘留（in-scope 全修、follow-up 分流至 #4/#5、archive 措辭類 dismissed）

Follow-up Findings Filed (v2.72.0+ #148)

• 併入 review/rescue resolver 缺 no-profile default 的 behavioral 斷言（follow-up finding from #3） #4（test 防線三項 — scope 擴充，非新 issue）
• specs 的 trace 註解區塊殘留舊 no-prefix skill 路徑（follow-up finding from #3） #5（trace 路徑殘留 — 既有 issue 已 cover，diagnose 已收斂 scope）

Process Gaps

（none — 6/6 agents 完成）

[kiki830621]

Closing Summary

Problem

/codex-pro:config skill 名與 Claude Code 內建 /config／系統「設定」語意撞名，且 9 個裸 skill 名 + 泛用 trigger keywords（config, settings, 設定, 配置…）導致 Claude auto-select 誤觸。

Root Cause

初版命名慣例只靠 namespace prefix（codex-pro:）擋字面撞名，未考慮 (a) skill 裸名與系統命令的語意撞名、(b) description trigger keywords 的泛用詞會參與 Claude 的 skill 路由 — 兩者疊加讓「設定」類請求誤路由到 codex-pro。

Solution

Spectra change rename-skills-codex-prefix（archived 2026-07-07）：全 9 skills 目錄名 + frontmatter name: 加 codex- 前綴（觸發名 /codex-pro:codex-<skill>）、trigger keywords 去泛用化、CLAUDE.md 明文反轉舊「final naming convention」記載。Close 前 catch-up verify 再清 4 處殘留（cancel shorthand ×2、裸「取消」、result 泛用 keyword、stale capability 序號）。

Verification

• Catch-up 6-AI ensemble verify（2026-07-12）PASS — 18 findings 分類：4 項 in-scope 已修、test 防線 3 項分流併入 review/rescue resolver 缺 no-profile default 的 behavioral 斷言（follow-up finding from #3） #4、trace 路徑由 specs 的 trace 註解區塊殘留舊 no-prefix skill 路徑（follow-up finding from #3） #5 cover、archive 措辭類 dismissed
• 370/370 tests 綠（rename 當時）+ 殘留修後全綠
• Verify report: https://github.com/PsychQuant/codex-pro/issues/2#issuecomment-4949815623｜Tag: idd-2-verified

Changes

• 43b7b67 rename-skills-codex-prefix 主實作（47 檔、+1083/−319，2026-07-08）
• 77c4239 catch-up verify in-scope 殘留清理（2026-07-12）

Residue Acknowledgement

Resolved（user 品味拍板 2026-07-12）：residue「codex-config vs codex-profile 何者更精準」— 裁決維持 codex-config：「profile」會讀成效能 profiling（看 codex 速度用的），語意不同；config 是正確的名字。Residue 解消，無 follow-up。

Distribution Sync

• Detected: plugin（codex-pro marketplace）
• Choice: chain to /plugin-tools:plugin-update（cluster-level，一次裁決涵蓋 review/adversarial-review Step 3 system-instruction hardening — required H2 headings unreliable in Codex output #1 /codex-pro:config skill 名稱與系統「設定」撞名，建議 rename #2 review/rescue resolver 缺 no-profile default 的 behavioral 斷言（follow-up finding from #3） #4 specs 的 trace 註解區塊殘留舊 no-prefix skill 路徑（follow-up finding from #3） #5）
• Outcome: plugin 0.6.0 → 0.6.1 bumped + marketplace synced + installed plugin updated（restart to apply）
• At: 2026-07-12T07:18:25Z