2025-04-26 19:58:52 +08:00
|
|
|
|
請用 「process_thought」 工具思考以下問題
|
2025-04-19 03:02:44 +08:00
|
|
|
|
|
|
|
|
|
# 專案規範初始化指南
|
|
|
|
|
|
|
|
|
|
## 目的
|
|
|
|
|
|
|
|
|
|
**此文件專為 AI Agent 設計,非一般開發者文檔。**
|
|
|
|
|
**必須生成一個專屬於 AI Agent 操作使用的專案規範文件(rules.md)。**
|
|
|
|
|
|
|
|
|
|
**必須專注於以下關鍵目標:**
|
2025-04-26 19:58:52 +08:00
|
|
|
|
|
2025-04-19 03:02:44 +08:00
|
|
|
|
- 明確專案特定規則與限制,禁止包含通用開發知識
|
|
|
|
|
- 提供 AI 執行任務時所需的專案特定資訊
|
|
|
|
|
- 為 AI 決策過程提供明確指導
|
|
|
|
|
|
|
|
|
|
**強制規定:**
|
2025-04-26 19:58:52 +08:00
|
|
|
|
|
2025-04-19 03:02:44 +08:00
|
|
|
|
- 完成的規範必須使 AI Agent 能立即理解哪些檔案必須參考或修改
|
|
|
|
|
- 明確指示多檔案連動修改要求(例如修改 README.md 時必須同步修改 /docs/zh/README.md)
|
|
|
|
|
- 使用命令式語言定義規則,避免解釋性內容
|
|
|
|
|
- 不要進行專案的功能解釋,而是如何修改功能或增加功能
|
|
|
|
|
- 請提供範例什麼事可以做的,什麼事不可以做的
|
2025-04-27 01:02:48 +08:00
|
|
|
|
- 必須**遞迴**檢查所有資料夾與檔案
|
2025-04-19 03:02:44 +08:00
|
|
|
|
|
|
|
|
|
**嚴重禁止:**
|
2025-04-26 19:58:52 +08:00
|
|
|
|
|
2025-04-19 03:02:44 +08:00
|
|
|
|
- 禁止包含通用開發知識
|
|
|
|
|
- 禁止包含 LLM 已知的通用開發知識
|
|
|
|
|
- 進行專案功能解釋
|
|
|
|
|
|
|
|
|
|
## 建議結構
|
|
|
|
|
|
|
|
|
|
請使用以下結構建立規範文件:
|
|
|
|
|
|
2025-04-26 19:58:52 +08:00
|
|
|
|
```markdown
|
2025-04-19 03:02:44 +08:00
|
|
|
|
# 開發守則
|
2025-04-26 19:58:52 +08:00
|
|
|
|
|
2025-04-19 03:02:44 +08:00
|
|
|
|
## 標題
|
2025-04-26 19:58:52 +08:00
|
|
|
|
|
2025-04-19 03:02:44 +08:00
|
|
|
|
### 副標題
|
2025-04-26 19:58:52 +08:00
|
|
|
|
|
2025-04-19 03:02:44 +08:00
|
|
|
|
- 規則一
|
|
|
|
|
- 規則二
|
2025-04-26 19:58:52 +08:00
|
|
|
|
```
|
2025-04-19 03:02:44 +08:00
|
|
|
|
|
|
|
|
|
## 內容指南
|
|
|
|
|
|
|
|
|
|
規範文件應包含但不限於以下內容:
|
|
|
|
|
|
|
|
|
|
1. **專案概述** - 簡要描述專案的目的、技術棧和核心功能
|
|
|
|
|
2. **專案架構** - 說明主要目錄結構和模塊劃分
|
|
|
|
|
3. **代碼規範** - 包括命名規範、格式要求、註釋規則等
|
|
|
|
|
4. **功能實作規範** - 主要解釋如何實作功能及應該注意事項
|
|
|
|
|
5. **框架/插件/第三方庫使用規範** - 外部依賴的使用規範
|
|
|
|
|
6. **工作流程規範** - 工作流程指南,包含工作流程圖或資料流
|
|
|
|
|
7. **關鍵檔案交互規範** - 關鍵檔案的交互規範,修改哪些檔案需要同步修改
|
|
|
|
|
8. **AI 決策規範** - 提供處理模糊情況的決策樹和優先級判斷標準
|
|
|
|
|
9. **禁止事項** - 明確列出哪些做法是禁止的
|
|
|
|
|
|
|
|
|
|
## 注意事項
|
|
|
|
|
|
|
|
|
|
1. **面向 AI 優化** - 文件將作為 prompt 提供給 Coding Agent AI,應對 prompt 最佳化
|
|
|
|
|
2. **專注於開發指導** - 提供持續開發的規則,而非使用教學
|
|
|
|
|
3. **具體示例** - 盡可能提供「應該做什麼」和「不應該做什麼」的具體示例
|
|
|
|
|
4. **使用命令式語言** - 必須使用直接指令而非描述性語言,減少解釋內容
|
|
|
|
|
5. **結構化呈現** - 所有內容必須以列表、表格等結構化形式呈現,便於 AI 解析
|
|
|
|
|
6. **突出重點標記** - 使用粗體、警告標記等突出關鍵規則和禁忌
|
|
|
|
|
7. **移除通用知識** - 禁止包含 LLM 已知的通用開發知識,僅包含專案特定規則
|
|
|
|
|
|
2025-04-27 01:02:48 +08:00
|
|
|
|
## 更新模式指南
|
|
|
|
|
|
|
|
|
|
1. **最小變動** - 當用戶要求更新專案規則時,除非必要否則你應該雹持現有規則,以最小變更為原則的修改
|
|
|
|
|
2. **時效性** - 你應該檢查有的規則的是否有還效益或過時,因為用戶可能已經修改或移除相關程式,你必須修正或移除相應規則
|
|
|
|
|
3. **完整性** - 你應該檢查現有專案的所有資料夾及檔案內容,因為用戶可能已經有新增或修改相關程式,你必須補充相應的規則
|
|
|
|
|
4. **自主處理模糊請求**:當收到如「更新規則」等未指定具體內容的模糊指令時,AI **必須**首先嘗試自主分析當前程式碼庫、近期變更(如果可用)以及現有的 `rules.md` 內容,以推斷可能的更新點。在 `process_thought` 階段列出這些推斷點及其理由,然後再提出具體修改建議。在執行此自主分析之前,**嚴格禁止**就模糊的更新請求向用戶尋求澄清。
|
|
|
|
|
|
2025-04-19 03:02:44 +08:00
|
|
|
|
請根據以上指南,創建一個名為 rules.md 的文件並存放於: {rulesPath}
|
|
|
|
|
|
2025-04-27 01:02:48 +08:00
|
|
|
|
**[AI Agent Action]**現在開始呼叫 「process_thought」 工具思考如何撰寫出教導 Coding Agent 規範文件
|
|
|
|
|
**[AI Agent Action]**思考完畢後請立即編輯 rules.md 文件,禁止呼叫「analyze_task」工具
|
|
|
|
|
**[AI Agent Action]**嚴禁不呼叫工具。AI 必須自主完成從接收指令到執行修改的完整流程,除非遇到技術錯誤或無法解決的依賴衝突,否則不應中斷流程尋求用戶輸入。
|