@downcity/plugins 1.0.147 → 1.0.149

package/src/contact/PROMPT.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/contact/PROMPT.ts.txt
-const TEXT_MODULE_CONTENT = "Contact plugin\n\ncontact plugin 用来管理和其他 agent 的联系方式。一个 contact 代表一个已建立联系的远端 agent，并固定拥有一条长期对话历史。contact 可以是单向的：只要本 agent 能访问对方，就可以 check、chat、share。\n\n可用 action：\n- `link`：生成一次性联系码，交给另一个 agent。\n- `approve`：使用对方给的联系码建立 contact。\n- `list`：查看已保存的 agent 联系方式。\n- `check`：检查对方是否在线可用。\n- `chat`：和某个 agent 对话。\n- `share`：分享文本、链接、文件或目录。\n- `inbox`：查看收到的分享。\n- `receive`：接收某条分享。\n\n边界：\n- chat 用于对话，share 用于资料交接。\n- `link` action 返回中的 notes 会说明联系码适合本机、局域网还是公网 agent 使用；本地 localhost 联系码不能交给 server agent approve。\n- public-looking endpoint 仍可能被防火墙/NAT 阻断；以返回的 notes 为准，不要承诺公网一定可达。\n- Agent runtime 会在可用时写入 `DOWNCITY_PUBLIC_HOST` 供 contact link 使用；这不是要求用户手动配置的 token 或 endpoint。\n- `approve` action 会先建立单向关系，再由对方主动 ping 回本 agent，ping 成功才升级为 bidirectional。\n- local/private agent 连接 public agent 时通常只能 outbound-only，不要说成双向。\n- contact token 由 link/approve 自动交换；不要要求用户手动配置 token 环境变量。\n- `Contact link not found` 表示请求打到的 agent runtime 没有这条 link 记录，优先检查 endpoint/端口/agent 是否一致；过期会明确返回 `Contact link expired`。\n- receive 只接收内容，不自动执行、不安装 skill、不修改项目业务文件。\n- 不自动 approve 或 receive，除非用户明确要求。\n";
+const TEXT_MODULE_CONTENT = "# Contact Plugin\n\nThe contact plugin manages ways to reach other agents. A contact represents an established remote-agent relationship and owns one long-lived conversation history. A contact may be one-way: as long as this agent can reach the other agent, it can `check`, `chat`, and `share`.\n\nAvailable actions:\n- `link`: create a one-time contact code for another agent.\n- `approve`: use a contact code from another agent to establish a contact.\n- `list`: view saved agent contacts.\n- `check`: check whether the other agent is online and reachable.\n- `chat`: talk with a contact.\n- `share`: share text, links, files, or directories.\n- `inbox`: view received shares.\n- `receive`: receive a share.\n\nBoundaries:\n- Use `chat` for conversation and `share` for handing over materials.\n- The notes returned by the `link` action explain whether a contact code is suitable for local-machine, LAN, or public agents. A localhost contact code must not be given to a server agent for `approve`.\n- A public-looking endpoint may still be blocked by firewall or NAT. Trust the returned notes, and do not promise that public access is guaranteed.\n- The Agent runtime writes `DOWNCITY_PUBLIC_HOST` when available for contact links. This is not a token or endpoint that the user must configure manually.\n- The `approve` action first establishes a one-way relationship. The other agent then pings back to this agent, and only a successful ping upgrades the relationship to bidirectional.\n- When a local/private agent connects to a public agent, the connection is usually outbound-only. Do not describe it as bidirectional.\n- Contact tokens are exchanged automatically by `link` and `approve`. Do not ask the user to manually configure token environment variables.\n- `Contact link not found` means the request reached an agent runtime that does not have this link record. First check whether the endpoint, port, and agent match. Expiration is reported explicitly as `Contact link expired`.\n- `receive` only receives content. It does not execute anything, install skills, or modify project business files automatically.\n- Do not automatically approve or receive unless the user explicitly asks.\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/contact/PROMPT.ts.txt

@@ -1,25 +1,25 @@
-Contact plugin
+# Contact Plugin
 
-contact plugin 用来管理和其他 agent 的联系方式。一个 contact 代表一个已建立联系的远端 agent，并固定拥有一条长期对话历史。contact 可以是单向的：只要本 agent 能访问对方，就可以 check、chat、share。
+The contact plugin manages ways to reach other agents. A contact represents an established remote-agent relationship and owns one long-lived conversation history. A contact may be one-way: as long as this agent can reach the other agent, it can `check`, `chat`, and `share`.
 
