Skip to content

refactor(prompts)!: rename /m2_evolve to /m2_evo - #21

Merged
oahsiao merged 1 commit into
mainfrom
refactor/rename-evolve-to-evo
Jul 27, 2026
Merged

refactor(prompts)!: rename /m2_evolve to /m2_evo#21
oahsiao merged 1 commit into
mainfrom
refactor/rename-evolve-to-evo

Conversation

@oahsiao

@oahsiao oahsiao commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

What

把 slash command /m2_evolve 改名為 /m2_evo,prompt 檔 m2_evolve.prompt.md 隨之更名為 m2_evo.prompt.md。行為完全不變,只有指令名稱變短。順帶補回 CHANGELOG 兩個被吃掉的章節標題。

Why

evolve 語意正確但打起來偏長,而這支指令的子指令(resume / status / checkpoint / pause / stop)都要接在後面,實際輸入長度會再往上疊。evo 是 evolve 的直接縮寫,保留「往更好的方向反覆迭代」的語意,同時把常打的前綴縮短。

過程中另外發現 CHANGELOG.md## v2.1.0## v2.2.0 兩個章節標題不見了,內容被併進上一個版本區塊。根因是前兩次新增版本條目時,取代區塊把下一個版本的標題一起吃掉;其中 v2.1.0 那筆已隨 #20 合併進 main。這不是本次改名造成的,但在同一份檔案上動工時順手修掉,避免 CHANGELOG 繼續失真。

How

  • git mv 更名(相似度 92%,保留檔案歷史)。
  • 更新所有自我引用,共 4 個檔案:
    • m2_evo.prompt.md — 觸發清單、§2.8、§3.1、§4 停止條件、§5.1、§6 子指令對照、§6.1 Resume
    • copilot-instructions.md — §9 routing 表的檔案路徑、「與主流程正交」說明、Auto Mode 章節
    • README.md — 命令表、旁支說明、auto 說明、目錄樹
    • CHANGELOG.md — 新增 v3.0.0
  • 版號定為 v3.0.0(major):依 CHANGELOG.md 開頭自訂的版本規則,「prompt 檔更名、slash command 改名」明列為破壞性變更。
  • 刻意不動的東西(避免無謂的連鎖破壞):
    • 帳本目錄仍是 .evolve/、迭代分支仍是 evolve/* —— 它們描述的是「回合帳本 / 進化分支」這個概念而非指令名稱;改了會讓任何進行中的回合失效,也讓已寫進 .git/info/exclude 的忽略規則失準。
    • prompt 標題仍是 # Evolve — 自主迭代進化evo 只是縮寫,語意來源不變。
    • CHANGELOG 中 v2.2.0 的歷史條目仍寫 /m2_evolve —— 那是當時實際發布的內容,屬史實記錄,不改寫。

Impact

  • 影響範圍:一個 slash command 的名稱,以及三份文件中對它的引用。指令行為、子指令、旗標、輸出格式全部不變。
  • Breaking change:有。 下游 repo 同步後 /m2_evolve 即不存在,需改用 /m2_evo;任何腳本、筆記或習慣打法都要跟著改。
  • 進行中的 evolve 回合不受影響(帳本路徑與分支命名未動),/m2_evo resume 可直接接續。

Verification

  • python scripts/validate.py → 5 個 prompt file 全數通過、0 警告,指令清單已顯示 /m2_evo
  • 全 repo grep m2_evolve,剩餘命中僅存在於 CHANGELOG(v3.0.0 的改名說明 + v2.2.0 的歷史記錄),皆為刻意保留
  • Select-String '^## ' CHANGELOG.md 確認 v3.0.0 / v2.2.0 / v2.1.0 / v2.0.0 章節標題齊全
  • 確認本機未落後 origin/maingit rev-list --left-right --count origin/main...HEAD 左邊為 0)
  • git diff 自檢無機密資料
  • 尚未在實際對話中打過 /m2_evo 驗證 VS Code 有正確載入新指令(需同步或重載後才看得到)
  • CI passed

Shorter to type while keeping the evolve semantics. Behaviour is unchanged; subcommands (resume/status/checkpoint/pause/stop) are untouched. The ledger directory stays .evolve/ and branches stay evolve/* so any in-flight round keeps working.

BREAKING CHANGE: /m2_evolve no longer exists after sync. Update any scripts or docs to /m2_evo.

Also restore the CHANGELOG section headers for v2.1.0 and v2.2.0, which earlier version-entry inserts had swallowed.
@oahsiao oahsiao added the enhancement New feature or request label Jul 27, 2026
@oahsiao oahsiao self-assigned this Jul 27, 2026
@oahsiao
oahsiao merged commit d91d342 into main Jul 27, 2026
1 check passed
@oahsiao
oahsiao deleted the refactor/rename-evolve-to-evo branch July 27, 2026 09:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant