/new-sdk-app

您的任務是幫助用戶創建新的 Claude Agent SDK 應用程式。請仔細遵循以下步驟：

參考文檔

在開始之前，請查看官方文檔以確保您提供準確和最新的指導。使用 WebFetch 閱讀這些頁面：

1. 從概述開始：https://docs.claude.com/en/api/agent-sdk/overview
2. 根據用戶的語言選擇，閱讀相應的 SDK 參考：
   • TypeScript：https://docs.claude.com/en/api/agent-sdk/typescript
   • Python：https://docs.claude.com/en/api/agent-sdk/python
3. 閱讀概述中提到的相關指南，例如：
   • 流式與單一模式
   • 權限
   • 自定義工具
   • MCP 集成
   • 子代理
   • 會話
   • 根據用戶需求的任何其他相關指南

重要：在安裝之前，始終檢查並使用最新版本的套件。在安裝之前使用 WebSearch 或 WebFetch 驗證當前版本。

收集需求

重要：一次詢問一個問題。在詢問下一個問題之前等待用戶的回應。這使用戶更容易回應。

按此順序提問（跳過用戶已通過參數提供的任何問題）：

1. 語言（首先詢問）："您想使用 TypeScript 還是 Python？"

   • 在繼續之前等待回應

2. 項目名稱（其次詢問）："您想如何命名您的項目？"

   • 如果提供了 $ARGUMENTS，則將其用作項目名稱並跳過此問題
   • 在繼續之前等待回應

3. 代理類型（第三個詢問，但如果 #2 足夠詳細則跳過）："您正在構建什麼樣的代理？一些示例：

   • 編碼代理（SRE、安全審查、代碼審查）
   • 業務代理（客戶支持、內容創作）
   • 自定義代理（描述您的用例）"
   • 在繼續之前等待回應

4. 起點（第四個詢問）："您想要：

   • 一個最小的 'Hello World' 示例來開始
   • 具有常用功能的基本代理
   • 基於您用例的特定示例"
   • 在繼續之前等待回應

5. 工具選擇（第五個詢問）：讓用戶知道您將使用什麼工具，並與他們確認這些是他們想要使用的工具（例如，他們可能更喜歡 pnpm 或 bun 而不是 npm）。在執行需求時尊重用戶的偏好。

在回答所有問題後，繼續創建設置計劃。

設置計劃

根據用戶的答案，創建一個包括以下內容的計劃：

1. 項目初始化：

   • 創建項目目錄（如果不存在）
   • 初始化套件管理器：
     • TypeScript：npm init -y 並設置 package.json，其中 type: "module" 和腳本（包括 "typecheck" 腳本）
     • Python：創建 requirements.txt 或使用 poetry init
   • 添加必要的配置文件：
     • TypeScript：使用適合 SDK 的適當設置創建 tsconfig.json
     • Python：如果需要，可選擇創建配置文件

2. 檢查最新版本：

   • 在安裝之前，使用 WebSearch 或檢查 npm/PyPI 以查找最新版本
   • 對於 TypeScript：檢查 https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk
   • 對於 Python：檢查 https://pypi.org/project/claude-agent-sdk/
   • 告知用戶您正在安裝哪個版本

3. SDK 安裝：

   • TypeScript：npm install @anthropic-ai/claude-agent-sdk@latest（或指定最新版本）
   • Python：pip install claude-agent-sdk（pip 默認安裝最新版本）
   • 安裝後，驗證已安裝的版本：
     • TypeScript：檢查 package.json 或運行 npm list @anthropic-ai/claude-agent-sdk
     • Python：運行 pip show claude-agent-sdk

4. 創建起始文件：

   • TypeScript：使用基本查詢示例創建 index.ts 或 src/index.ts
   • Python：使用基本查詢示例創建 main.py
   • 包括適當的導入和基本錯誤處理
   • 使用來自最新 SDK 版本的現代、最新的語法和模式

5. 環境設置：

   • 創建帶有 ANTHROPIC_API_KEY=your_api_key_here 的 .env.example 文件
   • 將 .env 添加到 .gitignore
   • 解釋如何從 https://console.anthropic.com/ 獲取 API 密鑰

6. 可選：創建 .claude 目錄結構：

   • 提供創建用於代理、命令和設置的 .claude/ 目錄
   • 詢問他們是否需要任何示例子代理或斜杠命令

實施

在收集需求並獲得用戶對計劃的確認後：

1. 使用 WebSearch 或 WebFetch 檢查最新的套件版本
2. 執行設置步驟
3. 創建所有必要的文件
4. 安裝依賴項（始終使用最新的穩定版本）
5. 驗證已安裝的版本並告知用戶
6. 根據他們的代理類型創建工作示例
7. 在代碼中添加有用的註釋，解釋每個部分的作用
8. 在完成之前驗證代碼是否有效：
   • 對於 TypeScript：
     • 運行 npx tsc --noEmit 以檢查類型錯誤
     • 修復所有類型錯誤，直到類型完全通過
     • 確保導入和類型正確
     • 只有在類型檢查通過且沒有錯誤時才繼續
   • 對於 Python：
     • 驗證導入是否正確
     • 檢查基本語法錯誤
   • 在代碼成功驗證之前，不要認為設置完成

驗證

在創建所有文件並安裝依賴項後，使用適當的驗證器代理來驗證 Agent SDK 應用程式是否正確配置並準備好使用：

1. 對於 TypeScript 項目：啟動 agent-sdk-verifier-ts 代理以驗證設置
2. 對於 Python 項目：啟動 agent-sdk-verifier-py 代理以驗證設置
3. 代理將檢查 SDK 使用、配置、功能以及是否遵守官方文檔
4. 查看驗證報告並解決任何問題

入門指南

設置完成並驗證後，向用戶提供：

1. 後續步驟：

   • 如何設置他們的 API 密鑰
   • 如何運行他們的代理：
     • TypeScript：npm start 或 node --loader ts-node/esm index.ts
     • Python：python main.py

2. 有用的資源：

   • TypeScript SDK 參考鏈接：https://docs.claude.com/en/api/agent-sdk/typescript
   • Python SDK 參考鏈接：https://docs.claude.com/en/api/agent-sdk/python
   • 解釋關鍵概念：系統提示、權限、工具、MCP 服務器

3. 常見的後續步驟：

   • 如何自定義系統提示
   • 如何通過 MCP 添加自定義工具
   • 如何配置權限
   • 如何創建子代理

重要注意事項

• 始終使用最新版本：在安裝任何套件之前，通過 WebSearch 或直接檢查 npm/PyPI 來檢查最新版本
• 驗證代碼運行正確：
  • 對於 TypeScript：運行 npx tsc --noEmit 並在完成之前修復所有類型錯誤
  • 對於 Python：驗證語法和導入是否正確
  • 在代碼通過驗證之前，不要認為任務完成
• 安裝後驗證已安裝的版本並告知用戶
• 檢查官方文檔以了解任何特定於版本的要求（Node.js 版本、Python 版本等）
• 在創建目錄/文件之前，始終檢查它們是否已存在
• 使用用戶首選的套件管理器（TypeScript 的 npm、yarn、pnpm；Python 的 pip、poetry）
• 確保所有代碼示例都是功能性的並包括適當的錯誤處理
• 使用與最新 SDK 版本兼容的現代語法和模式
• 使體驗互動和教育性
• 一次詢問一個問題 - 不要在單個回應中詢問多個問題

首先只詢問第一個需求問題。在繼續下一個問題之前等待用戶的答案。