-可用 action：
-- `link`：生成一次性联系码，交给另一个 agent。
-- `approve`：使用对方给的联系码建立 contact。
-- `list`：查看已保存的 agent 联系方式。
-- `check`：检查对方是否在线可用。
-- `chat`：和某个 agent 对话。
-- `share`：分享文本、链接、文件或目录。
-- `inbox`：查看收到的分享。
-- `receive`：接收某条分享。
+Available actions:
+- `link`: create a one-time contact code for another agent.
+- `approve`: use a contact code from another agent to establish a contact.
+- `list`: view saved agent contacts.
+- `check`: check whether the other agent is online and reachable.
+- `chat`: talk with a contact.
+- `share`: share text, links, files, or directories.
+- `inbox`: view received shares.
+- `receive`: receive a share.
 
-边界：
-- chat 用于对话，share 用于资料交接。
-- `link` action 返回中的 notes 会说明联系码适合本机、局域网还是公网 agent 使用；本地 localhost 联系码不能交给 server agent approve。
-- public-looking endpoint 仍可能被防火墙/NAT 阻断；以返回的 notes 为准，不要承诺公网一定可达。
-- Agent runtime 会在可用时写入 `DOWNCITY_PUBLIC_HOST` 供 contact link 使用；这不是要求用户手动配置的 token 或 endpoint。
-- `approve` action 会先建立单向关系，再由对方主动 ping 回本 agent，ping 成功才升级为 bidirectional。
-- local/private agent 连接 public agent 时通常只能 outbound-only，不要说成双向。
-- contact token 由 link/approve 自动交换；不要要求用户手动配置 token 环境变量。
-- `Contact link not found` 表示请求打到的 agent runtime 没有这条 link 记录，优先检查 endpoint/端口/agent 是否一致；过期会明确返回 `Contact link expired`。
-- receive 只接收内容，不自动执行、不安装 skill、不修改项目业务文件。
-- 不自动 approve 或 receive，除非用户明确要求。
+Boundaries:
+- Use `chat` for conversation and `share` for handing over materials.
+- The notes returned by the `link` action explain whether a contact code is suitable for local-machine, LAN, or public agents. A localhost contact code must not be given to a server agent for `approve`.
+- A public-looking endpoint may still be blocked by firewall or NAT. Trust the returned notes, and do not promise that public access is guaranteed.
+- The Agent runtime writes `DOWNCITY_PUBLIC_HOST` when available for contact links. This is not a token or endpoint that the user must configure manually.
+- The `approve` action first establishes a one-way relationship. The other agent then pings back to this agent, and only a successful ping upgrades the relationship to bidirectional.
+- When a local/private agent connects to a public agent, the connection is usually outbound-only. Do not describe it as bidirectional.
+- Contact tokens are exchanged automatically by `link` and `approve`. Do not ask the user to manually configure token environment variables.
+- `Contact link not found` means the request reached an agent runtime that does not have this link record. First check whether the endpoint, port, and agent match. Expiration is reported explicitly as `Contact link expired`.
+- `receive` only receives content. It does not execute anything, install skills, or modify project business files automatically.
+- Do not automatically approve or receive unless the user explicitly asks.

package/src/image/ImagePlugin.ts

