codex+gpt5.5+Superpowers 實踐：開發Mac壓縮軟件

作者：範範的diary

日期：2026年5月10日下午6:12

來源：WeChat 原文

✦整理版優先睇

速讀 5 個重點高亮

用 Codex + GPT5.5 + Superpowers 開發 Mac 壓縮軟件嘅完整紀錄

整理版摘要

呢篇文章係作者分享佢用 AI 編程工具 Codex，配合 Superpowers 方法論，由零開始開發一個 Mac 壓縮軟件嘅過程。作者平時需要用分卷壓縮功能，但 Mac 上好多壓縮軟件都要收費，所以佢諗住用 AI 嚟整一個簡單實用嘅版本。之前佢已經用 Claude Code 加 GLM5.1 做過一次，但冇記錄低。今次佢用 Codex（GPT5.5）同 Superpowers 插件，Superpowers 係一套完整的軟件開發方法論，可以強制 AI 跟住固定流程，提高軟件質量。

開發流程分七個階段：頭腦風暴、用 Git Worktree 隔離工作區、編寫計劃、子代理驅動執行、測試驅動開發、代碼審查、完成分支。作者詳細展示咗每個階段嘅執行情況，尤其係頭腦風暴階段 Codex 會用 HTML 畫出界面佈局，同作者確認需求。整個開發過程持續約兩個鐘，最後成功整咗一個支援基本壓縮、分卷壓縮、加密壓縮、解壓到指定目錄嘅 Mac 桌面軟件，壓縮格式包括 zip、gzip、tar、tar.gz 等。

作者之後進行人工驗收，發現界面混亂、功能佈局等幾個問題，全部經 Codex 嘅 Computer Use 功能自動修復。最終成品已經放上 GitHub，支援 M 系列晶片。文章最後亦反思咗會話上下文溢滿嘅問題，同埋要及早將約束寫入 AGENTS.md。

AI 編程配合 Superpowers 方法論，可以快速產出可用嘅桌面軟件，唔需要專業編程知識。
Superpowers 七步流程：頭腦風暴、Git Worktree 隔離、寫計劃、子代理驅動執行、TDD、代碼審查、完成分支，確保開發質量。
頭腦風暴階段用 HTML 畫界面佈局，能夠清晰同作者確認需求，減少後期修改。
子代理驅動執行會分配三個子代理：執行、檢查設計符合度、檢查代碼質量，自動修復問題。
作者提醒要將約束（例如用中文溝通）寫入 AGENTS.md，避免上下文壓縮後遺忘；同埋學習 harness 工程喺新會話中繼續工作。

值得記低

連結 openai.com

Codex

OpenAI 嘅 AI 編程工具，用 GPT5.5 模型，支援高強度思考。

連結 github.com

Superpowers

一套軟件開發方法論，強制 AI 編程工具用固定流程，包含頭腦風暴、git-worktree、計劃、子代理開發等七個階段。

連結 7-zip.org

7zip for Mac 命令行工具

提供壓縮同解壓嘅基本指令，係今次軟件嘅底層工具。

連結 github.com

成品壓縮軟件（zipmac-codex）

最終開發完成嘅 Mac 壓縮軟件，支援分卷、加密、多種格式，只支援 M 系列晶片。

整理重點

點解要開發呢個壓縮軟件？

作者平時成日用 AI 編程工具開發實用小工具，因為佢發現呢啲工具可以大幅降低編程門檻。今次佢需要一個分卷壓縮功能，但係 Mac 上面好多壓縮軟件都要收費，所以佢決定自己整一個。

用 AI 編程工具，幾乎唔需要懂編程就可以開發可用軟件

之前佢用 Claude Code 同 GLM5.1 嘅組合已經成功整過一次，但冇記錄低。今次佢轉用 Codex（GPT5.5）同 Superpowers 插件，想對比下效果。Superpowers 係一套完整的軟件開發方法論，可以令 AI 跟住固定流程，提升最後軟件嘅質量。

整理重點

Superpowers 七步流程：由頭腦風暴到完成分支

作者嚴格按照 Superpowers 嘅七個階段進行開發，每個階段都有明確目標。第一階段係頭腦風暴，Codex 會通過提問同 HTML 界面圖同作者澄清需求。

頭腦風暴階段用 HTML 畫出界面佈局，作者可以直接確認同提出修改

