oh-pi 0.1.51 → 0.1.53

package/dist/bin/oh-pi.js

@@ -1,4 +1,8 @@
 #!/usr/bin/env node
+/**
+ * @module oh-pi CLI 入口脚本
+ * 处理 Windows 终端 UTF-8 编码，然后启动主流程。
+ */
 import { execSync } from "node:child_process";
 // Windows terminals default to non-UTF-8 codepage (e.g. GBK/CP936),
 // causing garbled emoji and Unicode output. Force UTF-8 before any output.

package/dist/tui/agents-select.d.ts

@@ -1 +1,9 @@
+/**
+ * Presents an interactive prompt for the user to select an agent template
+ * (e.g. general developer, fullstack, security, data/AI, colony operator).
+ *
+ * Exits the process if the user cancels the selection.
+ *
+ * @returns The selected agent template identifier string.
+ */
 export declare function selectAgents(): Promise<string>;

package/dist/tui/agents-select.js

@@ -1,5 +1,13 @@
 import * as p from "@clack/prompts";
 import { t } from "../i18n.js";
+/**
+ * Presents an interactive prompt for the user to select an agent template
+ * (e.g. general developer, fullstack, security, data/AI, colony operator).
+ *
+ * Exits the process if the user cancels the selection.
+ *
+ * @returns The selected agent template identifier string.
+ */
 export async function selectAgents() {
     const agent = await p.select({
         message: t("agent.select"),

package/dist/tui/confirm-apply.d.ts

@@ -1,3 +1,8 @@
 import type { OhPConfig } from "../types.js";
 import type { EnvInfo } from "../utils/detect.js";
+/**
+ * 展示配置摘要，处理已有配置的备份/覆盖，安装 pi（如需），并应用最终配置。
+ * @param config - 用户选择的配置对象
+ * @param env - 当前环境信息
+ */
 export declare function confirmApply(config: OhPConfig, env: EnvInfo): Promise<void>;

package/dist/tui/confirm-apply.js

@@ -2,9 +2,20 @@ import * as p from "@clack/prompts";
 import chalk from "chalk";
 import { t } from "../i18n.js";
 import { applyConfig, installPi, backupConfig } from "../utils/install.js";
+/**
+ * 统计已有配置中指定目录下的文件数量。
+ * @param env - 环境信息
+ * @param dir - 目录名称前缀
+ * @returns 匹配的文件数
+ */
 function countExisting(env, dir) {
     return env.existingFiles.filter(f => f.startsWith(dir + "/")).length;
 }
+/**
+ * 展示配置摘要，处理已有配置的备份/覆盖，安装 pi（如需），并应用最终配置。
+ * @param config - 用户选择的配置对象
+ * @param env - 当前环境信息
+ */
 export async function confirmApply(config, env) {
     // ═══ Summary ═══
     const summary = [

package/dist/tui/extension-select.d.ts

@@ -1 +1,6 @@
+/**
+ * Prompts the user to select enabled extensions from the available list via a multi-select TUI prompt.
+ * Exits the process if the user cancels the selection.
+ * @returns A promise that resolves to an array of selected extension names.
+ */
 export declare function selectExtensions(): Promise<string[]>;

package/dist/tui/extension-select.js

@@ -1,6 +1,11 @@
 import * as p from "@clack/prompts";
 import { t } from "../i18n.js";
 import { EXTENSIONS } from "../types.js";
+/**
+ * Prompts the user to select enabled extensions from the available list via a multi-select TUI prompt.
+ * Exits the process if the user cancels the selection.
+ * @returns A promise that resolves to an array of selected extension names.
+ */
 export async function selectExtensions() {
     const exts = await p.multiselect({
         message: t("ext.select"),

package/dist/tui/keybinding-select.d.ts

@@ -1 +1,8 @@
+/**
+ * Prompts the user to select a keybinding scheme (default, Vim, or Emacs).
+ *
+ * Displays an interactive select prompt and exits the process if the user cancels.
+ *
+ * @returns The name of the selected keybinding scheme.
+ */
 export declare function selectKeybindings(): Promise<string>;

package/dist/tui/keybinding-select.js

@@ -1,5 +1,12 @@
 import * as p from "@clack/prompts";
 import { t } from "../i18n.js";
+/**
+ * Prompts the user to select a keybinding scheme (default, Vim, or Emacs).
+ *
+ * Displays an interactive select prompt and exits the process if the user cancels.
+ *
+ * @returns The name of the selected keybinding scheme.
+ */
 export async function selectKeybindings() {
     const kb = await p.select({
         message: t("kb.select"),

package/dist/tui/mode-select.d.ts

@@ -1,3 +1,8 @@
 import type { EnvInfo } from "../utils/detect.js";
 export type Mode = "quick" | "custom" | "preset";
+/**
+ * Prompt the user to select a configuration mode: quick, preset, or custom.
+ * @param {EnvInfo} env - Detected environment information
+ * @returns {Promise<Mode>} The mode selected by the user
+ */
 export declare function selectMode(env: EnvInfo): Promise<Mode>;

package/dist/tui/mode-select.js

@@ -1,5 +1,10 @@
 import * as p from "@clack/prompts";
 import { t } from "../i18n.js";
+/**
+ * Prompt the user to select a configuration mode: quick, preset, or custom.
+ * @param {EnvInfo} env - Detected environment information
+ * @returns {Promise<Mode>} The mode selected by the user
+ */
 export async function selectMode(env) {
     const mode = await p.select({
         message: t("mode.select"),

package/dist/tui/preset-select.d.ts

@@ -1,5 +1,10 @@
 import type { OhPConfig } from "../types.js";
 interface Preset extends Omit<OhPConfig, "providers"> {
 }
+/**
+ * Prompts the user to select a configuration preset via an interactive TUI menu.
+ * Exits the process if the user cancels the selection.
+ * @returns The {@link Preset} configuration object for the chosen preset.
+ */
 export declare function selectPreset(): Promise<Preset>;
 export {};

package/dist/tui/preset-select.js

@@ -1,5 +1,9 @@
 import * as p from "@clack/prompts";
 import { t } from "../i18n.js";
+/**
+ * Registry of built-in configuration presets (Full Power / Clean / Colony).
+ * Each entry maps a preset key to its i18n label/hint keys and a full {@link Preset} config object.
+ */
 const PRESETS = {
     full: {
         labelKey: "preset.full", hintKey: "preset.fullHint",
@@ -27,6 +31,11 @@ const PRESETS = {
         },
     },
 };
+/**
+ * Prompts the user to select a configuration preset via an interactive TUI menu.
+ * Exits the process if the user cancels the selection.
+ * @returns The {@link Preset} configuration object for the chosen preset.
+ */
 export async function selectPreset() {
     const key = await p.select({
         message: t("preset.select"),

package/dist/tui/provider-setup.d.ts

@@ -1,3 +1,8 @@
 import { type ProviderConfig } from "../types.js";
 import type { EnvInfo } from "../utils/detect.js";
+/**
+ * Interactively configure API providers, detecting existing keys, allowing multi-select, and supporting custom endpoints.
+ * @param env - Current environment info with detected providers
+ * @returns Configured provider list
+ */
 export declare function setupProviders(env?: EnvInfo): Promise<ProviderConfig[]>;

package/dist/tui/provider-setup.js

@@ -12,7 +12,13 @@ const PROVIDER_API_URLS = {
     xai: "https://api.x.ai",
     mistral: "https://api.mistral.ai",
 };
-/** Fetch models dynamically — tries multiple API styles, returns metadata + detected API type */
+/**
+ * 动态获取模型列表，依次尝试 Anthropic、Google、OpenAI 兼容 API 风格。
+ * @param provider - 提供商名称
+ * @param baseUrl - API 基础地址
+ * @param apiKey - API 密钥或环境变量名
+ * @returns 发现的模型列表及检测到的 API 类型
+ */
 async function fetchModels(provider, baseUrl, apiKey) {
     const base = baseUrl.replace(/\/+$/, "");
     const resolvedKey = process.env[apiKey] ?? apiKey;
@@ -91,6 +97,11 @@ async function fetchModels(provider, baseUrl, apiKey) {
     catch { /* fall through */ }
     return { models: [] };
 }
+/**
+ * Interactively configure API providers, detecting existing keys, allowing multi-select, and supporting custom endpoints.
+ * @param env - Current environment info with detected providers
+ * @returns Configured provider list
+ */
 export async function setupProviders(env) {
     const entries = Object.entries(PROVIDERS);
     // Detect existing providers — offer skip or add new
@@ -175,6 +186,10 @@ export async function setupProviders(env) {
     }
     return configs;
 }
+/**
+ * Interactively configure a custom provider (Ollama, vLLM, or other OpenAI-compatible endpoints).
+ * @returns Custom provider config, or null if cancelled
+ */
 async function setupCustomProvider() {
     const name = await p.text({
         message: t("provider.name"),
@@ -207,6 +222,15 @@ async function setupCustomProvider() {
     p.log.success(t("provider.customConfigured", { name, url: baseUrl }));
     return { name, apiKey, defaultModel, baseUrl, api, discoveredModels };
 }
+/**
+ * Select a default model by dynamically fetching available models, falling back to a static list or manual input.
+ * @param provider - Provider name
+ * @param label - Provider display label
+ * @param staticModels - Static model list fallback
+ * @param baseUrl - API base URL
+ * @param apiKey - API key
+ * @returns Selected model and discovered model metadata
+ */
 async function selectModelWithMeta(provider, label, staticModels, baseUrl, apiKey) {
     let modelIds = staticModels;
     let discoveredModels;
@@ -246,6 +270,11 @@ async function selectModelWithMeta(provider, label, staticModels, baseUrl, apiKe
     }
     return { defaultModel: model, discoveredModels, api };
 }
+/**
+ * Prompt the user to enter an API key.
+ * @param label - Provider display label
+ * @returns The entered API key
+ */
 async function promptKey(label) {
     const key = await p.password({
         message: t("provider.apiKey", { label }),

package/dist/tui/theme-select.d.ts

@@ -1 +1,6 @@
+/**
+ * Prompts the user to select a theme from the available themes list.
+ * Exits the process if the user cancels the selection.
+ * @returns The name of the selected theme.
+ */
 export declare function selectTheme(): Promise<string>;

package/dist/tui/theme-select.js

@@ -1,6 +1,11 @@
 import * as p from "@clack/prompts";
 import { t } from "../i18n.js";
 import { THEMES } from "../types.js";
+/**
+ * Prompts the user to select a theme from the available themes list.
+ * Exits the process if the user cancels the selection.
+ * @returns The name of the selected theme.
+ */
 export async function selectTheme() {
     const theme = await p.select({
         message: t("theme.select"),

package/dist/tui/welcome.d.ts

@@ -1,2 +1,6 @@
 import type { EnvInfo } from "../utils/detect.js";
+/**
+ * 展示欢迎界面，显示 pi 安装状态、环境信息及已有配置概况。
+ * @param {EnvInfo} env - 当前检测到的环境信息
+ */
 export declare function welcome(env: EnvInfo): void;

package/dist/tui/welcome.js

@@ -1,6 +1,10 @@
 import * as p from "@clack/prompts";
 import chalk from "chalk";
 import { t } from "../i18n.js";
+/**
+ * 展示欢迎界面，显示 pi 安装状态、环境信息及已有配置概况。
+ * @param {EnvInfo} env - 当前检测到的环境信息
+ */
 export function welcome(env) {
     console.clear();
     p.intro(chalk.cyan.bold(" oh-pi ") + chalk.dim(t("welcome.title")));
@@ -19,6 +23,11 @@ export function welcome(env) {
             categorize(env.existingFiles), t("welcome.existingConfig"));
     }
 }
+/**
+ * 按顶层目录分类统计文件数量，返回格式化字符串。
+ * @param {string[]} files - 文件相对路径列表
+ * @returns {string} 分类统计字符串，如 "extensions (3)  prompts (5)"
+ */
 function categorize(files) {
     const cats = {};
     for (const f of files) {

package/dist/utils/resources.d.ts

@@ -1,3 +1,4 @@
+/** 资源路径映射对象 */
 export declare const resources: {
     agent: (name: string) => string;
     extension: (name: string) => string;

package/dist/utils/resources.js

@@ -5,6 +5,7 @@ import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
 const RESOURCES = join(PKG_ROOT, "pi-package");
+/** 资源路径映射对象 */
 export const resources = {
     agent: (name) => join(RESOURCES, "agents", `${name}.md`),
     extension: (name) => join(RESOURCES, "extensions", name),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-pi",
-  "version": "0.1.51",
+  "version": "0.1.53",
   "description": "One-click setup for pi-coding-agent. Like oh-my-zsh for pi.",
   "type": "module",
   "bin": {

package/pi-package/agents/colony-operator.md

@@ -16,7 +16,7 @@ You command an autonomous ant colony. Complex tasks are delegated to the swarm,
 
 ## Workflow
 1. Assess task scope
-2. If colony-worthy → use `/colony <goal>` command with clear goal
+2. If colony-worthy → use `ant_colony` tool with clear goal
 3. If simple → do it directly
 4. Review colony output, fix gaps manually if needed
 

package/pi-package/extensions/ant-colony/README.md

@@ -36,16 +36,15 @@
 
 ## 使用方式
 
-### 作为 Tool（LLM 自动调用）
+### 使用方式
 
-LLM 会在判断任务复杂度足够时自动调用 `ant_colony` tool。
+LLM 在判断任务复杂度足够时会自动调用 `ant_colony` tool，无需手动触发。
 
 ### 命令
 
 ```
-/colony <目标描述>          启动蚁群
-/colony-status              查看最近蚁群状态
-Ctrl+Alt+A                  快捷启动
+/colony-stop                中止运行中的蚁群
+Ctrl+Shift+A                展开蚁群详情面板
 ```
 
 ### 示例
@@ -114,4 +113,4 @@ npx oh-pi  # 选择 Full Power 预设
 | `concurrency.ts` | 115 | 自适应并发：系统采样，探索/稳态双阶段调节 |
 | `spawner.ts` | 316 | 蚂蚁孵化：进程管理，prompt 构建，输出解析 |
 | `queen.ts` | 331 | 女王调度：生命周期，任务波次，多轮迭代 |
-| `index.ts` | 324 | 扩展入口：tool/command/shortcut 注册，TUI 渲染 |
+| `index.ts` | 324 | 扩展入口：tool/shortcut 注册，TUI 渲染 |

package/pi-package/extensions/ant-colony/concurrency.ts

@@ -67,7 +67,7 @@ export function adapt(config: ConcurrencyConfig, pendingTasks: number): Concurre
   // 不超过待处理任务数
   const taskCap = Math.min(pendingTasks, config.max);
 
-  if (samples.length < 3) {
+  if (samples.length < 2) {
     // 冷启动：直接给一半 max，快速利用并发
     next.current = Math.min(Math.ceil(config.max / 2), taskCap);
     return next;
@@ -111,5 +111,10 @@ export function adapt(config: ConcurrencyConfig, pendingTasks: number): Concurre
   }
   // 否则保持不变
 
+  // 429 recovery: restore to optimal when CPU is underutilized (e.g. after backoff)
+  if (latest.cpuLoad < 0.5 && next.current < config.optimal) {
+    next.current = config.optimal;
+  }
+
   return next;
 }

package/pi-package/extensions/ant-colony/index.ts

@@ -467,37 +467,163 @@ export default function antColonyExtension(pi: ExtensionAPI) {
     },
   });
 
-  // ═══ Command: /colony ═══
-  pi.registerCommand("colony", {
-    description: "Launch an ant colony with a goal",
+  // ═══ Tool: ant_colony ═══
+  pi.registerTool({
+    name: "ant_colony",
+    label: "Ant Colony",
+    description: [
+      "Launch an autonomous ant colony in the BACKGROUND to accomplish a complex goal.",
+      "The colony runs asynchronously — you can continue chatting while it works.",
+      "Results are automatically injected when the colony finishes.",
+      "Scouts explore the codebase, workers execute tasks in parallel, soldiers review quality.",
+      "Use for multi-file changes, large refactors, or complex features.",
+    ].join(" "),
     parameters: Type.Object({
       goal: Type.String({ description: "What the colony should accomplish" }),
+      maxAnts: Type.Optional(Type.Number({ description: "Max concurrent ants (default: auto-adapt)", minimum: 1, maximum: 8 })),
+      maxCost: Type.Optional(Type.Number({ description: "Max cost budget in USD (default: unlimited)", minimum: 0.01 })),
+      scoutModel: Type.Optional(Type.String({ description: "Model for scout ants (default: current session model)" })),
+      workerModel: Type.Optional(Type.String({ description: "Model for worker ants (default: current session model)" })),
+      soldierModel: Type.Optional(Type.String({ description: "Model for soldier ants (default: current session model)" })),
     }),
-    async handler(args, ctx) {
+
+    async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+      if (activeColony) {
+        return {
+          content: [{ type: "text", text: "A colony is already running in the background. Use /colony-stop to cancel it first." }],
+          isError: true,
+        };
+      }
+
       const currentModel = ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : null;
       if (!currentModel) {
-        ctx.ui.notify("No model available in current session", "error");
-        return;
+        return {
+          content: [{ type: "text", text: "Colony failed: no model available in current session" }],
+          isError: true,
+        };
       }
 
+      const modelOverrides: Record<string, string> = {};
+      if (params.scoutModel) modelOverrides.scout = params.scoutModel;
+      if (params.workerModel) modelOverrides.worker = params.workerModel;
+      if (params.soldierModel) modelOverrides.soldier = params.soldierModel;
+
       const colonyParams = {
-        goal: args.goal,
+        goal: params.goal,
+        maxAnts: params.maxAnts,
+        maxCost: params.maxCost,
         currentModel,
-        modelOverrides: {},
+        modelOverrides,
         cwd: ctx.cwd,
         modelRegistry: ctx.modelRegistry ?? undefined,
       };
 
+      // 非交互模式（print mode）：同步等待蚁群完成
       if (!ctx.hasUI) {
-        const result = await runSyncColony(colonyParams);
-        if (result.isError) {
-          ctx.ui.notify("Colony failed", "error");
-        }
-        return;
+        return await runSyncColony(colonyParams, _signal);
       }
 
+      // 交互模式：后台运行
       launchBackgroundColony(colonyParams);
-      ctx.ui.notify(`🐜 Colony launched: ${args.goal.slice(0, 50)}`, "success");
+
+      return {
+        content: [{ type: "text", text: `[COLONY_SIGNAL:LAUNCHED]\n🐜 Colony launched in background.\nGoal: ${params.goal}\n\nThe colony is now running autonomously. Results will be injected when it finishes.` }],
+      };
+    },
+
+    renderCall(args, theme) {
+      const goal = args.goal?.length > 70 ? args.goal.slice(0, 67) + "..." : args.goal;
+      let text = theme.fg("toolTitle", theme.bold("🐜 ant_colony"));
+      if (args.maxAnts) text += theme.fg("muted", ` ×${args.maxAnts}`);
+      if (args.maxCost) text += theme.fg("warning", ` $${args.maxCost}`);
+      text += "\n" + theme.fg("dim", `  ${goal || "..."}`);
+      return new Text(text, 0, 0);
+    },
+
+    renderResult(result, { expanded }, theme) {
+      const text = result.content?.find((c: any) => c.type === "text")?.text || "";
+      if (result.isError) {
+        return new Text(theme.fg("error", text), 0, 0);
+      }
+      const container = new Container();
+      container.addChild(new Text(
+        theme.fg("success", "✓ ") + theme.fg("toolTitle", theme.bold("Colony launched in background")),
+        0, 0,
+      ));
+      if (activeColony) {
+        container.addChild(new Text(theme.fg("dim", `  Goal: ${activeColony.goal.slice(0, 70)}`), 0, 0));
+        container.addChild(new Text(theme.fg("muted", `  Ctrl+Shift+A for details │ /colony-stop to cancel`), 0, 0));
+      }
+      return container;
+    },
+  });
+
+  // ═══ Helper: build status summary ═══
+
+  function buildStatusText(): string {
+    if (!activeColony) return "No colony is currently running.";
+    const c = activeColony;
+    const state = c.state;
+    const elapsed = state ? formatDuration(Date.now() - state.createdAt) : "0s";
+    const m = state?.metrics;
+    const tasks = state?.tasks || [];
+    const ants = state?.ants || [];
+    const streams = Array.from(c.antStreams.values());
+
+    const lines: string[] = [
+      `## 🐜 Colony Status`,
+      `**Goal:** ${c.goal}`,
+      `**Phase:** ${c.phase}`,
+      `**Duration:** ${elapsed}`,
+    ];
+
+    if (m) {
+      lines.push(`**Tasks:** ${m.tasksDone}/${m.tasksTotal} done, ${m.tasksFailed} failed`);
+      lines.push(`**Ants spawned:** ${m.antsSpawned} | **Active:** ${streams.length}`);
+      lines.push(`**Cost:** ${formatCost(m.totalCost)} | **Tokens:** ${formatTokens(m.totalTokens)}`);
+    }
+
+    if (tasks.length > 0) {
+      lines.push("", "### Tasks");
+      for (const t of tasks) {
+        const icon = t.status === "done" ? "✓" : t.status === "failed" ? "✗" : t.status === "active" ? "●" : "○";
+        const dur = t.finishedAt && t.startedAt ? ` (${formatDuration(t.finishedAt - t.startedAt)})` : "";
+        lines.push(`- ${icon} [${t.caste}] ${t.title}${dur}`);
+      }
+    }
+
+    if (streams.length > 0) {
+      lines.push("", "### Active Ants");
+      for (const s of streams) {
+        lines.push(`- ${casteIcon(s.caste)} ${s.antId.slice(0, 14)} | ${s.tokens}tok | ${s.lastLine.slice(0, 60)}`);
+      }
+    }
+
+    return lines.join("\n");
+  }
+
+  // ═══ Tool: bg_colony_status ═══
+  pi.registerTool({
+    name: "bg_colony_status",
+    label: "Colony Status",
+    description: "Check the status of a running background ant colony. Use this instead of bg_status to monitor colony progress.",
+    parameters: Type.Object({}),
+    async execute() {
+      return {
+        content: [{ type: "text" as const, text: buildStatusText() }],
+      };
+    },
+  });
+
+  // ═══ Command: /colony-status ═══
+  pi.registerCommand("colony-status", {
+    description: "Show current colony progress",
+    async handler(_args, ctx) {
+      if (!activeColony) {
+        ctx.ui.notify("No colony is currently running.", "info");
+        return;
+      }
+      ctx.ui.notify(buildStatusText(), "info");
     },
   });
 

package/pi-package/extensions/ant-colony/nest.ts

@@ -226,8 +226,8 @@ export class Nest {
   // ═══ Internal ═══
 
   private withStateLock<T>(fn: () => T): T {
-    const MAX_WAIT = 5000;
-    const SPIN_MS = 15;
+    const MAX_WAIT = 3000;
+    const SPIN_MS = 1;
     const start = Date.now();
     while (true) {
       try {

package/pi-package/extensions/ant-colony/queen.ts

@@ -290,6 +290,9 @@ async function runAntWave(opts: WaveOptions): Promise<"ok"> {
  * 蚁后主循环
  */
 export async function runColony(opts: QueenOptions): Promise<ColonyState> {
+  if (!opts.goal || !opts.goal.trim()) {
+    throw new Error("Colony goal is empty or undefined. Please provide a clear goal.");
+  }
   const colonyId = makeColonyId();
   const nest = new Nest(opts.cwd, colonyId);
 
@@ -375,7 +378,6 @@ export async function runColony(opts: QueenOptions): Promise<ColonyState> {
       nest.updateState({ status: "failed", finishedAt: Date.now() });
       const finalState = nest.getState();
       callbacks.onComplete(finalState);
-      cleanup();
       return finalState;
     }
 
@@ -421,14 +423,14 @@ export async function runColony(opts: QueenOptions): Promise<ColonyState> {
     nest.updateState({ status: "done", finishedAt: Date.now(), metrics: finalMetrics });
     const finalState = nest.getState();
     callbacks.onComplete(finalState);
-    cleanup();
     return finalState;
 
   } catch (e) {
     nest.updateState({ status: "failed", finishedAt: Date.now() });
     const failState = nest.getState();
     callbacks.onComplete(failState);
-    cleanup();
     return failState;
+  } finally {
+    cleanup();
   }
 }

package/pi-package/extensions/ant-colony/spawner.ts

@@ -142,6 +142,9 @@ function buildPrompt(task: Task, pheromoneContext: string, castePrompt: string,
   if (task.files.length > 0) {
     prompt += `**Files scope:** ${task.files.join(", ")}\n`;
   }
+  if (/[\u4e00-\u9fff]/.test(task.description)) {
+    prompt += '\nIMPORTANT: Follow the language requirements specified in the task description. If the task says to write in Chinese, write in Chinese.\n';
+  }
   return prompt;
 }
 

package/pi-package/skills/ant-colony/SKILL.md

@@ -1,59 +0,0 @@
----
-name: ant-colony
-description: Ant colony multi-agent orchestration. Use when user needs parallel multi-file changes, large refactors, or complex features. Provides colony management commands and strategies.
----
-
-# Ant Colony Skill
-
-## When to Use
-- Multi-file changes (≥3 files)
-- Parallel workstreams
-- Large refactors, migrations
-- User says: colony, swarm, parallel, multi-agent
-
-## Quick Start
-```
-/colony <goal>
-```
-
-## Colony Lifecycle
-1. **Scout** — Explore codebase, identify targets, produce task pool
-2. **Work** — Workers execute in parallel, adaptive concurrency
-3. **Review** — Soldiers audit changes, request fixes if needed
-4. **Fix** — Workers address review findings
-5. **Done** — Summary report
-
-## Strategies
-
-### File-Scoped Decomposition (default)
-Each worker owns distinct files. Zero conflict.
-```
-Worker A: [src/auth.ts, src/auth.test.ts]
-Worker B: [src/api.ts, src/api.test.ts]
-```
-
-### Module-Scoped
-Each worker owns a module directory.
-```
-Worker A: src/components/
-Worker B: src/api/
-```
-
-### Pipeline
-Sequential handoff when dependencies exist.
-```
-Scout → Worker(schema) → Worker(api) → Worker(ui) → Soldier
-```
-
-## Tuning
-- `maxAnts`: Cap concurrent ants (default: auto-adapt to CPU)
-- Colony auto-reduces concurrency on 429 rate limits
-- Blocked tasks auto-resume when file locks release
-
-## Extending Castes
-Add custom ant types by editing `ant-colony/types.ts`:
-```typescript
-// In DEFAULT_ANT_CONFIGS, add:
-mycaste: { caste: "mycaste", model: "...", tools: [...], maxTurns: 10 }
-```
-Then add matching prompt in `spawner.ts` CASTE_PROMPTS.