@@ -535,31 +535,31 @@ export class ImagePlugin extends BasePlugin {
       "",
       "## Actions",
       "",
-      "- `models`：列出当前可用的图片模型，返回 `{ models }`。",
-      "  当你不知道应该使用哪个模型，且插件没有默认图片模型时先调用，并让用户或当前任务上下文明确模型 ID。",
-      "- `image_create`：在用户明确确认后创建一个异步图片任务，返回 `{ job_id, status }`。",
-      "  - 纯文本生成：填 `prompt`（字符串）。",
-      "  - 编辑 / 参考图：填 `content`，格式：",
-      "    `[{ type: \"text\", text }, { type: \"image\", url }]`。可以多段文本和多张图任意顺序混排。",
-      "  - 同时给了 `content` 和 `prompt` 时，`content` 生效，`prompt` 被忽略。",
-      "  - `url` 支持三种写法：在线 URL、绝对本地路径、相对 Agent 项目根目录的相对路径。",
-      "    不要传 base64 / data URL，也不要再用旧的 `messages` 字段。",
-      "  - `model` 可选；未传时使用插件配置的默认图片模型。可选参数：`aspect_ratio`（如 `16:9`）、`size`（如 `1024x1024`）、`quality`、`seed`。",
-      "- `image_result`：用 `job_id` 读取任务状态。",
-      "  - 默认读取一次。`queued` / `running` 时保存好 `job_id`，下一轮再查，不要在同一轮里反复轮询。",
-      "  - 想直接等到出图，可以传 `until_done: true`，可选 `max_wait_ms`（默认 60000，最长 600000）与 `poll_interval_ms`（默认 1500）。超时仍未完成会返回最后一次的中间状态。",
-      "  - `succeeded`：返回的图片 file part 会自动落盘并附加到下一条 assistant 消息，无需自己再拼图。",
-      "  - 回复用户时，可以在消息中使用 Markdown 图片语法 `![](url)` 渲染图片。",
-      "  - `failed`：把 `error` 信息如实回报给用户，不要编造图片结果。",
+      "- `models`: list currently available image models and return `{ models }`.",
+      "  Call this first when you do not know which model to use and the plugin has no default image model. Let the user or current task context specify the model ID.",
+      "- `image_create`: create an async image job after explicit user confirmation, returning `{ job_id, status }`.",
+      "  - Text-only generation: pass `prompt` as a string.",
+      "  - Edits or reference images: pass `content` in this shape:",
+      "    `[{ type: \"text\", text }, { type: \"image\", url }]`. Multiple text parts and images may appear in any order.",
+      "  - If both `content` and `prompt` are provided, `content` takes effect and `prompt` is ignored.",
+      "  - `url` supports three forms: online URL, absolute local path, or a relative path from the Agent project root.",
+      "    Do not pass base64/data URLs, and do not use the legacy `messages` field.",
+      "  - `model` is optional. If omitted, the plugin-configured default image model is used. Optional parameters include `aspect_ratio` such as `16:9`, `size` such as `1024x1024`, `quality`, and `seed`.",
+      "- `image_result`: read job status by `job_id`.",
+      "  - By default, read once. If the status is `queued` or `running`, save the `job_id` and check again in a later turn; do not repeatedly poll in the same turn.",
+      "  - To wait for the image directly, pass `until_done: true` with optional `max_wait_ms` (default 60000, max 600000) and `poll_interval_ms` (default 1500). If the wait times out, the latest intermediate status is returned.",
+      "  - `succeeded`: returned image file parts are automatically written to disk and attached to the next assistant message. You do not need to assemble the image manually.",
+      "  - When replying to the user, you can render images with Markdown image syntax: `![](url)`.",
+      "  - `failed`: report the `error` truthfully to the user. Do not invent image results.",
       "",
       "## Flow",
       "",
-      "1. 如果插件没有默认图片模型，先确认模型 ID；需要选模型时调用 `models`。",
-      "2. 向用户说明将消耗图片生成额度，并等待用户明确确认。",
-      "3. 用户确认后调用 `image_create` 拿到 `job_id`。",
-      "4. `image_result` 查询；短任务可加 `until_done: true` 一次拿结果，长任务保存 `job_id` 下一轮再查。",
+      "1. If the plugin has no default image model, confirm the model ID first; call `models` when model selection is needed.",
+      "2. Explain to the user that image generation will consume image quota, and wait for explicit confirmation.",
+      "3. After the user confirms, call `image_create` to get a `job_id`.",
+      "4. Query with `image_result`; short jobs may use `until_done: true` to get the result in one call, while long jobs should save the `job_id` and check again in a later turn.",
       "",
-      "如有疑问可用 `plugin_read { plugin: \"image\", action: \"...\" }` 查看每个 action 完整的输入 schema 与示例。",
+      "When unsure, use `plugin_read { plugin: \"image\", action: \"...\" }` to inspect each action's complete input schema and examples.",
     ].join("\n");
   }
 

package/src/memory/MemoryPlugin.ts