第二階段係用 Git Worktree 建立隔離工作區，確保開發唔影響主分支。第三階段係編寫計劃，將工作拆分成細任務，每個任務都包含文件路徑、完整代碼同驗證步驟。

頭腦風暴：梳理需求、輸出設計文檔，包括界面、架構、數據流、錯誤處理、測試策略。
Git Worktree：建立隔離工作區，運行項目設置。
編寫計劃：將工作分解成 2-5 分鐘嘅小任務，附帶精確路徑同驗證步驟。
子代理驅動開發：每個任務分配三個子代理（執行、檢查規範、檢查代碼質量）。
測試驅動開發：紅綠重構流程，先寫失敗測試，再寫最小代碼。
代碼審查：按計劃審查，報告問題嚴重程度。
完成分支：驗證測試，清理工作樹，提供合併選項。

整理重點

執行、測試同人工驗收：兩小時完成核心開發

作者選擇咗子代理驅動執行模式，Codex 依次執行曬所有 task，總共耗時兩個鐘。完成後作者進行人工驗收，發現咗幾個問題。

界面混亂問題：用 Codex App 嘅 Computer Use 功能自動修復，唔需要手動截圖

其他問題包括壓縮同解壓模塊共用界面空間、界面拖動限制、檔案區唔支援拖拽。作者逐一測試，Codex 都順利修復咗。最終軟件支援基本壓縮、分卷壓縮、加密壓縮、解壓到指定目錄，壓縮格式包括 zip、gzip、tar、tar.gz 等。

拖拽功能由作者提出，Codex 評估後快速實現，測試冇問題

1 問題1：界面混亂 ➔ Codex App Computer Use 自動修復。
2 問題2：壓縮同解壓共享空間 ➔ Codex 修復共享隊列問題。
3 問題3：界面拖動限制 ➔ Codex 修復缺陷。
4 問題4：唔支援拖拽上傳 ➔ Codex 添加拖拽功能。

整理重點

反思同未來改進方向

作者指出由於項目難度唔大，佢全程喺同一個會話中完成，導致後期上下文一直爆滿。佢打算之後學習 harness 工程，以便喺新會話中繼續之前嘅工作。

要將約束（例如用中文溝通）寫入 AGENTS.md，避免上下文壓縮後遺忘

另外作者提醒，一開始佢同 Codex 講咗用中文寫文檔，但隨住對話進行，Codex 慢慢忘記咗，所以最好一開始就寫入 AGENTS.md。佢推薦咗 harness 工程學習資料，係好有用嘅參考。

呢排一直試緊用claude code、codex呢啲AI編碼工具，好大一個感觸係，有咗AI，可以好快開發到一啲好用嘅小工具（幾乎唔需要識編程），為日常辦公提供便利。

因為平時會用到分卷壓縮嘅功能，而針對mac系統嘅好多壓縮軟件如果要支援分卷壓縮都要俾錢，所以就想用AI編程工具開發一個簡易版壓縮軟件，支援平時簡單使用。

呢個項目其實之前已經用 claude code + glm5.1 嘅組合開發過一次，使用體驗好好，但冇記錄低，今次換個組合，揀咗 codex + gpt5.5 嚟開發，同時安裝 Superpowers 插件，用嚟提高開發質量。Superpowers 係一套完整嘅軟件開發方法論，佢強制AI編程工具用固定嘅開發流程，對最終嘅軟件效果提升好明顯。基本工作流程如下：

1. 頭腦風暴——喺寫代碼之前啟動。通過提問完善初步諗法，探索各種方案，分段展示設計以供驗證。保存設計文檔。

2. using-git-worktrees - 設計方案獲批後激活。喺新分支上創建隔離嘅工作區，運行項目設置，驗證測試基線係咪乾淨。

3. 編寫計劃 - 根據已批准嘅設計方案啟動。將工作分解成容易處理嘅小任務（每個任務耗時 2-5 分鐘）。每個任務都包含精確嘅文件路徑、完整嘅代碼同驗證步驟。

4. 子代理驅動嘅開發或執行計劃 - 根據計劃激活。為每個任務派遣新嘅子代理，並進行兩階段審查（先檢查規範符合性，再檢查代碼質量），或者分批執行，並設置人工檢查點。

5. 測試驅動開發——喺實現階段激活。強制執行紅綠重構流程：編寫失敗嘅測試，觀察佢失敗，編寫最小代碼，觀察佢通過，然後提交。刪除測試之前編寫嘅代碼。

