<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:media="http://search.yahoo.com/mrss/"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Kenmingの鮮思維</title>
	<atom:link href="https://kenming.idv.tw/feed/" rel="self" type="application/rss+xml" />
	<link>https://kenming.idv.tw</link>
	<description>不用牽掛過去，不必擔心未來，踏實於現在，就與過去和未來同在！</description>
	<lastBuildDate>Sat, 31 Oct 2026 15:09:41 +0000</lastBuildDate>
	<language>zh-TW</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.0.8</generator>

<image>
	<url>https://kenming.idv.tw/wp-content/medias/cropped-favicon-32x32.png</url>
	<title>Kenmingの鮮思維</title>
	<link>https://kenming.idv.tw</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>使用 project-scaffold Skill 建立 AI Agent 協作開發的專案骨架</title>
		<link>https://kenming.idv.tw/project-scaffold-agent-skill/</link>
					<comments>https://kenming.idv.tw/project-scaffold-agent-skill/#respond</comments>
		
		<dc:creator><![CDATA[Wang Kenming]]></dc:creator>
		<pubDate>Sat, 31 Oct 2026 15:08:06 +0000</pubDate>
				<category><![CDATA[開發方法論與 AI 工作流]]></category>
		<category><![CDATA[軟體開發工具]]></category>
		<category><![CDATA[GitHub]]></category>
		<category><![CDATA[AI Agent]]></category>
		<category><![CDATA[Agent Skill]]></category>
		<category><![CDATA[AI 協作]]></category>
		<guid isPermaLink="false">https://kenming.idv.tw/?p=24222</guid>

					<description><![CDATA[<p>分享一個我在建立軟體專案時常用的目錄與文件結構範本，最近將它整理成一個 Agent Skill，名稱為 pro [&#8230;]</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/project-scaffold-agent-skill/">使用 project-scaffold Skill 建立 AI Agent 協作開發的專案骨架</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></description>
										<content:encoded><![CDATA[
<figure class="wp-block-image size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/project-scaffold-skill.webp" alt="project-scaffold-skill" style="width:620px"/></figure>



<p class="wp-block-paragraph">分享一個我在建立軟體專案時常用的目錄與文件結構範本，最近將它整理成一個 Agent Skill，名稱為 <strong>project-scaffold</strong>。</p>



<p class="wp-block-paragraph">這個 Skill 主要用於建立軟體專案的基礎骨架。</p>



<p class="wp-block-paragraph">使用者可以先預覽預設的專案結構樹，再透過自然語言調整需要新增、移除或更名的目錄與文件，確認後就能自動生成專案骨架。</p>



<p class="wp-block-paragraph">GitHub：<a href="https://github.com/kenming/project-scaffold-skill" target="_blank" rel="noreferrer noopener">project-scaffold-skill</a></p>



<p class="wp-block-paragraph">整個 Skill 採用 Agent Skills 開放規格，不綁定單一 AI 工具，可供 Codex、GitHub Copilot、Claude Code，以及其他相容的 Agent 使用。</p>



<h3 class="wp-block-heading">AI Agent 協作專案需要哪些基礎結構？</h3>



<p class="wp-block-paragraph">在 AI Agent 協作開發中，我認為專案的基礎骨架至少需要涵蓋兩個部分：</p>



<ol start="1" class="wp-block-list">
<li><strong>專案規範（Project Rules）</strong>：讓 Agent 理解專案的開發原則、技術規範與目錄組織方式。</li>



<li><strong>專案文件（Project Documents）</strong>：讓 Agent 能找到需求、架構、研究、工作記錄及交接資訊。</li>
</ol>



<p class="wp-block-paragraph">這兩個部分，也是 project-scaffold 預設專案結構的主要設計方向。</p>



<h3 class="wp-block-heading">一、專案規範（Project Rules）</h3>



<p class="wp-block-paragraph">目前多數 AI Coding Agent 已支援透過 Markdown 文件定義專案規範。</p>



<p class="wp-block-paragraph">例如 Codex、GitHub Copilot 可以使用 <code>AGENTS.md</code> 作為規範入口；Claude Code 則主要使用 <code>CLAUDE.md</code>。</p>



<p class="wp-block-paragraph">兩者都是 Markdown 格式，規範內容基本可以共用。</p>



<h4 class="wp-block-heading">主規範應維持簡潔</h4>



<p class="wp-block-paragraph">我的習慣是將主規範控制在約 100 行以內，並參考 Andrej Karpathy 所倡議的簡潔、務實原則，避免將過多細節全部塞進同一份文件。</p>



<p class="wp-block-paragraph">其他細部規範則依不同性質拆分，預設放在 <code>.agent-rules/</code> 目錄下。</p>



<p class="wp-block-paragraph">例如：</p>



<ul class="wp-block-list">
<li><code>tech-stack.md</code>：定義專案採用的技術堆疊、框架及相關開發規範。</li>



<li><code>project-structure.md</code>：定義專案目錄結構，以及各目錄的用途。</li>
</ul>



<p class="wp-block-paragraph">其他如工作追蹤、測試與驗證等規範，也可以視專案需要再增加。</p>



<h4 class="wp-block-heading">依需求載入細部規範</h4>



<p class="wp-block-paragraph">主規範只保留共通原則與細部規範文件的索引。</p>



<p class="wp-block-paragraph">當 Agent 執行特定任務時，再依據任務性質讀取對應文件，而不是每次都將所有規範載入 Context Window。</p>



<p class="wp-block-paragraph">這樣可以讓主要規範保持精簡，也比較容易維護不同類型的開發規則。</p>



<h3 class="wp-block-heading">二、專案文件（Project Documents）</h3>



<p class="wp-block-paragraph">另一個重要部分，是專案開發過程中的各類文件。</p>



<p class="wp-block-paragraph">我的習慣是將這些文件統一整理在 <code>docs/</code> 目錄下，再依照用途分類。</p>



<h4 class="wp-block-heading">主要文件分類</h4>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">docs/
├── requirements/
├── architecture/
├── research/
└── tracking/</code></pre>



<p class="wp-block-paragraph">各目錄的用途：</p>



<ul class="wp-block-list">
<li><code>requirements/</code>：需求規格與功能需求。</li>



<li><code>architecture/</code>：系統架構、設計決策與 ADR（Architecture Decision Record）。</li>



<li><code>research/</code>：技術研究與調研資料。</li>



<li><code>tracking/</code>：專案工作追蹤與開發記錄。</li>
</ul>



<h4 class="wp-block-heading">開發記錄與工作交接</h4>



<p class="wp-block-paragraph">其中 <code>tracking/</code> 還可以進一步細分：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">tracking/
├── devlog/
├── handoff/
└── backlog/</code></pre>



<ul class="wp-block-list">
<li><code>devlog/</code>：記錄開發過程、程式變更及驗證結果。</li>



<li><code>handoff/</code>：整理工作交接資訊，讓不同 Agent 或新的 Session 可以接續先前的工作。</li>



<li><code>backlog/</code>：管理待辦事項與後續工作規劃，可依需求選用。</li>
</ul>



<p class="wp-block-paragraph">這幾個目錄在 AI Agent 協作開發時尤其實用。</p>



<p class="wp-block-paragraph">例如，一個 Agent 完成部分功能後，可以將目前進度、修改內容及尚未處理的問題記錄在交接文件中，讓後續的 Agent 或新的 Session 有明確的接續依據。</p>



<p class="wp-block-paragraph">當然，這些目錄並不是強制規定，而是提供一個可以調整的起點。</p>



<p class="wp-block-paragraph">不同專案可以依實際規模與需求增減，不需要一開始就建立過於複雜的結構。</p>



<h3 class="wp-block-heading">三、為什麼要先整理專案規範與文件？</h3>



<p class="wp-block-paragraph">良好的專案組織，不只是為了讓目錄看起來整齊，更重要的是改善 AI Agent 的協作方式。</p>



<p class="wp-block-paragraph">透過明確的規範與文件分類，可以讓 Agent 更容易找到需要的上下文，減少不必要的 Token 消耗，也降低開發過程中偏離需求或設計方向的機會。</p>



<p class="wp-block-paragraph">尤其在以下情境中，這些文件更能發揮作用：</p>



<ul class="wp-block-list">
<li><strong>跨 Session 開發</strong>：新的對話或工作階段，可以透過既有文件了解目前進度。</li>



<li><strong>不同 Agent 協作</strong>：讓不同 Coding Agent 依據共同規範與交接資訊接續工作。</li>



<li><strong>長期專案維護</strong>：保留開發記錄與設計決策，避免重要資訊只存在於過去的對話紀錄中。</li>
</ul>



<p class="wp-block-paragraph">我認為關鍵在於：</p>



<p class="wp-block-paragraph"><strong>把專案的規範、需求、架構、研究、驗證與工作狀態，放在一個 Agent 找得到、讀得懂，也能持續追蹤與維護的位置。</strong></p>



<p class="wp-block-paragraph">這也是我將這套專案骨架整理成 project-scaffold Skill 的主要目的。</p>



<h3 class="wp-block-heading">project-scaffold：從專案範本到可調整的 Skill</h3>



<p class="wp-block-paragraph">與直接複製一份固定的專案模板相比，我希望透過 Agent Skill 的方式，讓使用者能先檢視整體結構，再使用自然語言調整目錄與文件。</p>



<p class="wp-block-paragraph">不論是新增、移除或重新命名，都可以在確認後再建立實際的專案骨架。</p>



<p class="wp-block-paragraph">讓專案規範與文件結構成為開發流程的一部分，而不是每次開始新專案時，都要重新整理一次。</p>



<p class="wp-block-paragraph">專案原始碼與使用說明：</p>



<p class="wp-block-paragraph"><strong>GitHub：</strong><a href="https://github.com/kenming/project-scaffold-skill" target="_blank" rel="noopener"><strong>kenming/project-scaffold-skill</strong></a></p>



<p class="wp-block-paragraph">如果使用上遇到問題，或有改進建議，也歡迎透過 GitHub Issue 交流。</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/project-scaffold-agent-skill/">使用 project-scaffold Skill 建立 AI Agent 協作開發的專案骨架</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></content:encoded>
					
					<wfw:commentRss>https://kenming.idv.tw/project-scaffold-agent-skill/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
		<media:content url="https://images.kenming.idv.tw/software/project-scaffold-skill.webp" medium="image"></media:content>
	</item>
		<item>
		<title>Uncle Bob 推出 ub-mode：讓 AI Coding Agent 遵循軟體工程紀律</title>
		<link>https://kenming.idv.tw/uncle-bob-ub-mode-agent-skill/</link>
					<comments>https://kenming.idv.tw/uncle-bob-ub-mode-agent-skill/#respond</comments>
		
		<dc:creator><![CDATA[Wang Kenming]]></dc:creator>
		<pubDate>Sat, 31 Oct 2026 08:01:14 +0000</pubDate>
				<category><![CDATA[開發方法論與 AI 工作流]]></category>
		<category><![CDATA[ub-mode]]></category>
		<category><![CDATA[Agent Skill]]></category>
		<category><![CDATA[Uncle Bob]]></category>
		<guid isPermaLink="false">https://kenming.idv.tw/?p=24210</guid>

					<description><![CDATA[<p>這位令人尊敬、幾乎把一輩子都奉獻給軟體業的 73 歲 Bob 大叔（Uncle Bob），到了 AI Agen [&#8230;]</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/uncle-bob-ub-mode-agent-skill/">Uncle Bob 推出 ub-mode：讓 AI Coding Agent 遵循軟體工程紀律</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></description>
										<content:encoded><![CDATA[
<figure class="wp-block-image size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/bob-ub-mode-skill.webp" alt="Codex 還是 Claude Code？多 Agent 協作工作流" style="width:620px"/></figure>



<p class="wp-block-paragraph">這位令人尊敬、幾乎把一輩子都奉獻給軟體業的 73 歲 Bob 大叔（Uncle Bob），到了 AI Agent 時代，依然走在軟體開發的前線！</p>



<p class="wp-block-paragraph">先前我曾介紹過他對 AI Agent 開發的觀點與策略：<a href="https://reurl.cc/4YV0aR" target="_blank" rel="noopener">Uncle Bob 對 AI Agent 開發的觀點</a></p>



<p class="wp-block-paragraph">而在前幾篇文章中，我也談過如何透過 Agent Skill，讓 AI Agent 遵循特定的開發方法與實務規範：<a href="https://reurl.cc/lnKx0l" target="_blank" rel="noopener">關於 Agent Skill 的應用與實踐</a></p>



<p class="wp-block-paragraph">最近，Bob 大叔親自發布了一個名為 <strong>ub-mode</strong> 的 Agent Skill，將軟體工程原則轉換成 AI Coding Agent 可以遵循的開發紀律。</p>



<p class="wp-block-paragraph">這個 Skill 值得關注的地方，不只是要求 Agent 寫出能正常運作的程式碼，而是進一步規範它應該如何思考、實作、驗證與維護程式碼。</p>



<h3 class="wp-block-heading">ub-mode 的三個核心階段</h3>



<p class="wp-block-paragraph">ub-mode 的設計核心，主要分為三個階段：</p>



<h4 class="wp-block-heading">1. First Make it Work：先讓功能正確運作</h4>



<p class="wp-block-paragraph">首先從需求與資料結構開始思考，確認問題與預期結果，再進行實作。</p>



<p class="wp-block-paragraph">這個階段強調：</p>



<ul class="wp-block-list">
<li><strong>TDD（測試驅動開發）</strong>：先建立失敗的測試，再以最小的修改讓測試通過。</li>



<li><strong>最小變更原則</strong>：優先採取能解決問題的簡單方案，避免不必要的複雜度。</li>



<li><strong>從根本重新思考設計</strong>：面對新需求，不只是直接將功能附加到既有程式碼，而是考慮原有設計是否需要調整。</li>



<li><strong>架構與邊界紀律</strong>：重視領域模型、資料驗證、型別約束與操作的冪等性（Idempotency）。</li>
</ul>



<p class="wp-block-paragraph">這些原則的目的，是避免 AI Agent 為了快速完成任務，而不斷堆疊程式碼或引入不必要的設計。</p>



<h4 class="wp-block-heading">2. Then Make it Right：再讓設計與程式碼品質達到要求</h4>



<p class="wp-block-paragraph">當功能可以正常運作後，接下來要關注的是程式碼的設計品質與可維護性。</p>



<p class="wp-block-paragraph">這個階段強調：</p>



<ul class="wp-block-list">
<li><strong>根因修復（Root Cause Fix）</strong>：找出真正造成問題的原因，而不是只加入額外的防護判斷來掩蓋問題。</li>



<li><strong>行為測試（Behavior Testing）</strong>：測試應該驗證外部可觀察的行為，而不只是內部實作細節。</li>



<li><strong>小步驗證與重構（Refactoring）</strong>：逐步改善程式碼結構，並確認既有行為沒有改變。</li>
</ul>



<p class="wp-block-paragraph">此外，Bob 大叔還搭配了幾個獨立的程式碼品質檢查工具：</p>



<ul class="wp-block-list">
<li><strong>Crapper</strong>：結合程式複雜度與測試覆蓋率，透過 CRAP 指標評估程式碼風險。</li>



<li><strong>Dryer</strong>：檢測結構性重複程式碼，協助降低重複實作。</li>



<li><strong>Mutator</strong>：使用變異測試（Mutation Testing），檢查測試案例是否真正具有發現錯誤的能力。</li>
</ul>



<p class="wp-block-paragraph">這些工具讓原本較為抽象的程式碼品質要求，可以進一步透過具體指標與測試結果來驗證。</p>



<h4 class="wp-block-heading">3. Practice：維持良好的工程實踐</h4>



<p class="wp-block-paragraph">除了功能實作與品質改善之外，ub-mode 也重視 AI Agent 在整個開發過程中的工作紀律。</p>



<p class="wp-block-paragraph">主要包括：</p>



<ul class="wp-block-list">
<li><strong>Keep a Log</strong>：記錄每次修改的內容與原因，讓開發過程可以追蹤。</li>



<li><strong>Guard the Context Window</strong>：管理 Agent 的 Context Window，避免主工作脈絡承載過多不必要的資訊。</li>



<li><strong>Worktree Cleanup</strong>：清理不再使用的工作目錄與資源，同時保護尚未提交的修改。</li>



<li><strong>Commit and Push</strong>：以小批次、可驗證的 Commit 保存開發成果，並清楚記錄修改原因與驗證方式。</li>
</ul>



<p class="wp-block-paragraph">這些實踐不只是要求 Agent 完成程式碼修改，也要求整個開發過程能夠被理解、追蹤與驗證。</p>



<h3 class="wp-block-heading">如何安裝與使用 ub-mode？</h3>



<p class="wp-block-paragraph">ub-mode 是一個 Agent Skill，可以安裝在支援相應 Skill 機制的 AI Coding Agent 環境中。</p>



<p class="wp-block-paragraph">使用 Skills CLI 安裝：</p>


<pre class="language-powershell no-line-numbers"><code class="language-powershell no-line-numbers">npx skills add https://github.com/unclebob/ub-mode --skill ub-mode</code></pre>



<p class="wp-block-paragraph">安裝後，可以在支援 Skill 指令的 Coding Agent 中調用：</p>


<pre class="language-powershell no-line-numbers"><code class="language-powershell no-line-numbers">/ub-mode</code></pre>



<p class="wp-block-paragraph">如此便能要求 Agent 在開發或修改程式碼時，依照 ub-mode 所定義的工程原則執行工作。</p>



<p class="wp-block-paragraph">另外，如果希望進一步落實程式碼品質檢查，還可以搭配 Crapper、Dryer、Mutator 等工具。</p>



<p class="wp-block-paragraph">需要注意的是，<strong>這些品質檢查工具並不包含在 ub-mode Skill 本身，必須另外安裝與配置</strong>。</p>



<p class="wp-block-paragraph">相關 GitHub 專案：</p>



<ul class="wp-block-list">
<li><a href="https://github.com/unclebob/ub-mode" target="_blank" rel="noopener">ub-mode</a></li>



<li><a href="https://github.com/unclebob/crapper" target="_blank" rel="noopener">Crapper</a></li>



<li><a href="https://github.com/unclebob/dryer" target="_blank" rel="noopener">Dryer</a></li>



<li><a href="https://github.com/unclebob/mutator" target="_blank" rel="noopener">Mutator</a></li>
</ul>



<h3 class="wp-block-heading">AI Agent 可以寫程式，但工程紀律仍需要由開發者定義</h3>



<p class="wp-block-paragraph">我覺得 ub-mode 最值得參考的地方，不只是 Clean Code 或 TDD，而是將軟體工程的設計原則與開發紀律，轉換成 AI Agent 可以反覆執行、並透過工具驗證的工作流程。</p>



<p class="wp-block-paragraph">這也呼應了我之前一直強調的觀點：</p>



<p class="wp-block-paragraph"><strong>AI Agent 可以負責程式實作，但開發方法、架構原則與品質標準，仍然需要由開發者來定義。</strong></p>



<p class="wp-block-paragraph">當 AI Coding Agent 越來越能夠自主完成開發任務時，開發者需要思考的，已經不只是如何讓 Agent 寫出程式碼，而是如何將適當的工程方法與品質要求，落實到 Agent 的開發工作流程中。</p>



<p class="wp-block-paragraph">ub-mode 提供了一個值得參考的實踐方向。</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>專案來源：</strong> <a href="https://github.com/unclebob/ub-mode" target="_blank" rel="noopener">Uncle Bob — ub-mode (GitHub)</a></p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/uncle-bob-ub-mode-agent-skill/">Uncle Bob 推出 ub-mode：讓 AI Coding Agent 遵循軟體工程紀律</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></content:encoded>
					
					<wfw:commentRss>https://kenming.idv.tw/uncle-bob-ub-mode-agent-skill/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
		<media:content url="https://images.kenming.idv.tw/software/bob-ub-mode-skill.webp" medium="image"></media:content>
	</item>
		<item>
		<title>Codex 還是 Claude Code？從額度焦慮到多 Agent 協作工作流</title>
		<link>https://kenming.idv.tw/codex-vs-claude-code-agent-workflow/</link>
					<comments>https://kenming.idv.tw/codex-vs-claude-code-agent-workflow/#respond</comments>
		
		<dc:creator><![CDATA[Wang Kenming]]></dc:creator>
		<pubDate>Sat, 31 Oct 2026 07:31:48 +0000</pubDate>
				<category><![CDATA[開發方法論與 AI 工作流]]></category>
		<category><![CDATA[ClaudeCode]]></category>
		<category><![CDATA[AIAgent]]></category>
		<category><![CDATA[Codex]]></category>
		<category><![CDATA[AgentWorkflow]]></category>
		<guid isPermaLink="false">https://kenming.idv.tw/?p=24199</guid>

					<description><![CDATA[<p>最近 Codex 的訂閱與額度機制，確實讓人傻眼與不滿 ～ 5小時額度、每週額度、Credits、Reset， [&#8230;]</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/codex-vs-claude-code-agent-workflow/">Codex 還是 Claude Code？從額度焦慮到多 Agent 協作工作流</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></description>
										<content:encoded><![CDATA[
<figure class="wp-block-image size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/codex-vs-claude-code-agent-workflow-cover.webp" alt="Codex 還是 Claude Code？多 Agent 協作工作流" style="width:620px"/></figure>



<p class="wp-block-paragraph">最近 Codex 的訂閱與額度機制，確實讓人傻眼與不滿 ～</p>



<p class="wp-block-paragraph">5小時額度、每週額度、Credits、Reset，再加上不同模型的消耗差異，整套規則一直在變。最近社群裡也不斷有人反映，同樣的工作量，額度消耗似乎比過去快得多。</p>



<p class="wp-block-paragraph">這樣的狀況，也讓不少人開始討論： 「是不是乾脆從 Codex 搬去 Claude Code？」</p>



<p class="wp-block-paragraph">但我倒覺得，現階段不一定需要急著「搬家」。 反而<strong>可以先把 Codex 與 Claude Code，當成兩套不同特性的工具來看。</strong></p>



<p class="wp-block-paragraph">我記得今年初 Claude Code 其實也鬧過一次類似的額度問題，前後大概亂了三、四週，到 2 月左右才慢慢穩定下來。 所以這次 Codex 額度的狀況，我自己會先觀察 OpenAI 接下來怎麼調整，而不是因為目前這一波變化，就直接全部搬走。</p>



<p class="wp-block-paragraph">比較務實的做法，反而是： 保留 Codex，同時也可以考慮訂個一、兩個月 Claude Pro，實際跑一段時間看看。 兩套都真正拿來做過專案一段時間後，再決定哪一套比較適合自己的工作流。</p>



<p class="wp-block-paragraph">而且現在 Codex 與 Claude Code，其實已經不全然是二選一了。 兩者完全可以協同工作。</p>



<p class="wp-block-paragraph">例如：<strong> Codex 負責分析、規劃與 Review，Claude Code 負責實際執行； 或者反過來，由 Claude Code 擔任 coordinator，再把部分工作 delegate 給 Codex。</strong> 這類 workflow 現在已經有不少公開實作。</p>



<p class="wp-block-paragraph">甚至 OpenAI 自己也已經提供 Claude Code 的 Codex plugin，可以直接從 Claude Code 裡呼叫 Codex 做 review、delegate 與 task transfer。</p>



<p class="wp-block-paragraph">所以我目前反而比較傾向： 不要急著選邊站，而是把不同 Agent 放到它最適合的位置。</p>



<p class="wp-block-paragraph">尤其現在各家模型、訂閱價格、額度限制、能力與工具整合，都還在快速變動。</p>



<p class="wp-block-paragraph">如果整套開發流程全依賴在單一 Agent 上，那麼服務商每改一次額度、模型或價格，你的工作方式就得跟著震盪一次。</p>



<p class="wp-block-paragraph">反過來，如果<strong>一開始建立的就是： Agent 可替換、角色可分工、流程不綁模型。</strong> 那 Codex 今天額度不足，就把部分 execution 移給 Claude Code；Claude Code 遇到需要另一個觀點時，也可以把 Review 丟給 Codex。</p>



<p class="wp-block-paragraph">真正值得建立的，不只是「我要用 Claude 還是 Codex，而是：</p>



<p class="wp-block-paragraph"><strong>「懂得如何組織與規範 AI 協作的開發流程，依不同工作的性質調度適合的模型，甚至讓 Codex、Claude 這類不同 Agent 能有效分工。最終目的，還是讓開發效率提升，同時降低開發成本。」 我覺得，這才是 Agent 開發工作流真正值得投入與建立的能力。</strong></p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/codex-vs-claude-code-agent-workflow/">Codex 還是 Claude Code？從額度焦慮到多 Agent 協作工作流</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></content:encoded>
					
					<wfw:commentRss>https://kenming.idv.tw/codex-vs-claude-code-agent-workflow/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
		<media:content url="https://images.kenming.idv.tw/software/codex-vs-claude-code-agent-workflow-cover.webp" medium="image"></media:content>
	</item>
		<item>
		<title>關於 Codex 與 ChatGPT 協作模式的實踐</title>
		<link>https://kenming.idv.tw/chatgpt-codex-collaboration-puppymart/</link>
					<comments>https://kenming.idv.tw/chatgpt-codex-collaboration-puppymart/#respond</comments>
		
		<dc:creator><![CDATA[Wang Kenming]]></dc:creator>
		<pubDate>Wed, 30 Sep 2026 12:40:25 +0000</pubDate>
				<category><![CDATA[開發方法論與 AI 工作流]]></category>
		<category><![CDATA[AIAgent]]></category>
		<category><![CDATA[Codex]]></category>
		<category><![CDATA[寵物購物系統]]></category>
		<category><![CDATA[architecture]]></category>
		<category><![CDATA[AI]]></category>
		<category><![CDATA[DDD]]></category>
		<category><![CDATA[ChatGPT]]></category>
		<guid isPermaLink="false">https://kenming.idv.tw/?p=24167</guid>

					<description><![CDATA[<p>經過三天的實踐，採用我在 FB 社團分享所提及的 ChatGPT + Codex 協作模式，完成了 Puppy [&#8230;]</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/chatgpt-codex-collaboration-puppymart/">關於 Codex 與 ChatGPT 協作模式的實踐</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">經過三天的實踐，採用我在<a href="https://www.facebook.com/groups/softthinking" target="_blank" rel="noreferrer noopener"> FB 社團</a>分享所提及的 ChatGPT + Codex 協作模式，完成了 PuppyMart 寵物購物系統第一版。</p>



<p class="wp-block-paragraph">整體分工是：</p>



<ul class="wp-block-list">
<li>ChatGPT（Sol 中級模式）負責文檔、規劃與 Review</li>



<li>Codex（Luna 極高模式）負責實作、測試與驗證</li>



<li>兩者再透過第三方 Bridge 橋接，使用的是 <code>codex-with-chatgpt</code> skill</li>
</ul>



<p class="wp-block-paragraph">最後完成的系統已涵蓋多個業務功能模組，包括訂購、庫存、出貨、付款 Mock、基本資料維護等。</p>



<p class="wp-block-paragraph"><br>整個過程使用 Plus 帳戶，5 Hrs 限制一次都沒有觸發，週額度總共也只用了約 30%！</p>



<p class="wp-block-paragraph"></p>



<p class="wp-block-paragraph">這次實踐更加證明了：<br><strong>「AI Agent 開發真正重要的，不只是模型有多強，而是怎麼有效規範它。」</strong><br></p>



<p class="wp-block-paragraph">我會先依據專案性質制定 Agent 行為規範，例如 <code>AGENTS.md</code> 與相關細部規範（技術堆疊、前端 UI、分層架構、測試，乃至資料庫設計等）；再定義專案文件結構，包括調研、需求、架構、追蹤與交接記錄；程式本身則先確立基本分層，例如前後端分離，以及後端採簡化 DDD 分層。</p>



<p class="wp-block-paragraph">接下來的工作流程大致是：</p>



<ul class="wp-block-list">
<li>我先把需要討論的議題交給 ChatGPT，由它整理成需求、架構或設計文件，再進一步轉成具體可執行的計畫與 Prompt，交給 Codex 照表實作。</li>



<li>Codex 在執行過程中同時負責測試與自我驗證，完成後回報執行成果，再交回 ChatGPT Review。</li>



<li>Review 通過後，再整理工作日誌；如果工作有切分階段，則建立 hand-off 交接記錄；最後才交由 Codex Commit 並 Push 到 GitHub Repository。</li>
</ul>



<p class="wp-block-paragraph"></p>



<p class="wp-block-paragraph">也就是：</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">ChatGPT 負責思考、規劃與審查，Codex 負責執行與驗證。</p>
</blockquote>



<p class="wp-block-paragraph"><br>不過，我並不會在專案一開始，就把所有目錄、規範與文件結構設計得非常龐大。<br>我的做法反而是先採用自己過去累積下來的「最小模板」，再視專案需要安裝必要的 Skill，例如前端開發、需求規格整理、UI 驗證等，通常不會超過 10 個。<br>之後再隨著開發進度，逐步調整目錄、規範與文件。</p>



<p class="wp-block-paragraph"><br>我認為這比一開始就建立一套規範龐雜、流程繁瑣，卻不一定符合實際需求的 AI 開發治理架構，要實際得多。</p>



<p class="wp-block-paragraph"><br>這次 PuppyMart 的開發方式，我採用的是「<strong>跨業務模組的水平切分</strong>」加上「<strong>技術層級的垂直切分</strong>」。</p>



<p class="wp-block-paragraph"></p>



<p class="wp-block-paragraph">技術層級主要分成：</p>



<ul class="wp-block-list">
<li>中間層 API</li>



<li>前端 UI（React）</li>



<li>後端邏輯與資料存取</li>
</ul>



<p class="wp-block-paragraph">每一層完成後（一次會執行多個功能模組的開發），先使用 Mock 做隔離，讓它可以獨立驗證與測試；等各層都穩定後，再進行全端整合。</p>



<p class="wp-block-paragraph"><br>最後則跑整合測試、接受度測試，再加上 UI 自動化操作驗證，確認完成一個 Release。<br></p>



<p class="wp-block-paragraph">這種方式確實不算快。</p>



<p class="wp-block-paragraph">但如果拿我過去帶領約 5 人以上團隊開發同等規模系統的經驗來比較，正常至少也會需要兩個月左右。<br></p>



<p class="wp-block-paragraph">現在是一個人，加上 AI Agent，在三天內完成第一個可運作版本。<br>當然，如果全部工作都直接丟進 Codex，使用高階模型一次一路跑到底，速度當然會更快。</p>



<p class="wp-block-paragraph">但我目前更重視的是：<br><strong>可控性，以及品質。（當然還有 AI 開發成本的考量）</strong></p>



<p class="wp-block-paragraph">例如整合測試完成後，我覺得 UI 風格還不夠理想，而且發現一些操作細節缺失，如商品頁面沒有提供購買數量選擇。<br>這時我只需要把問題交給 ChatGPT，請它分析並制定修正計畫，再交由 Codex 實作。</p>



<p class="wp-block-paragraph">ChatGPT 在規劃時還會明確指出：這次修改只屬於前端 UI 與互動機制，不需要變更後端 API，也不應牽動後端邏輯。</p>



<p class="wp-block-paragraph"><br>因此整個修改範圍非常清楚，實作與驗證也很快就能完成。</p>



<p class="wp-block-paragraph"></p>



<p class="wp-block-paragraph">這種「先界定影響範圍，再讓 Agent 動手」的方式，是我目前認為 AI 輔助開發非常重要的一環。</p>



<p class="wp-block-paragraph"><br>接下來，我打算再把 PuppyMart 修整得更完整一些，之後會放到 GitHub，包含完整程式碼與可執行環境。</p>



<p class="wp-block-paragraph"><br>後續也預計製作 C#、Java / Spring 版本，甚至延伸到微服務架構版本。</p>



<p class="wp-block-paragraph"></p>



<p class="wp-block-paragraph">至於 ChatGPT 與 Codex 到底要怎麼透過 Bridge 協作，包括：</p>



<ul class="wp-block-list">
<li>Bridge 如何安裝與設定</li>



<li>ChatGPT 與 Codex 如何分工</li>



<li>Agent 規範如何設計</li>



<li>專案文件與目錄如何安排</li>



<li>Skill 如何選擇與安裝</li>



<li>如何建立一套可以重複使用、持續擴充的 AI 開發專案模板</li>
</ul>



<p class="wp-block-paragraph">個人也已整理成一堂大約 3 小時的<a href="https://kenming.idv.tw/course/codex-chatgpt-collaboration-lecture/" target="_blank" rel="noreferrer noopener">實務經驗分享講座</a>，提供給苦於 Codex 開發額度一下就被耗光的使用者，以及希望更有效規範 AI Agent 開發流程的開發者，分享如何透過一套可控、可驗證的協作方式，大幅降低 AI Agent 開發成本，並提升整體開發品質的實務經驗。</p>



<p class="wp-block-paragraph"></p>



<p class="wp-block-paragraph">P.S. 首頁圖檔是我的小狗堡貝與玄鳳粉圓 😄</p>



<figure class="wp-block-video"><video controls src="https://images.kenming.idv.tw/software/puppymart-showcase-demo.mp4"></video></figure>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/chatgpt-codex-collaboration-puppymart/">關於 Codex 與 ChatGPT 協作模式的實踐</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></content:encoded>
					
					<wfw:commentRss>https://kenming.idv.tw/chatgpt-codex-collaboration-puppymart/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		<enclosure url="https://images.kenming.idv.tw/software/puppymart-showcase-demo.mp4" length="20284326" type="video/mp4" />

		<media:content url="https://images.kenming.idv.tw/software/puppymart-home-page.webp" medium="image"></media:content>
	</item>
		<item>
		<title>從 AI 協作思考到務實簡化的 DDD 架構設計</title>
		<link>https://kenming.idv.tw/ai-collaboration-pragmatic-simplified-ddd-design/</link>
					<comments>https://kenming.idv.tw/ai-collaboration-pragmatic-simplified-ddd-design/#respond</comments>
		
		<dc:creator><![CDATA[Wang Kenming]]></dc:creator>
		<pubDate>Wed, 30 Sep 2026 12:16:24 +0000</pubDate>
				<category><![CDATA[軟體架構]]></category>
		<category><![CDATA[DDD]]></category>
		<category><![CDATA[AICollaboration]]></category>
		<category><![CDATA[ApplicationLayer]]></category>
		<category><![CDATA[SimplifiedDDD]]></category>
		<category><![CDATA[architecture]]></category>
		<category><![CDATA[AI]]></category>
		<guid isPermaLink="false">https://kenming.idv.tw/?p=24162</guid>

					<description><![CDATA[<p>這兩日在開發某個系統專案時，和 AI 持續討論軟體架構與設計決策，其中有一段關於 DDD Applicatio [&#8230;]</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/ai-collaboration-pragmatic-simplified-ddd-design/">從 AI 協作思考到務實簡化的 DDD 架構設計</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></description>
										<content:encoded><![CDATA[
<figure class="wp-block-image size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/ai-collaboration-pragmatic-simplified-ddd-design.webp" alt="從 AI 協作思考到務實簡化的 DDD 架構設計" style="width:620px"/></figure>



<p class="wp-block-paragraph">這兩日在開發某個系統專案時，和 AI 持續討論軟體架構與設計決策，其中有一段關於 DDD Application Layer 的討論，我覺得特別有意思。</p>



<p class="wp-block-paragraph">這也讓我更明確感受到：<strong>真正有價值的 AI 協作，不只是取得答案，而是在反覆討論、質疑、修正與形成共識的過程中，讓彼此的思考更清楚，甚至成為一種共同成長的方式。</strong></p>



<p class="wp-block-paragraph">我們先討論 Application Service 的「顆粒度（Granularity）」。</p>



<p class="wp-block-paragraph">過去我的習慣比較偏向以 <strong>Use Case</strong>，也就是「<strong>使用者操作目的</strong>」來界定 Service 的顆粒度。</p>



<p class="wp-block-paragraph">但到了 AI 時代，我開始重新思考這個界線。</p>



<p class="wp-block-paragraph">原因是 AI Agent 能夠一次理解、處理與修改的程式範圍，比過去人工開發時更廣。原本為了讓開發者容易掌握，而切得較細的 Service Boundary，未必還需要維持同樣的顆粒度。</p>



<p class="wp-block-paragraph">因此我開始傾向把 Application Service 的範圍放大，改以「業務功能模組」作為一個 Service，例如：</p>



<p class="wp-block-paragraph"><code>OrderService</code>、<code>PaymentService</code>、<code>InventoryService</code>。</p>



<p class="wp-block-paragraph">AI 接受這個方向，但建議把「功能模組」改成更精確的 <strong>Business Capability（業務能力）</strong>。</p>



<p class="wp-block-paragraph">這個建議我很認同。</p>



<p class="wp-block-paragraph">因為「功能模組」其實很容易受到 UI、系統切分方式或開發組織影響；Business Capability 則更接近「這個系統究竟具備什麼業務能力」，邊界會清楚很多。</p>



<p class="wp-block-paragraph">於是我們形成了一個共識：</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">Application Service 可以用 Business Capability 作為主要邊界，而 Use Case 仍保留作為使用者操作目的與應用流程的設計單位。</p>
</blockquote>



<p class="wp-block-paragraph">接著又討論到另一個很典型的 DDD 問題：跨模組流程到底要怎麼處理？</p>



<p class="wp-block-paragraph">AI 一開始採取比較典型、嚴謹的分層思維，希望 Application Layer 主要負責<strong>流程協調（Orchestration）</strong>，商務規則則盡量交由 Domain 處理。</p>



<p class="wp-block-paragraph">我的看法則比較務實。</p>



<p class="wp-block-paragraph">如果是中小型的 單體應用架構（Monolithic）Application，沒有必要把內部模組設計成彼此高度隔離，甚至採 Microservices 那樣透過 API 才能合作。這樣雖然邊界漂亮，但設計、實作與交易控管的成本都會明顯提高。</p>



<p class="wp-block-paragraph">所以我的主張是：</p>



<p class="wp-block-paragraph"><strong>Application Service 可以負責控制邏輯，直接透過各 儲庫（Repository）存取所需資料，也可以先承擔簡單的 Business Logic。</strong></p>



<p class="wp-block-paragraph">例如某個跨業務能力的流程，需要同時處理訂單、付款與庫存資料時，所屬的 Application Service 可以直接協調對應的 Repository，不需要再透過多層 Service 彼此呼叫。</p>



<p class="wp-block-paragraph">AI 接受這個設計，但提出一個補充：</p>



<p class="wp-block-paragraph">按照較嚴謹的 DDD，Business Logic 最好還是放到 Domain Object。</p>



<p class="wp-block-paragraph">我的看法則是：<strong>不需要太早把設計職責切分得過細。</strong></p>



<p class="wp-block-paragraph">如果只是簡單的條件判斷，而且只在單一流程使用，先寫在 Service 裡完全可以接受。</p>



<p class="wp-block-paragraph">真正需要重構到 Domain 的時機，應該是：</p>



<p class="wp-block-paragraph">邏輯開始變複雜、有多個條件或 invariant；</p>



<p class="wp-block-paragraph">或同一段業務規則開始被多個 Service 共用；</p>



<p class="wp-block-paragraph">或這段邏輯本身已經形成一個明確的 Domain Concept。</p>



<p class="wp-block-paragraph">AI 最後也接受這個方向，而且反過來幫我補上了一套「什麼時候應該抽離 Domain Logic」的判斷規範。</p>



<p class="wp-block-paragraph">我覺得這種務實、簡化的 DDD 架構，特別適合中小型系統。</p>



<p class="wp-block-paragraph">它不像完整 DDD 那樣一開始就承擔較高的設計成本，但仍然保留清楚的分層、業務邊界與重構空間。</p>



<p class="wp-block-paragraph">也就是說，可以先兼顧開發效率；當系統複雜度提高時，又有足夠的結構可以逐步抽離 Domain Logic、調整 Service Boundary，而不必整套推翻重來。</p>



<p class="wp-block-paragraph">這整段討論，對我來說才是目前與 AI 協作最有價值的地方。</p>



<p class="wp-block-paragraph">不是：</p>



<p class="wp-block-paragraph">「AI，直接幫我把這個問題解決掉。」</p>



<p class="wp-block-paragraph">而是：</p>



<p class="wp-block-paragraph"><strong>我提出多年開發經驗形成的直覺，AI 用既有的架構原則挑戰它；我再根據實際系統規模提出取捨，最後雙方把模糊的經驗整理成更明確、可以落地的設計準則。</strong></p>



<p class="wp-block-paragraph">這種互動不只是提高開發效率。</p>



<p class="wp-block-paragraph">它其實也在迫使自己重新回答：</p>



<p class="wp-block-paragraph">「我以前一直這樣設計，但為什麼？」</p>



<p class="wp-block-paragraph">「這是原則，還是只是習慣？」</p>



<p class="wp-block-paragraph">「什麼情況下應該遵守？什麼情況下反而應該簡化？」</p>



<p class="wp-block-paragraph">我覺得這才是 AI 時代對資深開發者很有意思的一種學習方式。</p>



<p class="wp-block-paragraph">不是把思考交給 AI，而是利用 AI，把自己的思考磨得更清楚。</p>



<p class="wp-block-paragraph">我也把這次與 AI 討論後形成的 Application Layer Design 共識整理成一份文件作為範本：</p>



<p class="wp-block-paragraph">🔗 https://reurl.cc/mzpZb9</p>



<p class="wp-block-paragraph">這份文件不只是討論紀錄，而是把設計取捨整理成可以持續引用、檢視與調整的開發規範。</p>



<p class="wp-block-paragraph">對正在思考如何導入分層架構、Application Layer、Repository、Domain Logic Placement，或想採用較務實 Simplified DDD 的開發者來說，應該具有相當的參考價值。</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/ai-collaboration-pragmatic-simplified-ddd-design/">從 AI 協作思考到務實簡化的 DDD 架構設計</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></content:encoded>
					
					<wfw:commentRss>https://kenming.idv.tw/ai-collaboration-pragmatic-simplified-ddd-design/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
		<media:content url="https://images.kenming.idv.tw/software/ai-collaboration-pragmatic-simplified-ddd-design.webp" medium="image"></media:content>
	</item>
		<item>
		<title>Uncle Bob：我現在的策略，是不閱讀 AI Agent 寫出的任何程式碼</title>
		<link>https://kenming.idv.tw/uncle-bob-ai-agent-development-strategy/</link>
					<comments>https://kenming.idv.tw/uncle-bob-ai-agent-development-strategy/#respond</comments>
		
		<dc:creator><![CDATA[Wang Kenming]]></dc:creator>
		<pubDate>Tue, 25 Aug 2026 06:14:59 +0000</pubDate>
				<category><![CDATA[開發方法論與 AI 工作流]]></category>
		<category><![CDATA[AI]]></category>
		<category><![CDATA[AI 輔助開發]]></category>
		<category><![CDATA[Clean Architecture]]></category>
		<category><![CDATA[Clean Code]]></category>
		<category><![CDATA[Uncle Bob]]></category>
		<guid isPermaLink="false">https://kenming.idv.tw/uncle-bob-ai-agent-development-strategy/</guid>

					<description><![CDATA[<p>73 歲、從機器碼與 Assembler 時代一路寫過來的 Uncle Bob，現在的 AI Agent 開發 [&#8230;]</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/uncle-bob-ai-agent-development-strategy/">Uncle Bob：我現在的策略，是不閱讀 AI Agent 寫出的任何程式碼</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></description>
										<content:encoded><![CDATA[
<figure class="wp-block-image aligncenter size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/uncle-bob-ai-agent-development-strategy.webp" alt="封面圖：Uncle Bob：我現在的策略，是不閱讀 AI Agent 寫出的任何程式碼" style="width:620px"/></figure>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">73 歲、從機器碼與 Assembler 時代一路寫過來的 Uncle Bob，現在的 AI Agent 開發策略竟然是：</p>



<p class="wp-block-paragraph">“My current strategy is to not read any of the code written by my agents.”</p>



<p class="wp-block-paragraph">真正值得思考的，不是「還要不要自己寫 Code」，而是資深工程師多年累積的設計與工程經驗，如何轉換成 Agent 可以遵循與驗證的工作規範。</p>
</blockquote>



<p class="wp-block-paragraph">上個月底在 <a href="https://x.com/unclebobmartin/status/2080257779395154409?utm_source=chatgpt.com" target="_blank" data-type="link" data-id="https://x.com/unclebobmartin/status/2080257779395154409?utm_source=chatgpt.com" rel="noreferrer noopener">X</a> 上有這麼一篇討論：</p>



<p class="wp-block-paragraph">一位從 1983 年就開始寫程式的資深工程師 Ori Pomerantz 提到，他最近開始嘗試使用 Claude 協助開發，但心裡始終有個坎過不去：</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">如果最後這些程式碼要由自己負責，那麼自己是不是就應該理解每一段 Code？</p>
</blockquote>



<p class="wp-block-paragraph">所以即使使用 AI，他仍然不太放心讓 Agent 直接修改檔案。</p>



<p class="wp-block-paragraph">結果底下有一位軟體業界更 "老" 的前輩回了這麼一句：</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">“My current strategy is to not read any of the code written by my agents.”</p>
</blockquote>



<p class="wp-block-paragraph">意思就是：</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">「我目前的策略，是不閱讀 Agent 所寫的任何程式碼。」</p>
</blockquote>



<p class="wp-block-paragraph">完全沒想到，原來就是大大有名的 <strong>Bob 大叔，Uncle Bob</strong>，也就是 <strong>《Clean Code》</strong> 與 <strong>《Clean Architecture》</strong> 的作者。</p>



<p class="wp-block-paragraph">其中 《Clean Code》 我自己反覆讀過好幾遍，而且其中很多觀念都切實應用在我的開發實務裡。</p>



<p class="wp-block-paragraph">例如我自己會進一步落實成比較具體的開發規範：</p>



<ul class="wp-block-list">
<li>單一 Method 儘量控制在 20 行以內</li>



<li>Method 參數儘量不要超過 4 個</li>



<li>必然撰寫 單元測試（Unit Test）</li>



<li>命名必須具有完整而清楚的語意</li>
</ul>



<p class="wp-block-paragraph">有趣的是，進入 AI 輔助開發後，這些以前是要求「自己寫程式時要遵守」的原則，現在反而很適合直接轉換成 AI Agent 的開發規範。</p>



<p class="wp-block-paragraph">而 Bob 大叔真正想表達的，並非一般人所認為的那種「<strong>Vibe Coding</strong>」 —— 只求結果，而不太理會 Code 如何組織。</p>



<p class="wp-block-paragraph">剛好相反。</p>



<p class="wp-block-paragraph">他的做法是<strong>把開發者的角色，從親自撰寫、逐行閱讀實作（Implementation），往更高層次的 「約束（Constraint）」 與 「驗證（Verification）」 提昇</strong>，也更能體現軟體開發設計者（Designer）的角色。</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph"><br>（這點我深有同感，所以我把不親自寫程式，而專注於設計與組織軟體的開發人員，稱為「Vibe Coder」。）</p>
</blockquote>



<p class="wp-block-paragraph">例如：</p>



<ul class="wp-block-list">
<li>單元測試（Unit Tests）</li>



<li>驗收測試／Gherkin 規格（Acceptance Tests / Gherkin）</li>



<li>品質保證流程（QA Procedures）</li>



<li>測試覆蓋率（Test Coverage）</li>



<li>品質指標（Quality Metrics）</li>



<li>突變測試（Mutation Testing）</li>
</ul>



<p class="wp-block-paragraph">AI Agent 可以負責大量實作，但最後一定得通過這整套驗證機制。</p>



<p class="wp-block-paragraph">換句話說，不再是靠：</p>



<p class="wp-block-paragraph"><strong>「這份 Code 我每一行都看過，所以我相信它。」</strong></p>



<p class="wp-block-paragraph">而是改成：</p>



<p class="wp-block-paragraph"><strong>「這份實作已經通過我所定義的規格、測試與品質關卡，所以我可以相信它。」</strong></p>



<p class="wp-block-paragraph">我覺得這個轉變其實很值得資深軟體人員思考。</p>



<p class="wp-block-paragraph"><strong>Bob 大叔今年已經 73 歲了。</strong></p>



<p class="wp-block-paragraph">他老人家從 1960 年代就開始寫程式，早期甚至是從機器碼、PDP-8 Assembler，一路經歷 FORTRAN、COBOL、C、C++ 這些不同世代的語言走過來。</p>



<p class="wp-block-paragraph">這種真正從「上古時代」一路親手寫 Code 寫到今天的老人家，都已經開始思考如何從 Syntax 與 Implementation 抽離，把更多實作工作交給 AI Agent。</p>



<p class="wp-block-paragraph">那麼我輩中流，還有什麼理由拒絕呢？</p>



<p class="wp-block-paragraph">我自己這兩年也見識與聽聞過不少資深工程師，仍然非常相信自己那套「手板斧」功夫。</p>



<p class="wp-block-paragraph">凡事還是習慣親身下去「刻」程式碼。</p>



<p class="wp-block-paragraph">即使已經開始使用 AI，很多時候仍停留在：</p>



<p class="wp-block-paragraph">問問題 → 查資料 → 生成幾段 Code → 自己再接手寫</p>



<p class="wp-block-paragraph">這當然也算是 AI 輔助開發。</p>



<p class="wp-block-paragraph">但我現在越來越認為，真正值得學習的，並非是 「怎麼讓 AI 幫我多寫一點 Code」。</p>



<p class="wp-block-paragraph">而是：</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">如何把我們多年累積下來的軟體設計、架構（Architecture）、程式規約（Coding Convention）、測試（Testing）與團隊協作（Team Collaboration），轉換成 AI Agent 可以理解、遵循，而且可以被驗證的工作規範。</p>
</blockquote>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/uncle-bob-ai-agent-development-strategy/">Uncle Bob：我現在的策略，是不閱讀 AI Agent 寫出的任何程式碼</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></content:encoded>
					
					<wfw:commentRss>https://kenming.idv.tw/uncle-bob-ai-agent-development-strategy/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
		<media:content url="https://images.kenming.idv.tw/software/uncle-bob-ai-agent-development-strategy.webp" medium="image"></media:content>
	</item>
		<item>
		<title>AI Agent 如何協作 Playwright：從需求變更到可驗證的測試閉環</title>
		<link>https://kenming.idv.tw/ai-agent-playwright-testing-workflow/</link>
					<comments>https://kenming.idv.tw/ai-agent-playwright-testing-workflow/#respond</comments>
		
		<dc:creator><![CDATA[Wang Kenming]]></dc:creator>
		<pubDate>Thu, 20 Aug 2026 08:08:50 +0000</pubDate>
				<category><![CDATA[開發方法論與 AI 工作流]]></category>
		<category><![CDATA[UI 自動化測試]]></category>
		<category><![CDATA[AI Agent]]></category>
		<category><![CDATA[軟體測試]]></category>
		<category><![CDATA[AI]]></category>
		<category><![CDATA[Playwright]]></category>
		<category><![CDATA[E2E Testing]]></category>
		<guid isPermaLink="false">https://kenming.idv.tw/?p=24111</guid>

					<description><![CDATA[<p>UI 自動化測試 - 使用 Playwright x AI Agent 系列 #04 當 Playwright [&#8230;]</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/ai-agent-playwright-testing-workflow/">AI Agent 如何協作 Playwright：從需求變更到可驗證的測試閉環</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></description>
										<content:encoded><![CDATA[
<figure class="wp-block-image aligncenter size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/ui-automation-test/ai-agent-playwright-workflow-cover.webp" alt="封面圖：AI Agent 與 Playwright Test 協作" style="width:620px"/></figure>



<div style="height:24px" aria-hidden="true" class="wp-block-spacer"></div>



<p class="has-text-color has-link-color wp-elements-aadcf25f7fbc70172a3453caa1c80a8e wp-block-paragraph" style="color:#4f6b8a;font-size:16px"><strong><strong>UI 自動化測試 - 使用 Playwright x AI Agent</strong></strong> <strong>系列 #04</strong></p>



<div style="height:16px" aria-hidden="true" class="wp-block-spacer"></div>



<p class="wp-block-paragraph">當 Playwright 測試已能把固定的使用者操作流程整理成可重複執行的腳本後，下一個問題通常不是「還能再寫哪些 API」，而是：</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">當需求持續變更時，如何讓 AI Agent 協助擴展、修正與審查測試，同時避免測試品質隨著自動生成而下降？</p>
</blockquote>



<p class="wp-block-paragraph">AI Agent 確實可以快速產生 Playwright 測試，但若只給一句「幫我測試折扣功能」，Agent 仍必須自行猜測帳號、測試資料、操作流程、預期結果與失敗判準。最後很可能得到一支「可以跑」，卻無法確認是否真正驗證需求的測試。</p>



<p class="wp-block-paragraph">較可靠的方式，是把 Agent 放進一個有明確輸入與可驗證輸出的測試閉環：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">需求變更
→ 功能交付
→ Agent 補上或調整 Playwright 測試
→ 審查測試意圖、Locator 與 Assertion
→ 執行測試
→ 檢視錯誤訊息與 Evidence
→ 回饋 Agent 修正
→ 再次執行確認結果</code></pre>



<p class="wp-block-paragraph">這個流程的核心，不是讓 Agent 一次產生完整測試平台，而是讓它在<strong>規格、測試資料、測試結果與失敗證據（Evidence）</strong>的約束下工作。</p>



<figure class="wp-block-image aligncenter size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/ui-automation-test/agent-pw-feedback-loop-qa.webp" alt="圖：AI Agent 與 Playwright 測試回饋閉環" style="width:620px"/></figure>



<p class="has-text-align-center has-small-font-size wp-block-paragraph">圖：AI Agent 與 Playwright 測試回饋閉環</p>



<h2 class="wp-block-heading">AI Agent 可以協助測試，但不能取代測試判斷</h2>



<p class="wp-block-paragraph">在 UI 自動化測試流程中，Agent 可以扮演多種角色：</p>



<ul class="wp-block-list">
<li>將需求規格整理成可執行的測試需求。</li>



<li>拆分主流程 Smoke Test 與功能分支測試。</li>



<li>產生 Playwright Test、測試資料與 helper function。</li>



<li>根據失敗訊息、Screenshot、Trace 或 Report 修正腳本。</li>



<li>審查 Locator、Assertion、測試資料與測試意圖。</li>
</ul>



<p class="wp-block-paragraph">問題在於，Agent 的「完成」不等於測試真的正確。</p>



<p class="wp-block-paragraph">例如測試失敗時，最容易出現的錯誤修正方式包括：</p>



<ul class="wp-block-list">
<li>刪除失敗的 expect</li>



<li>把精確金額驗證改成只檢查「NT$」</li>



<li>把指定商品改成任意商品</li>



<li>增加 waitForTimeout()</li>



<li>改用脆弱 CSS selector 讓 locator 暫時找得到</li>



<li>直接移除失敗的測試情境</li>
</ul>



<p class="wp-block-paragraph">這些做法可能讓測試由紅轉綠，但測試本身已經失去原本的驗證意圖。</p>



<p class="wp-block-paragraph">因此，Agent 需要有明確使用邊界：</p>



<ul class="wp-block-list">
<li>不得自行補完規格未定義的業務規則。</li>



<li>不得為了讓測試通過而弱化 Assertion。</li>



<li>不應只依程式碼推測 UI 狀態。</li>



<li>畫面與規格不一致時，先回報差異，而不是修改測試來迎合現況。</li>



<li>若缺少穩定 Locator，應提出可測試性補強，而不是直接改用脆弱 DOM 路徑。</li>
</ul>



<p class="wp-block-paragraph">Playwright 官方文件本身也強調以 Locator、auto-waiting、web-first assertions 與測試隔離建立可維護測試。Agent 協作沒有改變這些基本原則，只是讓它們更需要被明確寫進工作規範。</p>



<h2 class="wp-block-heading">不要只給 Agent 一句「幫我測試這個功能」</h2>



<p class="wp-block-paragraph">假設一個既有的購物流程原本只有一般會員結帳，現在加入：</p>



<ul class="wp-block-list">
<li>VIP 會員自動折扣</li>



<li>有效優惠碼折抵</li>



<li>無效優惠碼錯誤訊息</li>



<li>VIP 與優惠碼互斥規則</li>
</ul>



<p class="wp-block-paragraph">如果只要求：</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">請幫我測試新的折扣功能。</p>
</blockquote>



<p class="wp-block-paragraph">Agent 仍不知道：</p>



<ul class="wp-block-list">
<li>哪個帳號是一般會員、哪個是 VIP。</li>



<li>商品單價與數量是多少。</li>



<li>有效與無效優惠碼分別是什麼。</li>



<li>VIP 與優惠碼同時使用時應如何處理。</li>



<li>要驗證折扣名稱、折扣金額，還是只驗證按鈕可點擊。</li>



<li>原本的 Smoke Test 是否應修改。</li>



<li>可不可以直接修改產品功能。</li>
</ul>



<p class="wp-block-paragraph">一個較可執行的測試需求，至少應明確包含：</p>



<ul class="wp-block-list">
<li>測試目標</li>



<li>規格來源</li>



<li>已交付功能範圍</li>



<li>測試帳號與資料</li>



<li>需要新增或調整的測試案例</li>



<li>主要 Assertion</li>



<li>Locator 原則</li>



<li>可修改與不可修改範圍</li>



<li>驗證指令</li>



<li>回報格式</li>
</ul>



<p class="wp-block-paragraph">以折扣案例來說，測試資料可以先整理為：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">一般會員：normalUser
VIP 會員：vipUser
商品單價：680
數量：2
有效優惠碼：PET100
無效優惠碼：INVALID</code></pre>



<p class="wp-block-paragraph">規則則明確寫成：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">VIP：商品小計 9 折
PET100：一般會員折抵 100 元
INVALID：不折扣並顯示錯誤訊息
VIP + PET100：維持 VIP 折扣，並提示不可同時使用</code></pre>



<p class="wp-block-paragraph">這樣 Agent 才是在「依規格產生測試」，而不是「看程式碼猜一套測試」。</p>



<h2 class="wp-block-heading">需求增加，不代表把所有情境塞進同一支 E2E 測試</h2>



<p class="wp-block-paragraph">原本的購物主流程可以是一條 Smoke Test：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">登入
→ 選擇商品
→ 加入購物車
→ 進入結帳
→ 確認金額
→ 送出訂單
→ 驗證訂單成立</code></pre>



<p class="wp-block-paragraph">加入折扣需求後，最直接但不理想的做法，是繼續往這支測試後面追加 VIP、優惠碼、無效優惠碼與互斥規則。</p>



<p class="wp-block-paragraph">結果通常會變成：</p>



<ul class="wp-block-list">
<li>測試越來越長。</li>



<li>多組帳號與資料互相干擾。</li>



<li>失敗時難以定位是哪個規則出問題。</li>



<li>Agent 修正其中一段時，容易影響其他段。</li>



<li>測試名稱已無法反映真正的驗證目的。</li>
</ul>



<p class="wp-block-paragraph">較合理的做法，是保留原本的主流程 Smoke Test，再新增獨立的功能分支：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">基準 Smoke Test
→ 一般會員可以完成基本購物與結帳
折扣分支
→ VIP 會員結帳時自動套用 VIP 折扣
→ 一般會員使用有效優惠碼後折抵 100 元
→ 一般會員使用無效優惠碼後顯示錯誤訊息且金額不變
→ VIP 會員輸入優惠碼時顯示互斥提示並維持 VIP 折扣</code></pre>



<figure class="wp-block-image aligncenter size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/ui-automation-test/discount-v2-test-branches.webp" alt="圖：需求變更後需拆解測試結構" style="aspect-ratio:1.7661459028797792;width:622px;height:auto"/></figure>



<p class="has-text-align-center has-small-font-size wp-block-paragraph">圖：需求變更後需拆解測試結構</p>



<p class="wp-block-paragraph">程式結構也可以直接反映這個分工：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">tests/
├─ smoke/
│  └─ checkout.spec.ts
└─ discount/
   ├─ vip_discount.spec.ts
   ├─ coupon_discount.spec.ts
   ├─ invalid_coupon.spec.ts
   └─ discount_exclusion.spec.ts</code></pre>



<p class="wp-block-paragraph">重點不是一定要拆成四個檔案，而是每個 Test Case 應有<strong>單一且可辨識的驗證目的</strong>。</p>



<h2 class="wp-block-heading">測試資料與預期值不要散落在腳本裡</h2>



<p class="wp-block-paragraph">需求簡單時，直接寫：</p>


<pre class="language-typescript no-line-numbers"><code class="language-typescript no-line-numbers">await expect(page.getByTestId(&#039;checkout-total&#039;))
  .toHaveText(&#039;NT$ 1224&#039;);</code></pre>



<p class="wp-block-paragraph">並沒有立即問題。</p>



<p class="wp-block-paragraph">但當測試開始包含不同會員身分、優惠碼與互斥規則，如果多支測試都散落：</p>


<pre class="language-typescript no-line-numbers"><code class="language-typescript no-line-numbers">NT$ 1360
NT$ 136
NT$ 1224
NT$ 1260</code></pre>



<p class="wp-block-paragraph">Agent 後續修改時，很容易只修到其中幾個數字。</p>



<p class="wp-block-paragraph">較好的方式，是將測試資料與簡單預期值計算集中管理：</p>


<pre class="language-typescript no-line-numbers"><code class="language-typescript no-line-numbers">export const users = {
  normal: {
    username: &#039;user1&#039;,
    password: &#039;user1&#039;,
  },
  vip: {
    username: &#039;user2&#039;,
    password: &#039;user2&#039;,
  },
} as const;
export const product = {
  unitPrice: 680,
  quantity: 2,
} as const;
export const coupons = {
  valid: &#039;PET100&#039;,
  invalid: &#039;INVALID&#039;,
} as const;</code></pre>



<p class="wp-block-paragraph">再用一個保持簡單的 helper 推導預期結果：</p>


<pre class="language-typescript no-line-numbers"><code class="language-typescript no-line-numbers">type MemberType = &#039;normal&#039; | &#039;vip&#039;;
export function calculateExpectedAmount(
  unitPrice: number,
  quantity: number,
  memberType: MemberType,
  couponCode?: string,
) {
  const subtotal = unitPrice * quantity;
  const vipDiscount =
    memberType === &#039;vip&#039;
      ? Math.round(subtotal * 0.1)
      : 0;
  const couponDiscount =
    memberType === &#039;normal&#039; &amp;&amp; couponCode === &#039;PET100&#039;
      ? 100
      : 0;
  return {
    subtotal,
    vipDiscount,
    couponDiscount,
    total: subtotal - vipDiscount - couponDiscount,
  };
}</code></pre>



<p class="wp-block-paragraph">這裡有一個重要限制：<strong>測試 helper 不應完整複製產品端的商業邏輯。</strong></p>



<p class="wp-block-paragraph">如果產品與測試使用完全相同的折扣實作，產品邏輯寫錯時，兩邊可能一起算出相同的錯誤結果。helper 的用途只是讓測試預期值有單一、可讀、可核對的來源，而不是再做一套產品規則引擎。</p>



<h2 class="wp-block-heading">Agent 產生測試後，還需要審查 Locator 與 Assertion</h2>



<p class="wp-block-paragraph">Agent 很擅長快速產生「能定位到元素」的 selector，但能找到元素，不代表是好的 Locator。</p>



<p class="wp-block-paragraph">Playwright 官方建議優先使用具使用者語意、可重試且較穩定的定位方式。實務上可依下列方向檢查：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">getByRole
→ getByLabel
→ getByText
→ getByTestId
→ 穩定屬性 selector
→ 結構型 CSS / XPath 作為最後手段</code></pre>



<p class="wp-block-paragraph">例如：</p>


<pre class="language-typescript no-line-numbers"><code class="language-typescript no-line-numbers">await page.getByRole(&#039;button&#039;, { name: &#039;套用優惠碼&#039; }).click();
await expect(
  page.getByTestId(&#039;coupon-discount-amount&#039;)
).toHaveText(&#039;NT$ 100&#039;);</code></pre>



<p class="wp-block-paragraph">不建議 Agent 為了快速通過，改成：</p>


<pre class="language-typescript no-line-numbers"><code class="language-typescript no-line-numbers">await page.locator(
  &#039;#app &gt; main &gt; div:nth-child(3) &gt; button&#039;
).click();</code></pre>



<p class="wp-block-paragraph">同樣地，Assertion 也不能只驗證「操作有執行」。</p>



<p class="wp-block-paragraph">折扣測試至少應視情境驗證：</p>



<ul class="wp-block-list">
<li>商品小計。</li>



<li>折扣名稱。</li>



<li>折扣金額。</li>



<li>訂單總金額。</li>



<li>成功或錯誤訊息。</li>



<li>VIP / 優惠碼互斥提示。</li>



<li>最終訂單成立頁的金額。</li>
</ul>



<p class="wp-block-paragraph">例如有效優惠碼案例，不應只寫：</p>


<pre class="language-typescript no-line-numbers"><code class="language-typescript no-line-numbers">await expect(page.getByText(&#039;PET100&#039;)).toBeVisible();</code></pre>



<p class="wp-block-paragraph">更有意義的是：</p>


<pre class="language-typescript no-line-numbers"><code class="language-typescript no-line-numbers">await expect(page.getByTestId(&#039;coupon-name&#039;))
  .toHaveText(&#039;PET100&#039;);
await expect(page.getByTestId(&#039;coupon-discount-amount&#039;))
  .toHaveText(&#039;NT$ 100&#039;);
await expect(page.getByTestId(&#039;checkout-total&#039;))
  .toHaveText(&#039;NT$ 1260&#039;);</code></pre>



<p class="wp-block-paragraph">這樣測試才是在驗證「折扣規則」，而不是只驗證畫面上曾經出現某段文字。</p>



<h2 class="wp-block-heading">測試失敗後，不要立刻叫 Agent 改程式碼</h2>



<p class="wp-block-paragraph">當 Playwright Test 失敗時，真正有價值的是失敗 Evidence。</p>



<p class="wp-block-paragraph">常見 Evidence 包括：</p>



<ul class="wp-block-list">
<li>終端機錯誤訊息</li>



<li>Screenshot</li>



<li>Trace</li>



<li>Video</li>



<li>HTML Report</li>
</ul>



<p class="wp-block-paragraph">比較可靠的流程是：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">測試失敗
→ 讀取失敗測試與行號
→ 判斷是 action、locator 還是 assertion
→ 檢查 Screenshot / Trace / Report
→ 比對預期與實際 UI
→ 分類問題來源
→ 再決定修正測試或回報產品缺陷</code></pre>



<figure class="wp-block-image aligncenter size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/ui-automation-test/pw-failure-evidence-to-agent.webp" alt="圖：需求變更後需拆解測試結構" style="aspect-ratio:1.7661459028797792;width:622px;height:auto"/></figure>



<p class="has-text-align-center has-small-font-size wp-block-paragraph">圖：測試失敗證據轉成 Agent 失敗摘要</p>



<p class="wp-block-paragraph">例如：</p>


<pre class="language-typescript no-line-numbers"><code class="language-typescript no-line-numbers">Expected: NT$ 1260
Received: NT$ 1360</code></pre>



<p class="wp-block-paragraph">不能立即推論「產品折扣功能壞了」。</p>



<p class="wp-block-paragraph">仍需確認：</p>



<ul class="wp-block-list">
<li>PET100 是否真的已成功套用。</li>



<li>畫面是否顯示優惠碼成功訊息。</li>



<li>測試是否取得正確的總金額欄位。</li>



<li>測試資料是否殘留前一次狀態。</li>



<li>規格中的預期值是否被測試 helper 算錯。</li>
</ul>



<p class="wp-block-paragraph">Agent 比較適合接收的，不是「測試失敗，請修」，而是已整理的診斷輸入：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">失敗測試：
一般會員輸入 PET100 後應折抵 100 元
失敗步驟：
checkout-total Assertion
預期：
NT$ 1260
實際：
NT$ 1360
Evidence：
- 畫面顯示優惠碼 PET100 已套用
- coupon-discount-amount 顯示 NT$ 0
- Trace 顯示套用按鈕已成功點擊
請判斷：
1. 較可能是產品功能、測試腳本或測試資料問題。
2. 是否應修改測試。
3. 若需修改測試，不得降低原有 Assertion。</code></pre>



<p class="wp-block-paragraph">這樣 Agent 才是在做「根據 Evidence 的診斷」，而不是猜測。</p>



<h2 class="wp-block-heading">讓 Agent 修正測試時，明確禁止「弱化驗證」</h2>



<p class="wp-block-paragraph">當 Agent 收到失敗測試後，可以直接加入一些負面限制：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">不得：
- 刪除折扣相關 Assertion
- 將精確金額改成模糊文字比對
- 移除 VIP、有效優惠碼、無效優惠碼或互斥測試
- 使用 waitForTimeout() 掩蓋同步問題
- 使用脆弱 CSS selector / XPath 取代穩定 Locator
- 修改產品功能來配合測試</code></pre>



<p class="wp-block-paragraph">並要求修正完成後重新執行：</p>


<pre class="language-powershell no-line-numbers"><code class="language-powershell no-line-numbers">npx playwright test tests/discount \
  --project=chromium \
  --workers=1</code></pre>



<p class="wp-block-paragraph">最後回報：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">修改了哪些測試
實際執行的指令
哪些測試通過
哪些仍失敗
是否有新的失敗
使用了哪些 Evidence
是否需要回報產品功能差異</code></pre>



<p class="wp-block-paragraph">Agent 回覆「已修正」沒有驗證價值；重新執行後的測試結果才有。</p>



<h2 class="wp-block-heading">長提示詞不是終點：把固定流程移到 AGENTS.md 與專案規範</h2>



<p class="wp-block-paragraph">如果每次要求 Agent 產生或修正 Playwright 測試，都要重新貼上：</p>



<ul class="wp-block-list">
<li>Locator 原則</li>



<li>Assertion 原則</li>



<li>測試資料規則</li>



<li>禁止修改範圍</li>



<li>失敗 Evidence 格式</li>



<li>重新驗證方式</li>



<li>回報格式</li>
</ul>



<p class="wp-block-paragraph">代表這些內容已經不是「這次任務的提示詞」，而是<strong>專案固定工作規範</strong>。</p>



<p class="wp-block-paragraph">此時可以將規範拆出：</p>


<pre class="language-text no-line-numbers"><code class="language-text no-line-numbers">project/
├─ AGENTS.md
└─ .agent-rules/
   ├─ project-structure.md
   ├─ tech-stack.md
   └─ playwright-qa-workflow.md</code></pre>



<p class="wp-block-paragraph">其中 <code>playwright-qa-workflow.md</code> 可以固定記錄：</p>



<ul class="wp-block-list">
<li>測試任務必讀哪些規格</li>



<li>Agent 可修改與不可修改的目錄</li>



<li>Smoke Test 與分支測試拆分原則</li>



<li>Locator 優先順序</li>



<li>Assertion 最低要求</li>



<li>測試資料與 helper 管理方式</li>



<li>測試執行指令</li>



<li>Evidence 回報格式</li>



<li>禁止弱化驗證的規則</li>
</ul>



<p class="wp-block-paragraph"><code>AGENTS.md</code> 則只需要成為入口索引：</p>


<pre class="language-markdown no-line-numbers"><code class="language-markdown no-line-numbers">## 分離規範
- 專案目錄結構：`.agent-rules/project-structure.md`
- 技術堆疊與實作邊界：`.agent-rules/tech-stack.md`
- Playwright QA 工作流程：`.agent-rules/playwright-qa-workflow.md`
涉及 Playwright 測試生成、修正、審查、
執行或失敗分析時，必須讀取
`.agent-rules/playwright-qa-workflow.md`。</code></pre>



<p class="wp-block-paragraph">之後單次提示詞便可以縮短成：</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">請依 AGENTS.md 與 Playwright QA 規範，
根據指定規格補上折扣測試。

先提出測試設計，不要直接修改檔案。</p>
</blockquote>



<p class="wp-block-paragraph">固定規則由專案文件承載，提示詞只描述這次任務的差異。</p>



<figure class="wp-block-image aligncenter size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/ui-automation-test/discount-v2-agent-workflow.webp" alt="圖：從提示詞操作到專案規範" style="aspect-ratio:1.7661459028797792;width:622px;height:auto"/></figure>



<p class="has-text-align-center has-small-font-size wp-block-paragraph">圖：從提示詞操作到專案規範</p>



<h2 class="wp-block-heading">從「AI 幫忙寫測試」走向「可驗證的 Agent 測試流程」</h2>



<p class="wp-block-paragraph">AI Agent 最容易展現價值的地方，是加速重複且結構化的工作，包括測試案例擴展、腳本生成、Locator 整理、Assertion 審查與失敗摘要。</p>



<p class="wp-block-paragraph">但要讓這些能力真正進入開發流程，需要先建立幾個基本約束：</p>



<ul class="wp-block-list">
<li>規格先於生成</li>



<li>測試資料先於猜測</li>



<li>Evidence 先於修正</li>



<li>驗證結果先於「已完成」</li>



<li>專案規範先於超長提示詞</li>
</ul>



<p class="wp-block-paragraph">Playwright 在這裡不只是瀏覽器自動化工具。</p>



<p class="wp-block-paragraph">當測試案例具備明確意圖、穩定 Locator、具體 Assertion、可觀察 Evidence 與可重複執行的驗證流程後，它就能成為 Agent 任務的可執行驗收條件。</p>



<p class="wp-block-paragraph">而 AI Agent 的價值，也不再只是「幫忙產生測試程式碼」，而是參與：</p>


<pre class="language-test no-line-numbers"><code class="language-test no-line-numbers">需求理解
→ 測試設計
→ 測試實作
→ 執行驗證
→ Evidence 診斷
→ 修正
→ 再驗證</code></pre>



<p class="wp-block-paragraph">這才是 AI Agent 與 Playwright 協作真正值得標準化的部分！</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/ai-agent-playwright-testing-workflow/">AI Agent 如何協作 Playwright：從需求變更到可驗證的測試閉環</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></content:encoded>
					
					<wfw:commentRss>https://kenming.idv.tw/ai-agent-playwright-testing-workflow/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
		<media:content url="https://images.kenming.idv.tw/software/ui-automation-test/ai-agent-playwright-workflow-cover.webp" medium="image"></media:content>
	</item>
		<item>
		<title>為 Bricks Builder 打造一個開發輔助 Skill</title>
		<link>https://kenming.idv.tw/bricks-builder-development-skill/</link>
					<comments>https://kenming.idv.tw/bricks-builder-development-skill/#respond</comments>
		
		<dc:creator><![CDATA[Wang Kenming]]></dc:creator>
		<pubDate>Tue, 11 Aug 2026 00:35:59 +0000</pubDate>
				<category><![CDATA[軟體開發工具]]></category>
		<category><![CDATA[wordpress]]></category>
		<category><![CDATA[AI]]></category>
		<category><![CDATA[AI Agent]]></category>
		<category><![CDATA[Bricks Builder]]></category>
		<category><![CDATA[Agent Skill]]></category>
		<guid isPermaLink="false">https://kenming.idv.tw/?p=24099</guid>

					<description><![CDATA[<p>去年重新整理自己的 WordPress Blog 時，我最後選擇使用 Bricks Builder 作為網站主 [&#8230;]</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/bricks-builder-development-skill/">為 Bricks Builder 打造一個開發輔助 Skill</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></description>
										<content:encoded><![CDATA[
<figure class="wp-block-image aligncenter size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/bricks-builder/bricks-builder-skill-cover.webp" alt="封面圖：發布 Bricks Builder 開發輔助 Skill" style="width:620px"/></figure>



<p class="wp-block-paragraph">去年重新整理自己的 WordPress Blog 時，我最後選擇使用 Bricks Builder 作為網站主要的 Theme 與頁面建置工具。</p>



<p class="wp-block-paragraph">當時選擇 Bricks Builder，一個很重要的原因是它不只是一套視覺化 Page Builder，本身也保留了相當大的開發彈性。對熟悉 CSS、PHP 與 WordPress 開發的人來說，可以在視覺化建置與客製程式之間取得不錯的平衡。</p>



<p class="wp-block-paragraph">關於當時為什麼選擇 Bricks Builder，我曾另外整理過一篇文章：</p>



<p class="wp-block-paragraph"><a href="https://kenming.idv.tw/2025_site_rebuild_using_bricksbuilder/">2025 年網站重新建置：使用 Bricks Builder</a></p>



<h3 class="wp-block-heading">最初只是想讓 AI 比較容易查 Bricks 文件</h3>



<p class="wp-block-paragraph">隨著使用 Bricks Builder 的程度越來越深入，我開始頻繁查閱 Bricks Academy（官方文檔）。</p>



<p class="wp-block-paragraph">Bricks 官方其實提供了不少文件，包括 Builder 功能、Dynamic Data、Query Loop、Components、Hooks、Filters、Custom Elements 與各種 Developer API。不過實際使用下來，我一直覺得官方文件的分類與查詢並不是那麼方便，尤其當要找的是某個比較細節的開發資訊時，常常得花一些時間才能找到真正相關的文件。</p>



<p class="wp-block-paragraph">如果改成讓 AI Agent 自己到 Bricks Academy 搜尋，同樣會遇到類似問題：搜尋、開啟不同頁面、判斷哪些文件真正相關，不但效率不高，也會消耗不少 Context Token。</p>



<p class="wp-block-paragraph">所以我一開始做這個 Skill 的目的其實很單純：</p>



<p class="wp-block-paragraph"><strong>把 Bricks Academy 官方文件預先下載並轉換成 Markdown，建立一套可以讓 AI Agent 在本機直接搜尋的文件庫。</strong></p>



<p class="wp-block-paragraph">目前這套文件庫已同步超過 700 篇 Bricks Academy 文件以及相關圖片，Agent 可以先從本機 corpus 搜尋真正需要的內容，而不需要每次都重新到官方網站尋找。</p>



<p class="wp-block-paragraph">同時我也做了文件同步機制，可以檢查 Bricks Academy 是否有新的或異動的文件，需要時再重新下載、轉換與建立索引。因此它並不是建立一次之後就不再更新的靜態知識庫，而是可以持續與官方文件保持同步。</p>



<h3 class="wp-block-heading">從文件查詢逐漸擴展成開發輔助 Skill</h3>



<p class="wp-block-paragraph">實際使用一段時間後，我發現單純「找得到文件」仍然不完全足以協助 Bricks Builder 開發。</p>



<p class="wp-block-paragraph">例如處理 Bricks element tree、page JSON、responsive settings、global classes、Dynamic Data、Query Loop 或 Custom Elements 時，除了官方文件之外，Agent 還需要知道一些基本的資料模型、修改原則與驗證流程。</p>



<p class="wp-block-paragraph">因此後來又逐步加入了一些精簡的 development references，讓 Skill 除了負責文件查詢之外，也可以提供 Bricks Builder 開發時需要的工作流程與約束。</p>



<p class="wp-block-paragraph">目前這個 Skill 大致涵蓋：</p>



<ul class="wp-block-list">
<li>本機搜尋 Bricks Academy 官方文件。</li>



<li>Bricks element tree 與資料結構的基本模型。</li>



<li>Page / Element JSON 的建立與修改流程。</li>



<li>Custom Elements 開發。</li>



<li>Responsive settings、Theme Styles、Global Classes、Variables 與 Components。</li>



<li>Dynamic Data、Hooks、Query Loop 與 Forms。</li>



<li>修改後在 Builder 與 Frontend 的驗證流程。</li>
</ul>



<p class="wp-block-paragraph">另外有些 Bricks 的實作細節會隨版本改變，例如 control keys、hook signatures、JSON shapes 或內部資料結構。因此這個 Skill 也不會單純依賴既有文件或模型記憶，在有實際 Bricks 開發環境可以查驗時，會以目前安裝版本作為最後的驗證依據。</p>



<p class="wp-block-paragraph">換句話說，我希望它扮演的角色不是一套「什麼都知道的 Bricks 知識庫」，而是一個知道<strong>去哪裡找資料、如何進行開發，以及什麼資訊需要進一步查證</strong>的輕量開發輔助 Skill。</p>



<h3 class="wp-block-heading">Bricks Builder Skill</h3>



<p class="wp-block-paragraph">目前我已將這個 Skill 整理後放到 GitHub 公開：</p>



<p class="wp-block-paragraph"><strong>GitHub：</strong><br><a href="https://github.com/kenming/bricks-builder-skill" target="_blank" rel="noreferrer noopener">https://github.com/kenming/bricks-builder-skill</a></p>



<p class="wp-block-paragraph">如果平常也使用 AI Agent 協助 Bricks Builder 網站開發，可以自行下載使用。</p>



<p class="wp-block-paragraph">Repository 的 README 已整理目前支援的能力、安裝方式、Skill 觸發方式、文件同步工具，以及版本查驗與授權邊界等相關說明。</p>



<p class="wp-block-paragraph">這個專案目前主要還是配合我自己的 Bricks Builder 網站開發持續使用與調整；後續只要 Bricks Academy 文件或實際開發需求有所變化，也會持續更新。</p>



<h3 class="wp-block-heading">Screenshots</h3>



<figure class="wp-block-image aligncenter size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/bricks-builder/evidence-workflow.webp" alt="Workflow：How the Bricks Builder Skill Builds an Answer" style="width:620px"/></figure>



<p class="has-text-align-center has-small-font-size wp-block-paragraph">​​圖：local-first Agent Skill，用來查詢、開發、修改與審核 Bricks Builder 網站</p>



<figure class="wp-block-image aligncenter size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/bricks-builder/chat-container-query.webp" alt="提出明確的 Bricks 問題，即可隱式觸發 Skill" style="width:620px"/></figure>



<p class="has-text-align-center has-small-font-size wp-block-paragraph">​​圖：提出明確的 Bricks 問題，即可隱式觸發 Skill</p>



<figure class="wp-block-image aligncenter size-large is-resized img-border"><img decoding="async" src="https://images.kenming.idv.tw/software/bricks-builder/chat-hook-query.webp" alt="需要查詢精確 hook、schema 或實作細節時，可用 $bricks-builder 明確觸發" style="width:620px"/></figure>



<p class="has-text-align-center has-small-font-size wp-block-paragraph">​​圖：需要查詢精確 hook、schema 或實作細節時，可用&nbsp;<code>$bricks-builder</code>&nbsp;明確觸發</p>
<p>〈<a rel="nofollow" href="https://kenming.idv.tw/bricks-builder-development-skill/">為 Bricks Builder 打造一個開發輔助 Skill</a>〉這篇文章最早發佈於《<a rel="nofollow" href="https://kenming.idv.tw">Kenmingの鮮思維</a>》。</p>
]]></content:encoded>
					
					<wfw:commentRss>https://kenming.idv.tw/bricks-builder-development-skill/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
		<media:content url="https://images.kenming.idv.tw/software/bricks-builder/bricks-builder-skill-cover.webp" medium="image"></media:content>
	</item>
	</channel>
</rss>