@@ -127,14 +127,14 @@ export class MemoryPlugin extends BasePlugin {
    */
   readonly actions: PluginActions = {
     status: createAction({
-      description: "查看 memory wiki 状态（wiki/source/working）。",
+      description: "View memory wiki status (wiki/source/working).",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {} },
       },
-      examples: [{ title: "查看状态", payload: {} }],
+      examples: [{ title: "View status", payload: {} }],
       command: {
-        description: "查看 memory wiki 状态（wiki/source/working）",
+        description: "View memory wiki status (wiki/source/working).",
         mapInput() {
           return {};
         },
@@ -145,7 +145,7 @@ export class MemoryPlugin extends BasePlugin {
       },
     }),
     search: createAction({
-      description: "检索 memory wiki，可选择是否扩展到 source 层。",
+      description: "Search memory wiki, optionally extending into the source layer.",
       input_schema: {
         zod: z.object({
           query: z.string(),
@@ -157,24 +157,24 @@ export class MemoryPlugin extends BasePlugin {
           type: "object",
           required: ["query"],
           properties: {
-            query: { type: "string", description: "检索关键词" },
-            maxResults: { type: "number", description: "返回条数上限" },
-            minScore: { type: "number", description: "最小相关分数" },
-            includeSources: { type: "boolean", description: "是否包含 source 层" },
+            query: { type: "string", description: "Search query." },
+            maxResults: { type: "number", description: "Maximum number of results." },
+            minScore: { type: "number", description: "Minimum relevance score." },
+            includeSources: { type: "boolean", description: "Whether to include the source layer." },
           },
         },
       },
       examples: [
-        { title: "搜索记忆", payload: { query: "用户偏好" } },
+        { title: "Search memory", payload: { query: "user preferences" } },
       ],
       command: {
-        description: "检索 memory wiki",
+        description: "Search memory wiki.",
         configure(command: Command) {
           command
             .argument("<query>")
-            .option("--max-results <number>", "返回条数上限", parsePositiveInteger)
-            .option("--min-score <number>", "最小相关分数", parseNumber)
-            .option("--include-sources", "同时检索原始 source 层");
+            .option("--max-results <number>", "Maximum number of results.", parsePositiveInteger)
+            .option("--min-score <number>", "Minimum relevance score.", parseNumber)
+            .option("--include-sources", "Also search the raw source layer.");
         },
         mapInput({ args, opts }) {
           const payload: JsonObject = {
@@ -204,7 +204,7 @@ export class MemoryPlugin extends BasePlugin {
       },
     }),
     read: createAction({
-      description: "读取 memory wiki/source 文件片段。",
+      description: "Read a memory wiki/source file excerpt.",
       input_schema: {
         zod: z.object({
           path: z.string(),
@@ -215,22 +215,22 @@ export class MemoryPlugin extends BasePlugin {
           type: "object",
           required: ["path"],
           properties: {
-            path: { type: "string", description: "记忆文件路径（相对项目根目录）" },
-            from: { type: "number", description: "起始行（1-based）" },
-            lines: { type: "number", description: "读取行数" },
+            path: { type: "string", description: "Memory file path relative to the project root." },
+            from: { type: "number", description: "Starting line, 1-based." },
+            lines: { type: "number", description: "Number of lines to read." },
           },
         },
       },
       examples: [
-        { title: "读取整页", payload: { path: ".downcity/memory/wiki/index.md" } },
+        { title: "Read full page", payload: { path: ".downcity/memory/wiki/index.md" } },
       ],
       command: {
-        description: "读取 memory wiki/source 文件片段",
+        description: "Read a memory wiki/source file excerpt.",
         configure(command: Command) {
           command
-            .argument("<memoryPath>", "记忆文件路径（相对项目根目录）")
-            .option("--from <number>", "起始行（1-based）", parsePositiveInteger)
-            .option("--lines <number>", "读取行数", parsePositiveInteger);
+            .argument("<memoryPath>", "Memory file path relative to the project root.")
+            .option("--from <number>", "Starting line, 1-based.", parsePositiveInteger)
+            .option("--lines <number>", "Number of lines to read.", parsePositiveInteger);
         },
         mapInput({ args, opts }) {
           const payload: JsonObject = {
@@ -255,7 +255,7 @@ export class MemoryPlugin extends BasePlugin {
       },
     }),
     remember: createAction({
-      description: "把事实/偏好/决策记入 memory wiki。",
+      description: "Record facts, preferences, or decisions into memory wiki.",
       input_schema: {
         zod: z.object({
           content: z.string(),
@@ -267,24 +267,24 @@ export class MemoryPlugin extends BasePlugin {
           type: "object",
           required: ["content"],
           properties: {
-            content: { type: "string", description: "需要记住的内容" },
-            topic: { type: "string", description: "记忆主题" },
-            path: { type: "string", description: "目标 wiki page 路径" },
-            source: { type: "string", description: "来源说明" },
+            content: { type: "string", description: "Content to remember." },
+            topic: { type: "string", description: "Memory topic." },
+            path: { type: "string", description: "Target wiki page path." },
+            source: { type: "string", description: "Source note." },
           },
         },
       },
       examples: [
-        { title: "记住偏好", payload: { content: "用户偏好简短回答", topic: "user-prefs" } },
+        { title: "Remember preference", payload: { content: "User prefers concise answers", topic: "user-prefs" } },
       ],
       command: {
-        description: "把事实/偏好/决策记入 memory wiki",
+        description: "Record facts, preferences, or decisions into memory wiki.",
         configure(command: Command) {
           command
-            .requiredOption("--content <text>", "需要记住的内容")
-            .option("--topic <topic>", "记忆主题")
-            .option("--wiki-path <path>", "目标 wiki page 路径")
-            .option("--source <source>", "来源说明");
+            .requiredOption("--content <text>", "Content to remember.")
+            .option("--topic <topic>", "Memory topic.")
+            .option("--wiki-path <path>", "Target wiki page path.")
+            .option("--source <source>", "Source note.");
         },
         mapInput({ opts }) {
           const payload: JsonObject = {
@@ -313,7 +313,7 @@ export class MemoryPlugin extends BasePlugin {
       },
     }),
     digest: createAction({
-      description: "把 session 提炼进 memory wiki。",
+      description: "Digest a session into memory wiki.",
       input_schema: {
         zod: z.object({
           sessionId: z.string(),
@@ -323,20 +323,20 @@ export class MemoryPlugin extends BasePlugin {
           type: "object",
           required: ["sessionId"],
           properties: {
-            sessionId: { type: "string", description: "会话 ID" },
-            maxMessages: { type: "number", description: "提取消息窗口" },
+            sessionId: { type: "string", description: "Session ID." },
+            maxMessages: { type: "number", description: "Message extraction window." },
           },
         },
       },
       examples: [
-        { title: "提炼会话", payload: { sessionId: "sess-1" } },
+        { title: "Digest session", payload: { sessionId: "sess-1" } },
       ],
       command: {
-        description: "把 session 提炼进 memory wiki",
+        description: "Digest a session into memory wiki.",
         configure(command: Command) {
           command
-            .requiredOption("--session-id <sessionId>", "会话 ID")
-            .option("--max-messages <number>", "提取消息窗口", parsePositiveInteger);
+            .requiredOption("--session-id <sessionId>", "Session ID.")
+            .option("--max-messages <number>", "Message extraction window.", parsePositiveInteger);
         },
         mapInput({ opts }) {
           const payload: JsonObject = {
@@ -357,7 +357,7 @@ export class MemoryPlugin extends BasePlugin {
       },
     }),
     revise: createAction({
-      description: "基于新证据修订 memory wiki page。",
+      description: "Revise a memory wiki page based on new evidence.",
       input_schema: {
         zod: z.object({
           path: z.string(),
@@ -368,25 +368,25 @@ export class MemoryPlugin extends BasePlugin {
           type: "object",
           required: ["path", "instruction"],
           properties: {
-            path: { type: "string", description: "目标 wiki page 路径" },
-            instruction: { type: "string", description: "修订指令" },
-            evidence: { type: "string", description: "新证据" },
+            path: { type: "string", description: "Target wiki page path." },
+            instruction: { type: "string", description: "Revision instruction." },
+            evidence: { type: "string", description: "New evidence." },
           },
         },
       },
       examples: [
         {
-          title: "修订条目",
-          payload: { path: "wiki/preferences.md", instruction: "替换最新偏好" },
+          title: "Revise entry",
+          payload: { path: "wiki/preferences.md", instruction: "Replace with latest preference." },
         },
       ],
       command: {
-        description: "基于新证据修订 memory wiki page",
+        description: "Revise a memory wiki page based on new evidence.",
         configure(command: Command) {
           command
-            .argument("<memoryPath>", "目标 wiki page 路径")
-            .requiredOption("--instruction <text>", "修订指令")
-            .option("--evidence <text>", "新证据");
+            .argument("<memoryPath>", "Target wiki page path.")
+            .requiredOption("--instruction <text>", "Revision instruction.")
+            .option("--evidence <text>", "New evidence.");
         },
         mapInput({ args, opts }) {
           const payload: JsonObject = {

package/src/skill/PROMPT.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/skill/PROMPT.ts.txt
-const TEXT_MODULE_CONTENT = "# Skill Plugin\n\nskill 是你拥有的技能。用户的提出的需求和任务，你都需要先考虑利用相关的skill来高质量的完成。\n\n\n## 使用\n\n使用技能时需要首先通过 `skill` plugin 的 `lookup` action 载入对应的技能内容。\n\n如果当前工具集中存在 `plugin_call`，使用：\n\n```ts\nplugin_call({\n  plugin: \"skill\",\n  action: \"lookup\",\n  payload: {\n    name: \"<skill-name>\",\n  },\n});\n```\n\n可用 action 包括 `list`、`find`、`install`、`lookup`。\n";
+const TEXT_MODULE_CONTENT = "# Skill Plugin\n\nSkills are capabilities available to you. For every user request or task, first consider whether a relevant skill can help you complete it with higher quality.\n\n## Usage\n\nBefore using a skill, load its content through the `skill` plugin's `lookup` action.\n\nIf `plugin_call` is available, use:\n\n```ts\nplugin_call({\n  plugin: \"skill\",\n  action: \"lookup\",\n  payload: {\n    name: \"<skill-name>\",\n  },\n});\n```\n\nAvailable actions include `list`, `find`, `install`, and `lookup`.\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/skill/PROMPT.ts.txt

@@ -1,13 +1,12 @@
 # Skill Plugin
 
-skill 是你拥有的技能。用户的提出的需求和任务，你都需要先考虑利用相关的skill来高质量的完成。
+Skills are capabilities available to you. For every user request or task, first consider whether a relevant skill can help you complete it with higher quality.
 
+## Usage
 
-## 使用
+Before using a skill, load its content through the `skill` plugin's `lookup` action.
 
-使用技能时需要首先通过 `skill` plugin 的 `lookup` action 载入对应的技能内容。
-
-如果当前工具集中存在 `plugin_call`，使用：
+If `plugin_call` is available, use:
 
 ```ts
 plugin_call({
@@ -19,4 +18,4 @@ plugin_call({
 });
 ```
 
-可用 action 包括 `list`、`find`、`install`、`lookup`。
+Available actions include `list`, `find`, `install`, and `lookup`.

package/src/skill/Plugin.ts

@@ -108,7 +108,7 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
     },
     actions: {
       [SKILL_PLUGIN_ACTIONS.find]: createAction({
-        description: "查找 `list` 中不存在的未学会 skills（缺失时再 install）",
+        description: "Find unlearned skills that are not in `list`; install only if missing.",
         input_schema: {
           zod: z.object({
             query: z.string(),
@@ -117,18 +117,18 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
             type: "object",
             required: ["query"],
             properties: {
-              query: { type: "string", description: "Skill 查询词" },
+              query: { type: "string", description: "Skill search query." },
             },
           },
         },
         examples: [
           {
-            title: "查找 skill",
+            title: "Find skill",
             payload: { query: "web-search" },
           },
         ],
         command: {
-          description: "查找 `list` 中不存在的未学会 skills（缺失时再 install）",
+          description: "Find unlearned skills that are not in `list`; install only if missing.",
           configure(command) {
             command.argument("<query>");
           },
@@ -151,7 +151,7 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
               success: true,
               data: {
                 query: payload.query,
-                message: "该技能已在 list 中，无需 install。使用前请先执行 lookup。",
+                message: "This skill is already in list; installation is not needed. Run lookup before using it.",
                 workflow: ["list", "lookup"],
                 nextAction: "lookup",
                 learnedSkill: exactLearned,
@@ -171,7 +171,7 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
             success: true,
             data: {
               query: payload.query,
-              message: "已执行缺失技能检索；若目标不在 list 中，可 install 后再 lookup。",
+              message: "Missing-skill search completed. If the target is not in list, install it and then run lookup.",
               workflow: ["find", "install", "lookup"],
               nextAction: "install",
               learnedSkill: null,
@@ -181,7 +181,7 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
         },
       }),
       [SKILL_PLUGIN_ACTIONS.install]: createAction({
-        description: "安装 `list` 中不存在的 skill（完成后请先 lookup）",
+        description: "Install a skill that is not in `list`; run lookup after installation.",
         input_schema: {
           zod: z.object({
             spec: z.string(),
@@ -193,21 +193,21 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
             type: "object",
             required: ["spec"],
             properties: {
-              spec: { type: "string", description: "Skill 安装 spec" },
-              global: { type: "boolean", description: "是否全局安装" },
-              yes: { type: "boolean", description: "跳过确认" },
-              agent: { type: "string", description: "指定 agent" },
+              spec: { type: "string", description: "Skill installation spec." },
+              global: { type: "boolean", description: "Whether to install globally." },
+              yes: { type: "boolean", description: "Skip confirmation." },
+              agent: { type: "string", description: "Target agent." },
             },
           },
         },
         examples: [
           {
-            title: "安装 skill",
+            title: "Install skill",
             payload: { spec: "web-search", global: true, yes: true },
           },
         ],
         command: {
-          description: "安装 `list` 中不存在的 skill（完成后请先 lookup）",
+          description: "Install a skill that is not in `list`; run lookup after installation.",
           configure(command) {
             command
               .argument("<spec>")
@@ -242,7 +242,7 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
               data: {
                 spec: payload.spec,
                 skipped: true,
-                message: "技能已在 list 中，无需 install。使用前请先执行 lookup。",
+                message: "The skill is already in list; installation is not needed. Run lookup before using it.",
                 workflow: ["list", "lookup"],
                 nextAction: "lookup",
                 queryFromSpec,
@@ -268,7 +268,7 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
             success: true,
             data: {
               spec: payload.spec,
-              message: "技能学习完成。使用技能前请先执行 lookup 读取该技能的 SKILL.md 内容。",
+              message: "Skill learning completed. Before using the skill, run lookup to read its SKILL.md content.",
               workflow: ["find", "install", "lookup"],
               nextAction: "lookup",
               skipped: false,
@@ -280,7 +280,7 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
         },
       }),
       [SKILL_PLUGIN_ACTIONS.list]: createAction({
-        description: "列出当前已学会（本地可发现）的 skills",
+        description: "List currently learned skills discoverable locally.",
         input_schema: {
           zod: z.object({}).passthrough(),
           json_schema: {
@@ -290,12 +290,12 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
         },
         examples: [
           {
-            title: "列出 skills",
+            title: "List skills",
             payload: {},
           },
         ],
         command: {
-          description: "列出当前已学会（本地可发现）的 skills",
+          description: "List currently learned skills discoverable locally.",
           mapInput() {
             return {};
           },
@@ -311,7 +311,7 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
         },
       }),
       [SKILL_PLUGIN_ACTIONS.lookup]: createAction({
-        description: "读取已学会 skill 内容（SKILL.md）",
+        description: "Read learned skill content (SKILL.md).",
         input_schema: {
           zod: z.object({
             name: z.string(),
@@ -320,18 +320,18 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
             type: "object",
             required: ["name"],
             properties: {
-              name: { type: "string", description: "Skill 名称" },
+              name: { type: "string", description: "Skill name." },
             },
           },
         },
         examples: [
           {
-            title: "读取 skill",
+            title: "Read skill",
             payload: { name: "web-search" },
           },
         ],
         command: {
-          description: "读取已学会 skill 内容（SKILL.md）",
+          description: "Read learned skill content (SKILL.md).",
           configure(command) {
             command.argument("<name>");
           },
@@ -384,7 +384,7 @@ function createSkillPluginDefinition(options: SkillPluginOptions): Plugin {
             data: {
               success: true,
               ...(result.skill ? { skill: result.skill } : {}),
-              message: "技能内容已准备，下一步将以 `<skill>...</skill>` user message 注入。",
+              message: "Skill content is ready. Next it will be injected as a `<skill>...</skill>` user message.",
               __ship: {
                 injectUserMessages: [
                   {

package/src/task/Action.ts

@@ -396,7 +396,7 @@ export async function runTaskDefinition(params: {
       success: true,
       accepted: true,
       // 关键点（中文）：这里直接返回给 agent 作为 tool result，提醒它这是异步任务，无需等待完成即可继续后续流程。
-      message: "任务已经开始执行，完成后 task 会自动发送给用户。请直接继续后续流程，无需等待 task 完成。",
+      message: "The task has started. When it finishes, the task runtime will send the result to the user automatically. Continue the current flow without waiting for the task to complete.",
       executionId,
       title,
     };