6. 請求代碼審查 - 喺任務間隙激活。根據計劃進行審查，並按嚴重程度報告問題。嚴重問題會阻礙進度。

7. 完成開發分支 - 當任務完成後激活。驗證測試，提供選項（合併/PR/保留/丟棄），清理工作樹。

7個工作流程喺下面嘅演示入面都會完整展示。

今次壓縮軟件嘅開發會基於7zip for mac命令行工具實現，我嘅本意係，喺呢個命令行工具嘅基礎上，封裝mac原生界面，供日常使用。

最終軟件演示：

開發過程演示開始（唔包含軟件嘅安裝）。

建立一個空文件夾，名係：zipmac-codex，下載7zip for mac命令行工具，放喺個目錄度。用vscode打開zipmac-codex文件夾，並喺vscode入面打開一個終端，輸入codex，模型用gpt5.5，模型思考強度用high。vscode只用嚟展示文檔同代碼，實際上唔會自己操作，全部由AI完成。截圖如下：

喺codex文本框入面輸入提示詞：

當前目錄下面有一個7zip文件夾，裏面提供咗壓縮同解壓嘅基本命令行功能。我想基於呢個，開發一個mac桌面版嘅壓縮解壓軟件，支援基本壓縮、分卷壓縮、加密壓縮，支援解壓壓縮文件到指定目錄，壓縮格式至少支援zip、gzip、tar、tar.gz等，壓縮級別都需支援。請嚴格按照Superpowers插件嘅流程嚟開發呢個項目。

輸入提示詞之後，按回車鍵，codex會開始工作，截圖如下：

上圖顯示codex開始按照 Superpowers流程開始推進。

1. 第一階段 - 頭腦風暴

呢個階段最重要係梳理核對需求，並輸出詳細設計文檔。繼續啦。

上圖中，codex問使唔使用視覺輔助，我揀咗同意，並叫佢之後用中文同我講嘢。用視覺輔助進行需求澄清係好有幫助嘅，codex會喺需求階段用html畫出界面佈局俾我確認，對界面有咩唔滿意，可以提出建議叫佢改。

上圖中，codex喺展示界面佈局之前，先對一啲需要我確認嘅問題進行咗諮詢，第一個問題我聽咗佢嘅建議，後兩個問題我揀咗自己認為啱嘅選擇。

上圖中，codex畫咗簡單界面佈局，主要係確認功能、大致樣式。之後，仲依次叫我確認咗架構與模塊邊界、數據流與邊界、錯誤處理機制、測試策略，由於我對swift語言完全唔識，基本都揀咗默認推薦嘅策略。其中測試策略分為單元測試、集成測試、人工驗收。

確認曬之後，codex開始寫設計文檔，最終文檔都會推送到github，就唔完全貼曬出嚟啦。

到呢度，第一階段結束。

2. 第二階段 - git隔離工作區

codex用git worktree創建咗單獨嘅工作區，用嚟進行後續嘅開發。其實我之前完全冇用過worktree功能，趁住今次機會學咗一下。

3. 第三階段 - 編寫計劃

codex拆咗10個task，每個task下面再拆咗多個step，唔同task之間嘅依賴關係都係有嘅。

4. 第四至七階段 - 執行計劃，測試驗證，代碼審查，合併分支

執行計劃階段，我揀咗子代理驅動執行，codex會俾每個task分配3個子代理，一個係負責執行計劃嘅子代理，一個係檢查係咪滿足設計文檔嘅子代理，一個係負責代碼檢查嘅子代理。被分配嘅子代理，會獲取到任務執行所需嘅所有上下文。當負責檢查嘅子代理發現問題之後，會要求負責執行嘅子代理進行修復，修復完繼續檢查。codex會依次執行完所有task，耗時2個鐘。

到呢度，codex完成咗所有任務嘅開發、測試、審核。

跟住由我進行人工驗收。

問題1：界面亂糟糟

codex開發完之後，我打開編譯好嘅軟件，如上圖，界面好多模塊都俾壓扁咗，應該係UI嘅問題，今次我冇喺codex cli度叫佢解決，而係喺codex app度叫佢解決，因為app入面Computer Use功能，可以直接操作我部電腦，自動截圖進行驗證。

修復之後嘅界面係下面咁樣：

界面冇任何問題喇，跟住我測試咗基本功能，壓縮、加密壓縮、分卷壓縮、解壓都冇問題。但仲有幾個需要優化嘅地方。

