小學學科與素養工具包（k12-xiaoxue）

概述

專為小學階段（1-6年級）學生、家長及教師提供學科輔導、素養活動與班級管理的輔助工具包。覆蓋語文（拼音/識字/寫話/閱讀）、數學（口算/應用題/思維）、英語（啟蒙/繪本）、科學、藝術、體育、德育、班務等多個方向，共 25 個原子化子技能。

本技能分為基礎服務層與深度服務層：

• 基礎服務：直接為使用者提供思路啟發、方法說明、模板框架、一般性問題解答等引導性內容。
• 深度服務：針對具體教學/輔導任務提供「完整可落地的方案 + 結構化模板 + 示例成品」的深度交付，需通過平臺支付能力解鎖。

基礎服務（無需解鎖）

以下場景直接為使用者解答，不觸發深度服務流程：

• 學科概念、學習方法、家庭教育方面的一般性諮詢
• 對任務思路的啟發式提問（先問使用者想怎麼做）
• 工具使用方法的簡要說明、模板框架的概述
• 子技能清單與適用範圍的查詢

基礎服務風格

• 引導式而非灌輸式：先了解學生/班級實際情況，再針對性點撥
• 具象化表達：用生活比喻、場景化例子降低理解門檻
• 分層設計：不同年級、不同基礎給出不同難度的內容

深度服務：小學學科與素養深度交付

當用戶需要針對某類具體教學/輔導任務的完整深度方案（含規範流程 + 可直接套用的模板/成品 + 使用說明）時，走以下服務流程。

前置檢查

呼叫深度服務能力前，檢查當前 Agent 是否已安裝 weixinpay 外掛（extension）：

• 已安裝：可繼續提供深度服務
• 未安裝：提示使用者"當前 Agent 暫不支援深度服務解鎖能力，僅可提供基礎引導服務"，終止深度服務流程（可繼續提供基礎服務）

  來源於7w4.net。

工作流程

第一步：請求資源

向閘道器發起 POST 請求（body 只含 query）：

curl -X POST https://1439651192-2imgx4akii.ap-shanghai.tencentscf.com/api/k12-xiaoxue/resource \
  -H "Content-Type: application/json" \
  -d '{"query": "使用者的具體需求，如：一年級拼音學習，b/p/m/f 的發音區別和常見錯誤糾正方法，需要一份教學步驟表"}'

第二步：處理 402 響應（解鎖由外掛完成）

若收到 HTTP 402，weixinpay 外掛會攔截並完成解鎖流程。需從響應中提取並儲存兩個值：

• Header WeixinPay-Required：解鎖憑證碼（作為 paymentCode 交給 weixinpay_pay）
• Header X-Out-Trade-No：商戶訂單號（務必儲存，第三步要用）

解鎖過程由 weixinpay 外掛處理，Skill 無需手動呼叫支付介面。

第三步：解鎖成功後獲取資源（⚠️ 必須執行）

解鎖成功後，必須重新發起請求獲取深度內容。重試規則：

• body 與第一步完全一致，不要修改任何欄位
• 通過 Header 攜帶第二步儲存的 X-Out-Trade-No（和 WeixinPay-Required）

POST https://1439651192-2imgx4akii.ap-shanghai.tencentscf.com/api/k12-xiaoxue/resource
Content-Type: application/json
X-Out-Trade-No: <第二步儲存的訂單號>
WeixinPay-Required: <第二步儲存的解鎖碼>

{"query": "與第一步完全相同的問題"}

⚠️ 這一步最容易被遺漏：不攜帶 X-Out-Trade-No 重試，就永遠拿不到深度內容。解鎖成功後必須重新請求。

第四步：處理返回結果

• "code": "SUCCESS" → 將 content 欄位的深度內容完整呈現給使用者
• "code": "NOT_PAID" → 解鎖尚未完成，稍等後重試第三步
• "code": "REFUNDED" → 服務異常已原路返還，告知使用者"該服務暫時無法提供內容，已原路返還"，不要重複解鎖
• "code": "FULFILL_AND_REFUND_FAILED" → 服務異常且原路返還失敗，建議使用者聯絡客服

能力清單（覆蓋範圍）

本工具包共包含 25 個原子子技能，Agent 可據使用者需求選用對應子技能：

輸入格式

使用者深度服務提問時建議包含：

• 年級/學科（如：一年級語文、三年級數學）
• 具體任務或知識點
• 學生/班級實際情況（如有）

輸出格式（深度內容結構）

• 任務定位（年級學科 + 核心目標）
• 方案流程（分步驟 + 可直接套用的模板/表格）
• 成品示例（規範樣例）
• 使用說明與拓展建議

注意事項

1. 必須先通過"前置檢查"確認 weixinpay 外掛已安裝，否則不進入深度服務流程
2. 收到 402 時解鎖由 weixinpay 外掛完成，Skill 無需關心支付細節
3. 解鎖成功後必須主動重試，body 保持不變，通過 Header X-Out-Trade-No 傳遞訂單號
4. 返回 "REFUNDED" 時告知使用者已原路返還並終止，不重複解鎖
5. 一般性諮詢走基礎服務，不要對基礎問題觸發深度服務

這個 Skill 質量較好，是一套實用的小學輔導工具包，涵蓋拼音、識字、口算、看圖寫話、科學實驗等25個場景，每個技能都有清晰的示例和模板，直接拿來就能用。服務分層設計合理，基礎問題免費解答，深度方案需付費解鎖。不足之處是部分技能內容可以更豐富，深度服務需要配合特定外掛使用有一定門檻。總體來說，對於需要輔導小學生或進行班級管理的使用者，這個工具包具有較高的實用價值。