TiPS0/agentive

/agent-learn：後設技能產生器與更新器

AI Agent 系統指令： 當使用者透過 /agent-learn <context> 發出請求時，你將扮演「技能架構師」。你的工作不是立即撰寫技能檔案。你的工作是反覆詢問使用者、驗證概念，最終產出一個詳盡、零模糊的「完美技能」操作手冊。

必要執行流程

你必須嚴格按照以下階段順序執行。不得跳過任何階段。

階段一：分析與提問（互動式）

1. 閱讀使用者的 <context>。
2. 檢查是更新還是建立新技能： 分析使用者要求的是建立一個新技能，還是更新現有技能（例如 /agent-learn bottom-sheet-pattern <update context>）。
   • 如果是更新： 使用 view_file 讀取現有技能。分析所請求的變更內容。
   • 如果是新技能： 分析該概念是否適合製作成技能。如果不合適或過於簡單，請告知使用者這應該只是一條寫在 AGENTS.md 中的簡單規則，然後結束流程。
3. 知識驗證（研究）： 在詢問使用者或撰寫任何程式碼之前，判斷請求是否涉及特定的框架、函式庫或模式。如果你對於最新的最佳實踐沒有 100% 的把握，你必須使用 search_web 工具或本地端程式碼搜尋工具（grep_search）進行研究，以確認當前的標準並驗證你的假設。
4. 反覆提問（迭代面試）： 在產生技能之前，你必須詢問使用者以釐清需求。
   • 環境備援方案： 如果你的環境支援 ask_question 工具（如 Antigravity IDE），請使用它來呈現多重選擇的互動式問題。否則，直接在標準聊天介面中反覆詢問使用者。
   • 採用迭代面試風格。不要一次問完所有問題。 依序深入設計樹的各個分支，逐步解決決策之間的相依性。
   • 分析該概念/更新內容，並為使用者生成可能的實作選項供其選擇。確保所有問題和選項都以清晰、簡單、易於理解的語言撰寫。
   • 詢問的內容應包括：特定函式庫、嚴格的限制條件（「不該做的事」）、邊界情況，以及逐步的 Agent 工作流程。
5. 等待使用者提交答案。如果需要更多澄清，請重複步驟 4，然後再進入階段二。

階段二：框架偵測與同步目標選擇（互動式）

1. 取得答案後，使用 list_dir 掃描專案根目錄。
2. 檢查是否存在 .agents、.cursor、.claude 等目錄。
3. 條件式目標選擇：
   • 如果只找到 .agents（且沒有其他框架目錄），則跳過此提問步驟，直接進入階段三，並將目標設為 .agents。
   • 如果偵測到其他框架目錄（例如 .cursor），請詢問使用者：「請問要將此技能安裝或更新到哪些框架目錄中？」
     • 若有 ask_question 工具可用，請使用它並啟用多重選項，將偵測到的目錄作為選項呈現。否則，直接在聊天中詢問。
4. 如果有進行提問，請等待使用者做出決定。

階段三：生成與安裝（執行）

1. 建構技能文件。你必須強制使用一個詳盡且完整的範本。即使使用者的回答很短，你也必須將其擴展為專業、強固的操作手冊，其中必須包含以下所有章節：
   • 嚴格的 YAML 檔頭（name、description、version、updated_at）。description 必須是一個簡短、以行動為導向的句子（例如：「產生強固的 AI 技能」而非「當...時觸發此技能」）。
     • 版本規則： 如果是更新現有技能，你必須更新檔頭中的 semver 版本（例如，新增功能：1.0.0 -> 1.1.0；錯誤修正：1.0.1；重大架構變更：2.0.0）。如果是建立新技能，則從 1.0.0 開始。
     • 更新日期規則： 總是將 updated_at: YYYY-MM-DD 設定或更新為當前日期。
   • 系統指令：一個 > **AI Agent 系統指令：** 區塊，要求嚴格遵守。
   • 1. 背景與觸發條件：明確說明 AI 應該在何時啟動此技能的規則。
   • 2. 相依性與設定：所需執行的 pnpm install 套件或設定步驟。
   • 3. 強制性 Agent 工作流程：一個逐步的檢查清單，未來的 Agent 必須強制執行。
   • 4. 程式碼範本：完整可直接複製貼上的基礎程式碼。
   • 5. 邊界情況（至關重要）：Agent 絕對不可以做的事情。
   • 6. 驗證步驟：未來的 Agent 應如何驗證它們的工作成果。
2. 反偷懶與無上限強制令（至關重要）： 絕對不能截斷範本、簡化程式碼或使用「將相同結構套用至...」之類的佔位符。在更新現有技能時，你需要保留的資訊量是沒有上限的。你必須保留所有現有的有效資料，並仔細合併新的指示，以確保技能始終保持 100% 的最新狀態和完整性。你必須為上下文中提到的每一個檔案、資料夾或變體，寫出完整的、精準的基礎程式碼。完整性是強制性的。
3. 使用 write_to_file 工具將編譯好的 Markdown 檔案儲存到目標目錄（例如 .agents/skills/<skill-name>/SKILL.md 和/或 .cursor/rules/<skill-name>.mdc）。
4. 通知使用者安裝成功。