問題2：壓縮同解壓模塊共用界面中間嘅空間

codex修復咗共享隊列問題，我測試之後冇問題喇。

問題3：界面拖動限制

codex正常修復咗呢個缺陷，我測試之後冇問題。

問題4：中間待壓縮文件區域只支援點擊上傳，唔支援拖拽

codex評估之後，拖拽功能容易實現，我確認之後，最終成功加咗呢個功能，測試之後冇問題。

到呢度，軟件開發完成，達到可用狀態。可以喺github度下載dmg文件嚟用，只支援M系列芯片。

相關地址：

codex：

https://openai.com/zh-Hans-CN/codex/。

Superpowers：

https://github.com/obra/superpowers/。

7zip for mac命令行工具：

https://www.7-zip.org/download.html。

壓縮軟件：

https://github.com/fanfuhan/zipmac-codex/releases/tag/1.0.0。

反思：

由於呢個項目難度較細，我全程都喺一個會話入面完成，後期會話上下文一直係滿載狀態，未來有時間，需要學習實踐一下harness工程，點樣喺新會話入面，接住上一個結束嘅會話繼續工作。之前收藏咗一個harness資料，一直冇時間睇，推薦一下：https://walkinglabs.github.io/learn-harness-engineering/zh/ 。
冇及時將一啲約束寫到AGENTS.md入面，例如用中文寫文檔，一開始我喺會話入面同codex講完之後，佢記住咗，但隨住上下文不斷壓縮，佢已經唔記得咗。

這段時間一直在嘗試使用claude code、codex等AI編碼工具，很大一個感觸是，有了AI，可以迅速開發一些可用的小工具（幾乎不需要懂編程），為日常辦公提供便利。

因為平時會用到分卷壓縮的功能，而針對mac系統的很多壓縮軟件想要支持分卷壓縮都需要付費，所以就想使用AI編程工具開發一個簡易版壓縮軟件，支持平時簡單使用。

本項目其實在此之前使用 claude code + glm5.1 的組合已經開發過一次，使用體驗很棒，但沒有進行記錄，這次換個組合，選擇 codex + gpt5.5 進行本次開發，同時安裝 Superpowers 插件，用來提高開發質量。Superpowers 是一套完整的軟件開發方法論，它強制AI編程工具使用固定的開發流程，對最後的軟件效果提升明顯。基本工作流程如下：

1.頭腦風暴——在編寫代碼之前啓動。通過提問完善初步想法，探索各種方案，分段展示設計以供驗證。保存設計文檔。

2.using-git-worktrees - 設計方案獲批後激活。在新分支上創建隔離的工作區，運行項目設置，驗證測試基線是否乾淨。

3.編寫計劃- 根據已批准的設計方案啓動。將工作分解成易於處理的小任務（每個任務耗時 2-5 分鐘）。每個任務都包含精確的文件路徑、完整的代碼和驗證步驟。

4.子代理驅動的開發或執行計劃- 根據計劃激活。為每個任務派遣新的子代理，並進行兩階段審查（先檢查規範符合性，再檢查代碼質量），或者分批執行，並設置人工檢查點。

5.測試驅動開發——在實現階段激活。強制執行紅綠重構流程：編寫失敗的測試，觀察其失敗，編寫最小代碼，觀察其通過，然後提交。刪除測試之前編寫的代碼。

6.請求代碼審查- 在任務間隙激活。根據計劃進行審查，並按嚴重程度報告問題。嚴重問題會阻礙進度。

7.完成開發分支- 當任務完成後激活。驗證測試，提供選項（合併/PR/保留/丟棄），清理工作樹。

7個工作流程在下面的演示中都會有完整展現。

本次壓縮軟件的開發會基於7zip for mac命令行工具實現，我的本意是，在這個命令行工具的基礎上，封裝mac原生界面，供日常使用。

最終軟件演示：

開發過程演示開始（不包含軟件的安裝）。

建一個空文件夾，名字是：zipmac-codex，下載7zip for mac命令行工具，放到該目錄下。使用vscode打開zipmac-codex文件夾，並在vscode中打開一個終端，輸入codex，模型使用gpt5.5，模型思考強度使用high。vscode只用來展示文檔和代碼，實際並不會上手操作，全部由AI完成。截圖如下：

在codex文本框中輸入提示詞：

