@agent-native/core 0.79.12 → 0.79.16

package/corpus/core/docs/content/locales/zh-TW/server.md

@@ -1,22 +1,22 @@
 ---
 title: "伺服器"
-description: "Nitro 伺服器路由、外掛、框架安裝的路由、請求上下文和 SQL 支持的同步。"
+description: "Nitro 伺服器路由、外掛、框架安裝的路由、請求脈絡和 SQL 支援的同步。"
 ---
 
 # 伺服器
 
-代理本機應用程式使用 [Nitro](https://nitro.build) 作為伺服器路由和外掛。大多數產品行為應該存在於 [Actions](/docs/actions) 中；自訂路由適用於 actions 不適合的協議表面：上傳、流式傳輸、公開頁面、webhooks、OAuth 回呼和特定於提供者的 API。
+Agent-Native 應用程式使用 [Nitro](https://nitro.build) 作為伺服器路由和外掛。大多數產品行為應該存在於 [Actions](/docs/actions) 中；自訂路由適用於 actions 不適合的協議表面：上傳、流式傳輸、公開頁面、webhooks、OAuth 回呼和特定於提供者的 API。
 
-```an-diagram title="伺服器上執行什么" summary="操作是預設的。自訂檔案路由和框架安裝的路由共用相同的 Nitro 應用程式和相同的 SQL 資料庫。"
+```an-diagram title="伺服器上執行什麼" summary="操作是預設的。自訂檔案路由和框架安裝的路由共用相同的 Nitro 應用程式和相同的 SQL 資料庫。"
 {
-  "html": "<div class=\"diagram-server\"><div class=\"diagram-col entry\"><div class=\"diagram-node\">瀏覽器 / UI</div><div class=\"diagram-node\">代理循環</div><div class=\"diagram-node\">外部用戶端<br><small class=\"diagram-muted\">HTTP · MCP · A2A</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>Nitro 伺服器</strong><div class=\"diagram-row\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">預設表面</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">/_agent-native/*</span><small class=\"diagram-muted\">framework routes</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">/api/*</span><small class=\"diagram-muted\">custom file routes</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">plugins</span><small class=\"diagram-muted\">啟動：遷移、工作</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>SQL 資料庫<br><small class=\"diagram-muted\">Drizzle · 協調點</small></div></div>",
+  "html": "<div class=\"diagram-server\"><div class=\"diagram-col entry\"><div class=\"diagram-node\">瀏覽器 / UI</div><div class=\"diagram-node\">代理迴圈</div><div class=\"diagram-node\">外部用戶端<br><small class=\"diagram-muted\">HTTP · MCP · A2A</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>Nitro 伺服器</strong><div class=\"diagram-row\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">預設表面</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">/_agent-native/*</span><small class=\"diagram-muted\">framework routes</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">/api/*</span><small class=\"diagram-muted\">custom file routes</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">plugins</span><small class=\"diagram-muted\">啟動：遷移、工作</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>SQL 資料庫<br><small class=\"diagram-muted\">Drizzle · 協調點</small></div></div>",
   "css": ".diagram-server{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-server .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-server .diagram-panel{display:flex;flex-direction:column;gap:8px;padding:14px 16px}.diagram-server .diagram-row{display:flex;align-items:center;gap:8px}.diagram-server .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
 
 ## 基於檔案的路由 {#file-based-routes}
 
-`server/routes/` 和 Nitro 中的路由將檔案名對應到方法和路徑：
+`server/routes/` 和 Nitro 中的路由將檔名對應到方法和路徑：
 
 ```text
 server/routes/
@@ -42,14 +42,14 @@ export default defineEventHandler(() => ({
 
 ### 路由命名約定 {#route-naming-conventions}
 
-| 檔案名模式         | HTTP方法 | 範例路徑                  |
-| ------------------ | -------- | ------------------------- |
-| `index.get.ts`     | GET      | `/api/items`              |
-| `index.post.ts`    | POST     | `/api/items`              |
-| `[id].get.ts`      | GET      | `/api/items/:id`          |
-| `[id].patch.ts`    | PATCH    | `/api/items/:id`          |
-| `[id].delete.ts`   | DELETE   | `/api/items/:id`          |
-| `[...slug].get.ts` | GET      | `/api/items/*` 或包羅萬象 |
+| 檔名模式           | HTTP 方法 | 範例路徑                  |
+| ------------------ | --------- | ------------------------- |
+| `index.get.ts`     | GET       | `/api/items`              |
+| `index.post.ts`    | POST      | `/api/items`              |
+| `[id].get.ts`      | GET       | `/api/items/:id`          |
+| `[id].patch.ts`    | PATCH     | `/api/items/:id`          |
+| `[id].delete.ts`   | DELETE    | `/api/items/:id`          |
+| `[...slug].get.ts` | GET       | `/api/items/*` 或包羅萬象 |
 
 ## 首選 Actions 進行應用操作 {#actions-first}
 
@@ -57,16 +57,16 @@ export default defineEventHandler(() => ({
 
 - 代理工具。
 - 型別化前端掛鉤。
-- `/_agent-native/actions/:name`下的HTTP端點。
-- MCP 和 A2A 可調用工具。
+- `/_agent-native/actions/:name`下的 HTTP 端點。
+- MCP 和 A2A 可呼叫工具。
 - CLI 用於開發的指令。
 
 僅當您需要路由型協議或二進制/流行為時才使用自訂 `/api/*` 路由。參見[Actions](/docs/actions)。
 
-## 一次性文本完成 {#complete-text}
+## 一次性文字完成 {#complete-text}
 
-大多數人工智能工作應通過代理聊天進行，以便使用者可以檢視、引導和審核
-發生了什么。對於有意不需要的窄伺服器端轉換
+大多數人工智慧工作應透過代理聊天進行，以便使用者可以檢視、引導和審核
+發生了什麼。對於有意不需要的窄伺服器端轉換
 工具、聊天紀錄或執行狀態，使用 `completeText()` 作為顯式轉義
 孵化。
 
@@ -93,15 +93,15 @@ export default defineAction({
 });
 ```
 
-`completeText()` 通過與代理相同的設定引擎層執行
+`completeText()` 透過與代理相同的設定引擎層執行
 聊天，包括 Builder、Anthropic、AI SDK 提供者、使用者/應用模型預設值，
 請求範圍的秘密和引擎規範化的錯誤。它僅適用於伺服器；不要
-從用戶端程式碼調用模型提供者。如果操作是面向使用者的，則將其包裝起來
+從用戶端程式碼呼叫模型提供者。如果操作是面向使用者的，則將其包裝起來
 在一個操作中，以便 UI 和代理共用相同的功能。
 
-## 請求上下文和存取 {#request-context}
+## 請求脈絡和存取 {#request-context}
 
-Actions 由框架自動安裝並與請求上下文一起執行。自訂路線則不然。如果自訂路由讀取或寫入可擁有的資源，則載入工作階段並包裝工作：
+Actions 由框架自動安裝並與請求脈絡一起執行。自訂路由則不然。如果自訂路由讀取或寫入可擁有的資源，則載入工作階段並包裝工作：
 
 ```an-annotated-code title="將自訂路由範圍限定為請求使用者"
 {
@@ -111,12 +111,12 @@ Actions 由框架自動安裝並與請求上下文一起執行。自訂路線則
   "annotations": [
     {
       "lines": "7-10",
-      "label": "自訂路由沒有自動上下文",
+      "label": "自訂路由沒有自動脈絡",
       "note": "與操作不同，檔案路由必須載入工作階段本身，並且在沒有經過驗證的使用者時無法關閉。"
     },
     {
       "lines": "12-13",
-      "label": "建立請求上下文",
+      "label": "建立請求脈絡",
       "note": "`runWithRequestContext` 使 user/org 在工作期間可供範圍界定助手使用。"
     },
     {
@@ -128,11 +128,11 @@ Actions 由框架自動安裝並與請求上下文一起執行。自訂路線則
 }
 ```
 
-`getDb`是通過`server/db/index.ts`中的`createGetDb(schema)`為每個應用程式建立的，因此自訂路由從範本（`../../db/index.js`）匯入，而不是從`@agent-native/core/db`匯入；見[Database — Where the DB Client Lives](/docs/database#db-client)。不要在自訂路由中執行無作用域的 `db.select().from(ownableTable)`。
+`getDb`是透過`server/db/index.ts`中的`createGetDb(schema)`為每個應用程式建立的，因此自訂路由從範本（`../../db/index.js`）匯入，而不是從`@agent-native/core/db`匯入；見[Database — Where the DB Client Lives](/docs/database#db-client)。不要在自訂路由中執行無作用域的 `db.select().from(ownableTable)`。
 
 ## 伺服器外掛 {#server-plugins}
 
-外掛位於 `server/plugins/` 中並在啟動時執行。將它們用於遷移、提供程序設定、重複作業、整合適配器和框架外掛設定。
+外掛位於 `server/plugins/` 中並在啟動時執行。將它們用於遷移、提供者設定、重複作業、整合轉接器和框架外掛設定。
 
 ```ts
 // server/plugins/db.ts
@@ -164,28 +164,28 @@ export default runMigrations(
 | 路由前綴                         | 目的                                                             |
 | -------------------------------- | ---------------------------------------------------------------- |
 | `/_agent-native/actions/:name`   | 操作 HTTP 端點                                                   |
-| `/_agent-native/agent-chat`      | 代理聊天循環                                                     |
-| `/_agent-native/poll`            | SQL 支持的 UI 同步                                               |
+| `/_agent-native/agent-chat`      | 代理聊天迴圈                                                     |
+| `/_agent-native/poll`            | SQL 支援的 UI 同步                                               |
 | `/_agent-native/resources/*`     | 工作區資源                                                       |
 | `/_agent-native/extensions/*`    | 執行時擴充功能和擴充功能代理（舊別名：`/_agent-native/tools/*`） |
 | `/_agent-native/integrations/*`  | 訊息傳遞/webhook 整合                                            |
 | `/_agent-native/a2a`             | 代理到代理 JSON-RPC                                              |
-| `/_agent-native/mcp`             | MCP端點                                                          |
+| `/_agent-native/mcp`             | MCP 端點                                                         |
 | `/_agent-native/onboarding/*`    | 設定清單                                                         |
 | `/_agent-native/observability/*` | 跟蹤、意見回饋、評估、實驗                                       |
-| `/_agent-native/file-upload`     | 檔案上傳提供程序端點                                             |
+| `/_agent-native/file-upload`     | 檔案上傳提供者端點                                               |
 
 自訂應用路由應使用 `/api/*`、公開應用路徑或不與 `/_agent-native/` 衝突的提供者特定回調路徑。
 
-## SQL 支持的同步 {#sync}
+## SQL 支援的同步 {#sync}
 
-代理本機不依賴於檔案系統觀察程序或粘性內存狀態。當 actions 或框架助手更改資料時，資料庫同步版本會遞增。用戶端 `useDbSync()` 掛鉤輪詢 `/_agent-native/poll` 並使 React 查詢快取無效。
+Agent-Native 不依賴於檔案系統觀察程式或置頂記憶狀態。當 actions 或框架助手更改資料時，資料庫同步版本會遞增。用戶端 `useDbSync()` 掛鉤輪詢 `/_agent-native/poll` 並使 React 查詢快取無效。
 
-這適用於無伺服器和多執行個體部署，因為資料庫是協調點。如果您在 actions 之外編寫自訂突變，請使用框架助手或發出適當的同步失效，以便開啟 UI 刷新。
+這適用於無伺服器和多執行個體部署，因為資料庫是協調點。如果您在 actions 之外編寫自訂突變，請使用框架助手或發出適當的同步失效，以便開啟 UI 重新整理。
 
-```an-diagram title="SQL-backed 同步循環" summary="沒有觀察者，沒有粘性狀態。寫入會碰撞 SQL 中的版本；每個用戶端都會輪詢版本並重新獲取。"
+```an-diagram title="SQL-backed 同步迴圈" summary="沒有觀察者，沒有置頂狀態。寫入會碰撞 SQL 中的版本；每個用戶端都會輪詢版本並重新取得。"
 {
-  "html": "<div class=\"diagram-sync\"><div class=\"diagram-box\" data-rough>Action / 輔助函數<br><small class=\"diagram-muted\">mutates data</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>SQL 資料庫</strong><small class=\"diagram-muted\">sync version increments</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">useDbSync()<br><small class=\"diagram-muted\">polls /_agent-native/poll</small></div><div class=\"diagram-pill ok\">invalidate caches &rarr; UI refreshes</div></div></div>",
+  "html": "<div class=\"diagram-sync\"><div class=\"diagram-box\" data-rough>Action / 輔助函式<br><small class=\"diagram-muted\">mutates data</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>SQL 資料庫</strong><small class=\"diagram-muted\">sync version increments</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">useDbSync()<br><small class=\"diagram-muted\">polls /_agent-native/poll</small></div><div class=\"diagram-pill ok\">invalidate caches &rarr; UI refreshes</div></div></div>",
   "css": ".diagram-sync{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sync .diagram-col{display:flex;flex-direction:column;gap:8px;align-items:flex-start}.diagram-sync .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -194,7 +194,7 @@ export default runMigrations(
 {
   "method": "GET",
   "path": "/_agent-native/poll",
-  "summary": "返回目前的每個來源資料庫同步版本，以便用戶端可以檢測更改。",
+  "summary": "返回目前的每個來源資料庫同步版本，以便用戶端可以偵測更改。",
   "description": "`useDbSync()` calls this on an interval (and falls back to it when SSE is unavailable). When a returned version is higher than the client's last-seen value, the matching React Query caches are invalidated and refetch.",
   "auth": "Session cookie (request-scoped identity)",
   "responses": [
@@ -208,14 +208,14 @@ export default runMigrations(
 入站 webhooks 應驗證、保留並快速返回。長時間執行的代理工作應使用整合佇列模式：
 
 1. 驗證平台簽名或質詢。
-2. 將持久工作插入SQL。
+2. 將持久工作插入 SQL。
 3. 自觸發簽名的處理器路由。
 4. 立即返回 200。
-5. 讓新的處理器執行執行代理循環並發布結果。
+5. 讓新的處理器執行執行代理迴圈並發布結果。
 
-```an-diagram title="整合佇列模式" summary="Webhook 處理程序以毫秒為單位返回；單獨的簽名執行執行緩慢的代理工作。"
+```an-diagram title="整合佇列模式" summary="Webhook 處理常式以毫秒為單位返回；單獨的簽名執行執行緩慢的代理工作。"
 {
-  "html": "<div class=\"diagram-webhook\"><div class=\"diagram-box\" data-rough>入站 webhook<br><small class=\"diagram-muted\">Slack · Stripe · email</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>Handler</strong><div class=\"diagram-step\"><span class=\"diagram-pill\">1</span><small class=\"diagram-muted\">verify signature</small></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><small class=\"diagram-muted\">將工作寫入 SQL</small></div><div class=\"diagram-step\"><span class=\"diagram-pill\">3</span><small class=\"diagram-muted\">self-fire processor</small></div><div class=\"diagram-step\"><span class=\"diagram-pill ok\">4</span><small class=\"diagram-muted\">return 200 now</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Signed processor<br><small class=\"diagram-muted\">執行代理循環並發布結果</small></div></div>",
+  "html": "<div class=\"diagram-webhook\"><div class=\"diagram-box\" data-rough>入站 webhook<br><small class=\"diagram-muted\">Slack · Stripe · email</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>Handler</strong><div class=\"diagram-step\"><span class=\"diagram-pill\">1</span><small class=\"diagram-muted\">verify signature</small></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><small class=\"diagram-muted\">將工作寫入 SQL</small></div><div class=\"diagram-step\"><span class=\"diagram-pill\">3</span><small class=\"diagram-muted\">self-fire processor</small></div><div class=\"diagram-step\"><span class=\"diagram-pill ok\">4</span><small class=\"diagram-muted\">return 200 now</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Signed processor<br><small class=\"diagram-muted\">執行代理迴圈並發布結果</small></div></div>",
   "css": ".diagram-webhook{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-webhook .diagram-panel{display:flex;flex-direction:column;gap:6px;padding:14px 16px}.diagram-webhook .diagram-step{display:flex;align-items:center;gap:8px}.diagram-webhook .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -223,14 +223,14 @@ export default runMigrations(
 > [!WARNING]
 > 不要依賴返回回應後未等待的承諾 — 無伺服器主機會凍結執行。請參閱 [Messaging](/docs/messaging) 以了解規範整合佇列。
 
-## 高級：逃生艙口 {#advanced-escape-hatches}
+## 進階：逃生艙口 {#advanced-escape-hatches}
 
 大多數範本永遠不需要這些。 Nitro 檔案路由和框架的代理
-聊天外掛已經連線應用伺服器和正式環境代理處理程序。
+聊天外掛已經連線應用伺服器和正式環境代理處理常式。
 僅在外部建置自訂伺服器整合時才使用它們
 標準範本外掛堆堆疊。
 
-### 編程式 H3 伺服器 {#create-server}
+### 程式化式 H3 伺服器 {#create-server}
 
 對於直接需要 H3 應用的自訂包或測試，`createServer()`
 返回預設定的應用程式和路由器：
@@ -247,12 +247,12 @@ router.get(
 );
 ```
 
-### 正式環境代理處理程序 {#agent-handler}
+### 正式環境代理處理常式 {#agent-handler}
 
-框架的代理聊天外掛已安裝正式環境代理處理程序
-用於範本。僅在建置時直接調用`createProductionAgentHandler()`
+框架的代理聊天外掛已安裝正式環境代理處理常式
+用於範本。僅在建置時直接呼叫`createProductionAgentHandler()`
 標準範本外掛堆堆疊之外的自訂伺服器整合 -
-否則通過`AGENTS.md`、skills、actions和
+否則透過`AGENTS.md`、skills、actions和
 代理聊天外掛。
 
 ```ts

package/corpus/core/docs/content/locales/zh-TW/sharing.md

@@ -1,21 +1,21 @@
 ---
 title: "共用和隱私"
-description: "Google Docs 風格的共用，內置於框架中。每個使用者建立的資源（檔案、儀表板、設計、演示文稿、剪輯、錄音、表單）都會獲得相同的預設私人模型以及一致的共用 UI。"
+description: "Google Docs 風格的共用，內建於框架中。每個使用者建立的資源（檔案、儀表板、設計、簡報、剪輯、錄音、表單）都會獲得相同的預設私人模型以及一致的共用 UI。"
 ---
 
 # 共用和隱私
 
-使用者在代理原生應用程式中建立的每個資源（檔案、儀表板、設計、演示文稿、影片編輯、螢幕錄製、會議紀錄、表單、預訂連結）**預設情況下對建立者來說是私人的**。僅當建立者明確共用它或將其可見性更改為 `org` 或 `public` 時，其他人才能看到它。
+使用者在 Agent-Native 應用程式中建立的每個資源（檔案、儀表板、設計、簡報、影片編輯、螢幕錄製、會議紀錄、表單、預訂連結）**預設情況下對建立者來說是私人的**。僅當建立者明確共用它或將其可見性更改為 `org` 或 `public` 時，其他人才能看到它。
 
 它的外觀和工作方式與 Google 檔案類似。相同的共用按鈕、相同的對話框、相同的三層可見性模型、相同的每使用者/每組織授權 - 跨每個範本，無需針對每個應用進行重新設計。
 
-## 為什么選取一種模型 {#why}
+## 為什麼選取一種模型 {#why}
 
-大多數應用程式框架都會共用每個功能的專案。結果：每個類似檔案的介面最終都會有自己的共用對話框、自己的權限模式、自己的存取檢查錯誤。在代理原生中，共用是一個**框架原語**。架構列、存取檢查幫助程序、共用快顯窗口和代理可調用共用 actions 均隨核心一起提供。新範本通過新增兩欄和一行註冊來獲得完整的分享故事。
+大多數應用程式框架都會共用每個功能的專案。結果：每個類似檔案的介面最終都會有自己的共用對話框、自己的權限模式、自己的存取檢查錯誤。在 Agent-Native 中，共用是一個**框架原語**。架構列、存取檢查幫助程式、共用快顯視窗和代理可呼叫共用 actions 均隨核心一起提供。新範本透過新增兩欄和一行註冊來獲得完整的分享故事。
 
 這也意味著代理永遠不必為每個應用程式學習新的共用模型。告訴代理在任何範本中“與作為編輯者的 Alice 共用此內容”，並且會觸發相同的 `share-resource` 操作。
 
-## 三個可見性級別 {#visibility}
+## 三個可見性層級 {#visibility}
 
 粗略的可見性取決於資源本身；細粒度的贈款位於同伴共用表中。
 
@@ -23,9 +23,9 @@ description: "Google Docs 風格的共用，內置於框架中。每個使用者
 | --------- | ------------------------------------------------------------------------- |
 | `private` | 所有者+明確授予的人員。 **每個新資源的預設值。**                          |
 | `org`     | 所有者+顯式授權+同一組織中的任何人（唯讀）。                              |
-| `public`  | 所有者+明確授予+任何知道連結的人（唯讀）。不會出現在其他人的列表/搜尋中。 |
+| `public`  | 所有者+明確授予+任何知道連結的人（唯讀）。不會出現在其他人的清單/搜尋中。 |
 
-`public` 是一個故意安靜的級別：可以通過直接連結存取公開資源，但它**不會**顯示在其他使用者的側邊欄、列表或搜尋中。這使得“共用 URL 的公開”與“跨使用者發現的公開”分開。真正想要跨使用者發現的畫廊和範本目錄明確選取加入。
+`public` 是一個故意安靜的層級：可以透過直接連結存取公開資源，但它**不會**顯示在其他使用者的側邊欄、清單或搜尋中。這使得“共用 URL 的公開”與“跨使用者發現的公開”分開。真正想要跨使用者發現的畫廊和範本目錄明確選取加入。
 
 ```an-diagram title="視野，向外擴大" summary="資源的粗略可見性奠定了基礎；伴隨表中的顯式共用授予會在頂部新增指定人員。"
 {
@@ -46,7 +46,7 @@ description: "Google Docs 風格的共用，內置於框架中。每個使用者
 
 ## 涵蓋內容 {#covered}
 
-每個存儲使用者創作作品的範本都使用此模型。具體來說：
+每個儲存使用者創作作品的範本都使用此模型。具體來說：
 
 - **內容** — 檔案
 - **幻燈片** — 幻燈片
@@ -65,17 +65,17 @@ description: "Google Docs 風格的共用，內置於框架中。每個使用者
 一些區域故意位於共用系統之外：
 
 - **個人資料應用程式**（郵件、宏）- 按設計限定使用者範圍。沒有“共用我的收件箱”概念。
-- **外部真實來源應用程式** - 存取控制位於上游系統中，而不是代理本機應用程式中。
+- **外部真實來源應用程式** - 存取控制位於上游系統中，而不是 Agent-Native 應用程式中。
 - **匿名公開 URLs** — 向登出使用者公開 URL 的表單發布 slugs 和預訂連結 slugs 是一個單獨的軸。它們與共用系統並存，而不是在其之上。
 
-## 分享UI {#share-ui}
+## 分享 UI {#share-ui}
 
-每個可共用資源的標題中都有一個共用按鈕。點選它會開啟一個錨定到按鈕（不是模式）的快顯窗口，其中包含：
+每個可共用資源的標題中都有一個共用按鈕。點選它會開啟一個錨定到按鈕（不是模式）的快顯視窗，其中包含：
 
 - 可見性選取器（`Private` / `Organization` / `Public link`）。
 - “新增人員或團隊”自動完成 - 搜尋組織中的使用者或貼上電子郵件。
 - 用於個人電子郵件授權的 Google 檔案樣式 `通知 people` 核取方塊。
-- 包含角色選取器和刪除控件的目前授權列表。
+- 包含角色選取器和刪除控制項的目前授權清單。
 - 尊重目前可見性的複製連結按鈕。
 
 共用按鈕是一次匯入：
@@ -90,11 +90,11 @@ import { ShareButton } from "@agent-native/core/client";
 />;
 ```
 
-對於列表，請在每行旁邊放置一個 `<VisibilityBadge visibility={row.visibility} />`，以便使用者可以一目了然地了解哪些是私人的，哪些是共用的。
+對於清單，請在每行旁邊放置一個 `<VisibilityBadge visibility={row.visibility} />`，以便使用者可以一目了然地了解哪些是私人的，哪些是共用的。
 
-## 與UI相同型號、代理商 {#agent-and-ui}
+## 與 UI 相同型號、代理 {#agent-and-ui}
 
-框架在每個範本中自動安裝這些 actions - 代理將它們稱為工具，UI 通過 `useActionQuery` / `useActionMutation` 調用它們：
+框架在每個範本中自動安裝這些 actions - 代理將它們稱為工具，UI 透過 `useActionQuery` / `useActionMutation` 呼叫它們：
 
 | 行動                      | 它的作用                                                               |
 | ------------------------- | ---------------------------------------------------------------------- |
@@ -103,7 +103,7 @@ import { ShareButton } from "@agent-native/core/client";
 | `list-resource-shares`    | 顯示目前可見性以及所有顯式授權。                                       |
 | `set-resource-visibility` | 更改為 `private`、`org` 或 `public`。                                  |
 
-告訴代理“與作為編輯的營銷團隊共用此設計”，它會針對 UI 使用的同一端點調用 `share-resource`。結果將顯示在下一次渲染的共用對話框中。
+告訴代理“與作為編輯的行銷團隊共用此設計”，它會針對 UI 使用的同一端點呼叫 `share-resource`。結果將顯示在下一次渲染的共用對話框中。
 
 ## 將其建置到新範本中 {#building}
 
@@ -179,11 +179,11 @@ registerShareableResource({
 });
 ```
 
-之後，列表/讀取查詢通過 `accessFilter()` 傳遞，寫入 actions 使用 `assertAccess()` 來強制執行角色。
+之後，清單/讀取查詢透過 `accessFilter()` 傳遞，寫入 actions 使用 `assertAccess()` 來強制執行角色。
 
-### 可選的強化標志 {#hardening-flags}
+### 可選的強化標誌 {#hardening-flags}
 
-`registerShareableResource` 接受執行程式碼或承載提升信任的資源的兩個安全標志：
+`registerShareableResource` 接受執行程式碼或承載提升信任的資源的兩個安全標誌：
 
 ```ts
 registerShareableResource({
@@ -196,7 +196,7 @@ registerShareableResource({
 });
 ```
 
-`allowPublic: false` 阻止任何調用者（代理或 UI）將資源的可見性設定為 `public`。 `requireOrgMemberForUserShares: true` 拒絕個人使用者向資源所有者組織外部的電子郵件地址授予權限。擴充功能設定了兩者：擴充功能的 HTML 在調用 actions 和 DB 作為 _viewer_ 的 iframe 內執行，因此公開存取將是具有檢視者憑證的任意程式碼。
+`allowPublic: false` 阻止任何呼叫者（代理或 UI）將資源的可見性設定為 `public`。 `requireOrgMemberForUserShares: true` 拒絕個人使用者向資源所有者組織外部的電子郵件地址授予權限。擴充功能設定了兩者：擴充功能的 HTML 在呼叫 actions 和 DB 作為 _viewer_ 的 iframe 內執行，因此公開存取將是具有檢視者憑證的任意程式碼。
 
 ```an-callout
 {
@@ -209,11 +209,11 @@ registerShareableResource({
 
 ## 安全保證 {#security}
 
-共用依賴於框架更廣泛的資料範圍模型 - 對可擁有表的列表/讀/寫存取通過 `accessFilter()` / `resolveAccess()` / `assertAccess()`，並且 `org_id` 標記的資源在組織中不可見。有關完整管道、CI 防護和威脅面，請參閱 [Security → Data Scoping](/docs/security#data-scoping)。
+共用依賴於框架更廣泛的資料範圍模型 - 對可擁有表的清單/讀/寫存取透過 `accessFilter()` / `resolveAccess()` / `assertAccess()`，並且 `org_id` 標記的資源在組織中不可見。有關完整管道、CI 防護和威脅面，請參閱 [Security → Data Scoping](/docs/security#data-scoping)。
 
 ## 另請參閱 {#see-also}
 
 - [Security & Data Scoping](/docs/security) - 共用所依賴的存取過濾器和所有權模型。
-- [Authentication](/docs/authentication) — 工作階段、組織以及身分如何流入請求上下文。
+- [Authentication](/docs/authentication) — 工作階段、組織以及身分如何流入請求脈絡。
 - [Extensions](/docs/extensions#sharing) — 在沙盒迷你應用表面中共用。
 - [Creating Templates](/docs/creating-templates) — 將 `ownableColumns` 連線到新範本的架構中。

package/corpus/core/docs/content/locales/zh-TW/skills-guide.md

@@ -1,19 +1,19 @@
 ---
 title: "Skills指南"
-description: "skills 如何在代理原生中工作：框架 skills、域 skills 以及建立自訂 skills。"
+description: "skills 如何在 Agent-Native 中工作：框架 skills、域 skills 以及建立自訂 skills。"
 ---
 
 # Skills指南
 
 Skills 是 Markdown 檔案，可讓代理深入了解特定模式和工作流程。
 
-## skills是什么 {#what-are-skills}
+## skills是什麼 {#what-are-skills}
 
-Skills 位於 `.agents/skills/<name>/SKILL.md`，包含針對代理的詳細指導。每項技能都專注於一個問題 - 如何存儲資料、如何同步狀態、如何將工作委托給代理聊天。
+Skills 位於 `.agents/skills/<name>/SKILL.md`，包含針對代理的詳細指導。每項技能都專注於一個問題 - 如何儲存資料、如何同步狀態、如何將工作委托給代理聊天。
 
-每個技能的 frontmatter `name` 和 `description` 總是被注入到系統提示符的 skills 塊中，以便代理知道 skills 存在什么。當代理確定技能與工作相關時，會按需載入完整的技能主體（也通過 `docs-search` 顯示）。這就是為什么保持描述簡短且特定於觸發器很重要：描述是代理在決定是否載入其餘部分之前讀取的唯一內容。
+每個技能的 frontmatter `name` 和 `description` 總是被注入到系統提示符的 skills 塊中，以便代理知道 skills 存在什麼。當代理確定技能與工作相關時，會按需載入完整的技能主體（也透過 `docs-search` 顯示）。這就是為什麼保持描述簡短且特定於觸發器很重要：描述是代理在決定是否載入其餘部分之前讀取的唯一內容。
 
-```an-diagram title="漸進式披露" summary="只有每個技能的名稱+描述始終處於上下文中。當工作匹配時，全身會按需載入。"
+```an-diagram title="漸進式披露" summary="只有每個技能的名稱+描述始終處於脈絡中。當工作匹配時，全身會按需載入。"
 {
   "html": "<div class=\"sk-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">始終在系統提示中</span><div class=\"sk-list\"><span class=\"diagram-pill\">storing-data &mdash; <small class=\"diagram-muted\">add data models&hellip;</small></span><span class=\"diagram-pill\">real-time-sync &mdash; <small class=\"diagram-muted\">wire polling&hellip;</small></span><span class=\"diagram-pill\">create-skill &mdash; <small class=\"diagram-muted\">add a skill&hellip;</small></span></div><small class=\"diagram-muted\">just name + description (cheap)</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><small class=\"diagram-muted\">task matches a description</small><span class=\"diagram-pill accent\">load on demand</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Full <code>SKILL.md</code> body<br><small class=\"diagram-muted\">規則、程式碼、應該做和不要做</small></div></div>",
   "css": ".sk-flow{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.sk-flow .diagram-card{display:flex;flex-direction:column;gap:8px;padding:14px 16px;min-width:240px}.sk-flow .sk-list{display:flex;flex-direction:column;gap:6px}.sk-flow .center{display:flex;flex-direction:column;align-items:center;gap:6px}.sk-flow .diagram-arrow{font-size:22px}"
@@ -27,7 +27,7 @@ Skills 位於 `.agents/skills/<name>/SKILL.md`，包含針對代理的詳細指
 | 技能                   | 何時使用                                      |
 | ---------------------- | --------------------------------------------- |
 | `storing-data`         | 新增資料模型，讀/寫設定或狀態                 |
-| `real-time-sync`       | 接線輪詢同步，偵錯UI不更新                    |
+| `real-time-sync`       | 接線輪詢同步，偵錯 UI 不更新                  |
 | `delegate-to-agent`    | 將 AI 工作從 UI 或 actions 委托給代理         |
 | `actions`              | 建立或執行代理actions                         |
 | `self-modifying-code`  | 編輯應用來源、元件或樣式                      |
@@ -41,14 +41,14 @@ Skills 位於 `.agents/skills/<name>/SKILL.md`，包含針對代理的詳細指
 | `real-time-collab`     | 多使用者協作編輯                              |
 | `agent-engines`        | 交換或設定底層代理引擎                        |
 | `notifications`        | 應用內和推送通知模式                          |
-| `progress`             | 跟蹤和顯示後台工作進度                        |
+| `progress`             | 跟蹤和顯示背景工作進度                        |
 | `inline-embeds`        | 在代理聊天中嵌入應用程式或 iframe             |
 
 `context-awareness` 和 `a2a-protocol` 是框架級 skills，位於儲存庫根目錄的 `.agents/skills/` 目錄中 - 請參閱每個範本自己的 `.agents/skills/` 了解其繼承的內容。
 
 ## 域名skills {#domain-skills}
 
-範本包括特定於其域的 skills。它們位於相同的 `.agents/skills/` 目錄中，但涵蓋了特定於範本的模式。請參閱每個範本的 `.agents/skills/` 目錄以獲取完整列表；代表性樣本：
+範本包括特定於其域的 skills。它們位於相同的 `.agents/skills/` 目錄中，但涵蓋了特定於範本的模式。請參閱每個範本的 `.agents/skills/` 目錄以取得完整清單；代表性樣本：
 
 - **郵件範本** — `email-drafts`、`draft-queue`
 - **表單範本** — `form-building`、`form-publishing`、`form-responses`
@@ -57,24 +57,24 @@ Skills 位於 `.agents/skills/<name>/SKILL.md`，包含針對代理的詳細指
 
 域 skills 遵循與框架 skills 相同的格式。它們對代理需要遵循的特定範本的模式進行編碼。
 
-## 應用程式支持的 skills {#app-backed-skills}
+## 應用程式支援的 skills {#app-backed-skills}
 
-應用程式支持的 skills 將代理本機應用程式打包為技能市場工件。該捆綁包可以包含代理指令、匯出的 skills、MCP 連線器元資料、託管/本機啟動指令和 UI 表面（例如 MCP 應用程式）。
+應用程式支援的 skills 將 Agent-Native 應用程式打包為技能市場工件。該捆綁包可以包含代理指令、匯出的 skills、MCP 連線器中繼資料、託管/本機啟動指令和 UI 表面（例如 MCP 應用程式）。
 
-> **完整詳細資訊如下：** [App-backed skills — full details](#app-backed-skills-full) 中介紹了應用程式支持的 skills 的機制（清單格式、CLI 指令、市場適配器、自動更新哈希）。
+> **完整詳細資訊如下：** [App-backed skills — full details](#app-backed-skills-full) 中介紹了應用程式支援的 skills 的機制（清單格式、CLI 指令、市場轉接器、自動更新哈希）。
 
 ## 建立自訂 skills {#creating-skills}
 
 在以下情況下建立技能：
 
 - 代理應該重複遵循一個模式
-- 工作流程需要分步指導
+- 工作流程需要逐步指導
 - 您想要從範本中建置檔案
 
 在以下情況下不要建立技能：
 
 - 該指導已存在於另一項技能中 - 請擴充功能它
-- 該指導是一次性的 - 將其放入 `AGENTS.md` 或工作區內存中
+- 該指導是一次性的 - 將其放入 `AGENTS.md` 或工作區記憶中
 
 ## 技能格式 {#skill-format}
 
@@ -87,7 +87,7 @@ Skills 位於 `.agents/skills/<name>/SKILL.md`，包含針對代理的詳細指
   "code": "---\nname: project-imports\ndescription: >-\n  How to import projects from the legacy CSV export. Use when the user uploads\n  a project CSV or asks to migrate projects from the old system.\n---\n\n# Project Imports\n\n## Rule\n\nAlways validate the CSV header row before writing any rows. Reject unknown\ncolumns rather than silently dropping them.\n\n## How\n\n1. Call `get-import-schema` to fetch the expected columns.\n2. Parse the first CSV row and diff against the schema.\n3. If any required columns are missing, return an error — do not proceed.\n4. Stream remaining rows through `create-project-item` in batches of 50.\n\n## Don't\n\n- Don't hold all rows in memory — stream them.\n- Don't create duplicate projects; check for an existing name first.\n\n## Related Skills\n\n- **storing-data** — SQL schema and write patterns for new rows\n- **sharing** — exposing a project to other users after import",
   "annotations": [
     { "lines": "2", "label": "發現鑰匙", "note": "The `name` matches the folder; it is how the skill is invoked as `/project-imports`." },
-    { "lines": "3-5", "label": "觸發器", "note": "這個 `description` 是始終處於上下文中的**唯一**文本。準確地說明該技能“何時”應用。" },
+    { "lines": "3-5", "label": "觸發器", "note": "這個 `description` 是始終處於脈絡中的**唯一**文字。準確地說明該技能“何時”應用。" },
     { "lines": "9-14", "label": "規則第一", "note": "Lead with the hard rule and the why; the agent reads the body only once the task matches." },
     { "lines": "27-30", "label": "交聯", "note": "指出相關技能，以便代理可以將它們連結起來，而不是重新得出指導。" }
   ]
@@ -119,11 +119,11 @@ scope: dev
 ---
 ```
 
-當 `scope` 不存在（或設定為無法識別的值）時，它預設為 `both`，因此每個現有技能都會在執行時載入 - 該欄位完全向後兼容。 `scope: dev` 技能對於任何地方的執行時代理都是不可見的：它被排除在注入系統提示符的 skills 塊和 `docs-search` 結果之外。
+當 `scope` 不存在（或設定為無法識別的值）時，它預設為 `both`，因此每個現有技能都會在執行時載入 - 該欄位完全向後相容。 `scope: dev` 技能對於任何地方的執行時代理都是不可見的：它被排除在注入系統提示符的 skills 塊和 `docs-search` 結果之外。
 
 ### 向您的編碼代理公開僅限開發的技能 {#dev-only-skills}
 
-代理本機執行時從 `.agents/skills/` 讀取 skills。 Claude 程式碼獨立從 `.claude/skills/` 讀取 skills。要使編碼代理可用但對執行時代理隱藏的技能：
+Agent-Native 執行時從 `.agents/skills/` 讀取 skills。 Claude 程式碼獨立從 `.claude/skills/` 讀取 skills。要使編碼代理可用但對執行時代理隱藏的技能：
 
 - 將其標記為 `.agents/skills/<name>/SKILL.md` 中的 `scope: dev`，以便執行時代理永遠不會載入它，和/或
 - 將技能放置或鏡像到 `.claude/skills/<name>/SKILL.md` 下，以便 Claude 程式碼拾取它。
@@ -142,31 +142,31 @@ scope: dev
 
 ## Skills vs AGENTS.md {#skills-vs-agents-md}
 
-> **AGENTS.md** — 概述。列出所有腳本，描述資料模型，解釋應用程式架構。代理首先閱讀此內容以了解應用程式。
+> **AGENTS.md** — 概述。列出所有指令碼，描述資料模型，解釋應用程式架構。代理首先閱讀此內容以了解應用程式。
 >
-> **Skills** — 深入研究。每項技能都側重於一種模式，並包含詳細規則、程式碼範例和“注意事項”列表。當代理需要遵循特定模式時，它會讀取這些內容。
+> **Skills** — 深入研究。每項技能都側重於一種模式，並包含詳細規則、程式碼範例和“注意事項”清單。當代理需要遵循特定模式時，它會讀取這些內容。
 
 `AGENTS.md` 告訴代理應用程式的用途。 Skills 告訴代理*如何*正確地做特定的事情。兩者都是必需的 - `AGENTS.md` 用於定向，skills 用於執行。
 
-## Skills 與內存 {#skills-vs-memory}
+## Skills 與記憶 {#skills-vs-memory}
 
-> **Skills** — 編寫的、可重複使用的操作指南。適用於每個使用者，在工作匹配時按需調用。
+> **Skills** — 編寫的、可重複使用的操作指南。適用於每個使用者，在工作匹配時按需呼叫。
 >
-> **內存 (`LEARNINGS.md` / `memory/MEMORY.md`)** — 共用專案學習和每輪都會載入的個人結構化內存。
+> **記憶 (`LEARNINGS.md` / `memory/MEMORY.md`)** — 共用專案學習和每輪都會載入的個人結構化記憶。
 
-如果這些知識適用於在應用程式中工作的*每個人*（“總是更喜歡 CTE 而不是子查詢”），那么它就是一項技能或共用的 `LEARNINGS.md`。如果它是關於*這個特定使用者*（“史蒂夫喜歡簡潔的答案”），它就屬於 `memory/MEMORY.md`。完整治療請參見[Workspace Memory](/docs/workspace#memory)。
+如果這些知識適用於在應用程式中工作的*每個人*（“總是更喜歡 CTE 而不是子查詢”），那麼它就是一項技能或共用的 `LEARNINGS.md`。如果它是關於*這個特定使用者*（“史蒂夫喜歡簡潔的答案”），它就屬於 `memory/MEMORY.md`。完整治療請參見[Workspace Memory](/docs/workspace#memory)。
 
 ---
 
-# 高級
+# 進階
 
-## 應用程式支持的 skills — 完整詳細資訊 {#app-backed-skills-full}
+## 應用程式支援的 skills — 完整詳細資訊 {#app-backed-skills-full}
 
-應用程式支持的 skills 將代理本機應用程式打包為技能市場工件。
+應用程式支援的 skills 將 Agent-Native 應用程式打包為技能市場工件。
 捆綁包可以包含代理指令、匯出的 skills、MCP 連線器
-元資料、託管/本機啟動說明和 UI 介面，例如 MCP 應用程式。
+中繼資料、託管/本機啟動說明和 UI 介面，例如 MCP 應用程式。
 
-每個應用程式支持的技能都以應用程式根目錄中的 `agent-native.app-skill.json` 開頭：
+每個應用程式支援的技能都以應用程式根目錄中的 `agent-native.app-skill.json` 開頭：
 
 ```json
 {
@@ -206,7 +206,7 @@ npx @agent-native/core@latest skills add assets
 # 回購優先內容 docs/blog/MDX 編輯。
 npx @agent-native/core@latest skills add content --mode local-files --scope project
 
-# Vercel/open技能CLI：僅匯出指令，無MCP設定。
+# Vercel/open技能 CLI：僅匯出指令，無 MCP 設定。
 npx skills@latest add BuilderIO/agent-native --skill assets
 
 # 為本機代理用戶端註冊託管 MCP 連線器。
@@ -215,46 +215,46 @@ npx @agent-native/core@latest app-skill ensure --manifest templates/assets/agent
 # 實現並執行可編輯的本機來源。
 npx @agent-native/core@latest app-skill launch --manifest templates/assets/agent-native.app-skill.json --local --into ./assets-local
 
-# 建置市場適配器：Codex 外掛、Claude 市場、Vercel 技能、
-# plain/Claude技能和MCP設定。
+# 建置市場轉接器：Codex 外掛、Claude 市場、Vercel 技能、
+# plain/Claude 技能和 MCP 設定。
 npx @agent-native/core@latest app-skill pack --manifest templates/assets/agent-native.app-skill.json --out ./dist/assets-skill
 
 # 使用 Vercel/open 技能 CLI 安裝本機匯出的包。
 npx skills@latest add ./dist/assets-skill --skill assets -a codex -y
 
-# 新增生成的 Claude Code 市場，然後安裝其 Assets 外掛。
+# 新增產生的 Claude Code 市場，然後安裝其 Assets 外掛。
 claude plugin marketplace add ./dist/assets-skill/adapters/claude-marketplace
 claude plugin install agent-native-assets@agent-native-apps
 ```
 
 對技能檔案保密。清單應包含僅 URL 連線器
-元資料； OAuth/設備設定發生在 MCP 主機中或通過應用程式的正常設定
+中繼資料； OAuth/設備設定發生在 MCP 主機中或透過應用程式的正常設定
 設定流程。
 
-Vercel Labs `skills` 適配器是便攜式 `skills/<name>/SKILL.md` 捆綁包
+Vercel Labs `skills` 轉接器是便攜式 `skills/<name>/SKILL.md` 捆綁包
 適用於 `npx skills@latest add ...`，但原始 `skills` CLI 僅安裝說明。
-它不執行儲存庫定義的安裝後腳本或註冊 MCP 連線器。
+它不執行儲存庫定義的安裝後指令碼或註冊 MCP 連線器。
 將 Agent Native CLI 保留為本機代理的預設檔案路徑，因為它
 還註冊 MCP 連線器。 `BuilderIO/agent-native`是真正的GitHub
 Vercel/open Skills CLI 的儲存庫來源； `skills.sh` 是一個發現，並且
 排行榜目錄，而不是npm風格的包命名空間。
 
-Claude 程式碼市場適配器寫入
+Claude 程式碼市場轉接器寫入
 `adapters/claude-marketplace/.claude-plugin/marketplace.json` 加一個嵌套
-包含 `skills/<name>/SKILL.md` 和 `.mcp.json` 的外掛目錄。在Claude
+包含 `skills/<name>/SKILL.md` 和 `.mcp.json` 的外掛目錄。在 Claude
 編碼，新增市場，安裝`agent-native-assets@agent-native-apps`，
 重新載入外掛，然後從 `/mcp` 驗證僅限 URL 的 MCP 連線器。
 
-生成的外掛清單設定為自動更新：Claude 程式碼
+產生的外掛清單設定為自動更新：Claude 程式碼
 市場入口集 `autoUpdate: true`（帶有 commit-SHA 版本控制）和
 Codex 外掛 `version` 嵌入捆綁的 skills 和 MCP 的內容哈希
-端點，因此安裝的外掛無需重新打包即可獲取技能更改。
+端點，因此安裝的外掛無需重新打包即可取得技能更改。
 計畫應用程式以這種方式發布為儲存庫根目錄中的可隨時新增的市場 —
 請參閱 [Plan plugin & marketplace](/docs/plan-plugin) 以了解端對端安裝
 和自動更新流程。
 
-對於通過通用CLI而不是安裝複製的skills的使用者
-外掛市場，使用CLI新鮮度指令：
+對於透過通用 CLI 而不是安裝複製的skills的使用者
+外掛市場，使用 CLI 新鮮度指令：
 
 ```bash
 npx @agent-native/core@latest skills status visual-plan
@@ -264,18 +264,18 @@ npx @agent-native/core@latest skills update visual-plan
 `skills update` 掃描已知的 Codex/Claude 專案和使用者技能資料夾，進行比較
 將資料夾哈希複製到最新的捆綁技能，並重寫舊資料夾
 地點。新複製的 Agent Native skills 包括 `agent-native-skill.json`
-標記，以便將來的狀態輸出可以識別來源和哈希值。
+標記，以便將來的狀態輸出可以識別來源和雜湊值。
 
-生成的 Agent Native 應用程式和工作區還包括框架提供的
+產生的 Agent-Native 應用程式和工作區還包括框架提供的
 `.agents/skills` 下的 skills（或 `packages/shared/.agents/skills` 中的
-工作區）。使用以下指令從目前/最新的 CLI 刷新那些支架 skills：
+工作區）。使用以下指令從目前/最新的 CLI 重新整理那些支架 skills：
 
 ```bash
 npm run skills:update
-# 或者，不依賴本機包腳本：
+# 或者，不依賴本機包指令碼：
 npx @agent-native/core@latest skills update scaffold --project
 ```
 
-`AGENTS.md` 和 `.agents/skills` 保持規範。更新指令還可以修複
-Claude 兼容性連結（`CLAUDE.md` 和 `.claude/skills`），因此 Claude 程式碼可見
+`AGENTS.md` 和 `.agents/skills` 保持規範。更新指令還可以修復
+Claude 相容性連結（`CLAUDE.md` 和 `.claude/skills`），因此 Claude 程式碼可見
 相同的說明，無需維護第二個副本。