iT邦幫忙

2025 iThome 鐵人賽

DAY 5
0
生成式 AI

LLM - Zero to Hero or Give Up ?系列 第 5

【Day05】情境工程工具(coleam00/context-engineering-intro)

  • 分享至 

  • xImage
  •  

介紹

前一天的鐵人賽挑戰文章介紹的可以協助設定 Global Instruction 的工具 10xrules。但單純使用這個工具來產生 Global Instruction 可能還不夠,因為在真正的開發過程中,每個 Task 都還需要有自己的 Context。

這個 Context 可能是過去的對話紀錄、相關文件、程式碼片段等...。但要突然要開發人員「無中生有」這些 Context 也是一件很困難的事情,這篇文章要介紹一個叫做 coleam00/context-engineering-intro 的專案,這個專案提供了一個簡單的範例,讓開發人員可以藉由實際操作來了解如何在開發過程中會有哪些 Context 需要被提供給 LLM。

coleam00/context-engineering-intro 介紹

20250904212022

這個 Repo 的主要 2 大功能:

  1. 透過 LLM 產生產品需求提示(Product Requirement Prompt,PRP)
  2. 藉由前面產生的 PRP 來進行程式開發

專案結構

首先,這份專案是設計給 Claude Code 使用的,但是也是可以透過其它 AI Code Assistant(GitHub Copilot)工具來使用的。

.
├── .claude
│   ├── commands
│   │   ├── execute-prp.md # ⭐ 執行 PRP 的提示
│   │   └── generate-prp.md # ⭐ 產生 PRP 的提示
│   └── settings.local.json
├── claude-code-full-guide # 暫時略過
├── CLAUDE.md # ⭐ Global Instruction 設定
├── examples
├── .gitattributes
├── .gitignore
├── INITIAL_EXAMPLE.md
├── INITIAL.md # ⭐ 任務說明(簡單提供,後續會使用 /generate-prp 產出更完善的 PRP)
├── LICENSE
├── PRPs
│   ├── EXAMPLE_multi_agent_prp.md
│   └── templates
│       └── prp_base.md # ⭐ PRP 基本模版
├── README.md
└── use-cases # 暫時略過

這份專案經過時間的演進,裡面的架構比當初使用時更複雜了,不過主要可以聚焦在上面標記 ⭐ 的檔案。各位只需要針對這些檔案進行修改就可以了。

需要修改的檔案有:

  • INITIAL.md:提供任務的基本說明
  • CLAUDE.md:負責整個專案的 Global Instruction 設定(Optional)
  • PRPs/templates/prp_base.md:PRP 的基本模版(Optional)

補充說明

上面寫著 Optional 是因為這些檔案在原本的 Repo 裡面已經有預設的內容了,可以先嘗試使用預設內容來進行開發,等到熟悉流程之後再根據自己的需求來進行修改。

補充說明

目前的 CLAUDE.md 對應的是 AGENTS.mdAGENTS.md 是目前多家廠商的共識,就像過去開發人員都會把程式的基本介紹寫在 README.md 一樣,AGENTS.md 是專門提供給 LLM 的開發指引。截至目前,已經有 Codex、Cursor、Gemini CLI、GitHub Copilot 加入這個供應商中立的標準協議(但 Claude Code 還沒)。若是想看其它開發人員的 AGENTS.md 可以到 GitHub Search 查看。

產生 PRP 的流程

  1. 首先,打開 INITIAL.md,根據自己的需求來修改任務說明
  2. 接著,使用 /generate-prp INITIAL.md 讓 LLM 可以根據 INITIAL.md 的內容來產生 PRP
  3. 最後,使用 /execute-prp PRPs/example_prp.md 來讓 LLM 根據 PRP 的內容來進行程式開發

補充說明

在實際操作的過程中,筆者主要是使用 GitHub Copilot 來進行開發,所以嘗試過使用不同的 AI Model 來產出 PRP。根據筆者的經驗,Claude Sonnet 對比 GPT、Gemini 或是其它開源權重的模型,能夠產出更符合需求的 PRP。

另外,還有一點貼心建議,在請 AI Model 產出 PRP 的時候可以請它根據需求來按照開發步驟來產出「多個」PRP,這樣會比一次產出「一個」PRP 的內容更加詳細,後續在開發的時候一步一步跟著步驟走,確認每個步驟都符合需求也沒有錯誤的時後再進行下一步。

重點回顧

  • 使用 coleam00/context-engineering-intro 來進行 Context Engineering 實戰
  • 快速從 INITIAL.md + /generate-prp INITIAL.md 產出 PRP
  • 提供產出優質 PRP 的小技巧(使用 Claude Sonnet + 拆解任務成小步驟)
  • 補充目前 Global Instruction 的標準格式是使用 AGENTS.md

參考資料


上一篇
【Day04】情境工程工具(10xrules)
下一篇
【Day06】情境工程工具(bmad-code-org/BMAD-METHOD)
系列文
LLM - Zero to Hero or Give Up ?7
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言