當前目錄下有一個7zip文件夾，裏面提供了壓縮和解壓的基本命令行功能。我想基於此，開發一個mac桌面版的壓縮解壓軟件，支持基本壓縮，分卷壓縮，加密壓縮，支持解壓壓縮文件到指定目錄，壓縮格式至少支持zip、gzip、tar、tar.gz等，壓縮級別也需支持。請嚴格按照Superpowers插件的流程來開發該項目。

輸入提示詞後，按回車鍵，codex會開始工作，截圖如下：

上圖顯示codex開始按照 Superpowers流程開始推進。

1. 第一階段-頭腦風暴

這一階段最重要的是梳理核對需求，並輸出詳細設計文檔。讓我們繼續。

上圖中，codex提問是否使用視覺輔助，我選擇了同意，並讓他以後使用中文和我對話。使用視覺輔助進行需求澄清是非常有幫助的，codex會在需求階段使用html畫出界面佈局供確認，對界面有什麼不滿意，可以提出建議讓他改。

上圖中，codex在展示界面佈局之前，先對一些需要我確認的問題進行了諮詢，第一個問題我聽取了他的建議，後兩個問題我選了自己認為對的選擇。

上圖中，codex畫出了簡單界面佈局，主要是確認功能，大致樣式。在此之後，還依次讓我確認了架構與模塊邊界、數據流與邊界、錯誤處理機制、測試策略，由於我對swift語言完全不懂，基本都選擇了默認推薦的策略。其中測試策略分為單元測試、集成測試、人工驗收。

待確認後，codex開始寫設計文檔，最終文檔都會推送到github，就不完全粘貼了。

到此，第一階段結束。

2. 第二階段-git隔離工作區

codex使用git worktree創建了單獨的工作區，用於進行後續的開發。其實我之前完全沒用過worktree功能，趁着這次機會學習了一下。

3. 第三階段-編寫計劃

codex拆分了10個task，每個task下又拆分了多個step，不同task間的依賴關係也是有的。

4. 第四-七階段-執行計劃，測試驗證，代碼審查，合併分支

執行計劃階段，我選擇了子代理驅動執行，codex會給每個task分配3子代理，一個是負責執行計劃的子代理，一個是檢查是否滿足設計文檔的子代理，一個是負責代碼檢查的子代理。被分配到的子代理，會獲取到任務執行所需的所有上下文。當負責檢查的子代理發現問題後，會要求負責執行的子代理進行修復，修復完繼續檢查。codex會依次執行完所有task，耗時2個小時。

到此，codex完成了所有任務的開發，測試，審核。

接下來由我進行人工驗收。

問題1：界面混亂

codex開發完以後，我打開構件好的軟件，如上圖，界面很多模塊都被壓縮了，應該是UI的問題，這次我沒有在codex cli中讓他解決，而是在codex app中讓他解決，因為app中Computer Use功能，可以直接操作我的電腦，自動截圖進行驗證。

修復後的界面長下面這樣：

界面沒有任何問題了，接着我測試了基本的功能，壓縮、加密壓縮、分卷壓縮、解壓都沒有問題了。但仍有幾個需要優化的點。

問題2：壓縮和解壓模塊共用界面中間的空間

codex修復了共享隊列問題，我測試後沒問題了。

問題3：界面拖動限制

codex正常修復了這個缺陷，我測試後沒問題。

問題4：中間代壓縮文件區域只支持點擊上傳，不支持拖拽

codex評估後，拖拽功能容易實現，我確認後，最終成功添加該功能，測試後沒有問題。

到此，軟件開發完成，達到了可用狀態。可以在github上下載dmg文件進行使用，只支持M系列芯片。

相關地址：

codex：

https://openai.com/zh-Hans-CN/codex/。

Superpowers：

https://github.com/obra/superpowers/。

7zip for mac命令行工具：

https://www.7-zip.org/download.html。

壓縮軟件：

https://github.com/fanfuhan/zipmac-codex/releases/tag/1.0.0。

反思：

由於該項目難度較小，我全程都在一個會話中完成，後期會話上下文一直是滿載狀態，未來有時間，需要學習實踐一下harness工程，如何在新會話中，接着上一個結束的會話繼續工作。之前收藏了一個harness資料，一直沒時間看，推薦一下：https://walkinglabs.github.io/learn-harness-engineering/zh/ 。
沒有及時將一些約束寫到AGENTS.md中，比如用中文寫文檔，一開始我在會話中跟codex說完後，他記住了，但隨着上下文不斷壓縮，他已經忘記了。