@downcity/plugins 1.0.51 → 1.0.56

package/src/image/ImagePlugin.ts

@@ -0,0 +1,250 @@
+/**
+ * ImagePlugin：图片生成插件。
+ *
+ * 关键点（中文）
+ * - 对 Agent 只暴露同步体验的 `generate` action。
+ * - City / provider 的图片能力通过 image_create / image_result 任务函数注入。
+ * - action 返回 AI SDK UIMessage，后续由 plugin tool bridge 抽取 file parts 写回 assistant 消息。
+ */
+
+import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type {
+  JsonObject,
+  JsonValue,
+} from "@downcity/agent/internal/types/common/Json.js";
+import type {
+  ImagePluginInput,
+  ImagePluginJobCreateResult,
+  ImagePluginJobResult,
+  ImagePluginOptions,
+  ImagePluginResult,
+} from "@/image/types/ImagePlugin.js";
+
+const DEFAULT_IMAGE_PLUGIN_NAME = "image";
+const DEFAULT_IMAGE_PLUGIN_TITLE = "Image";
+const DEFAULT_IMAGE_PLUGIN_DESCRIPTION =
+  "Generate images and return them as assistant file parts.";
+const DEFAULT_TIMEOUT_MS = 300_000;
+const DEFAULT_MIN_POLL_INTERVAL_MS = 100;
+const DEFAULT_MAX_POLL_INTERVAL_MS = 10_000;
+
+/**
+ * 判断值是否为普通对象。
+ */
+function to_record(value: unknown): Record<string, unknown> | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value as Record<string, unknown>;
+}
+
+/**
+ * 归一化模型传入的图片生成 payload。
+ */
+function normalize_image_payload(
+  payload: JsonValue | undefined,
+): ImagePluginInput {
+  const record = to_record(payload ?? {});
+  if (!record) {
+    throw new TypeError("ImagePlugin.generate payload must be an object");
+  }
+  return { ...record } as ImagePluginInput;
+}
+
+/**
+ * 校验 image 函数返回的 UIMessage。
+ */
+function normalize_image_result(result: ImagePluginResult): ImagePluginResult {
+  const record = to_record(result);
+  if (!record || !Array.isArray(record.parts)) {
+    throw new TypeError("ImagePlugin image provider must return an AI SDK UIMessage");
+  }
+  return result;
+}
+
+/**
+ * 等待指定毫秒数。
+ */
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/**
+ * 限制轮询间隔，避免服务端异常值导致过快或过慢轮询。
+ */
+function clamp_poll_interval(
+  value: unknown,
+  min_ms: number,
+  max_ms: number,
+): number {
+  const n = typeof value === "number" && Number.isFinite(value) ? value : min_ms;
+  return Math.max(min_ms, Math.min(max_ms, n));
+}
+
+/**
+ * 归一化正数配置。
+ */
+function normalize_positive_number(value: unknown, fallback: number): number {
+  return typeof value === "number" && Number.isFinite(value) && value > 0
+    ? value
+    : fallback;
+}
+
+/**
+ * 校验任务创建结果。
+ */
+function validate_created_job(value: ImagePluginJobCreateResult): void {
+  if (
+    !value ||
+    typeof value !== "object" ||
+    typeof value.job_id !== "string" ||
+    !value.job_id.trim()
+  ) {
+    throw new TypeError("ImagePlugin image_create must return a job_id");
+  }
+}
+
+/**
+ * 校验任务查询结果。
+ */
+function validate_job_result(value: ImagePluginJobResult): void {
+  const status = value?.status;
+  if (
+    status !== "queued" &&
+    status !== "running" &&
+    status !== "succeeded" &&
+    status !== "failed"
+  ) {
+    throw new TypeError("ImagePlugin image_result must return a valid job status");
+  }
+}
+
+/**
+ * Agent 图片生成插件。
+ */
+export class ImagePlugin extends BasePlugin {
+  /**
+   * 当前 plugin 稳定名称。
+   */
+  readonly name: string;
+
+  /**
+   * 插件标题。
+   */
+  readonly title: string;
+
+  /**
+   * 插件说明。
+   */
+  readonly description: string;
+
+  private readonly image_create: NonNullable<ImagePluginOptions["image_create"]>;
+  private readonly image_result: NonNullable<ImagePluginOptions["image_result"]>;
+  private readonly timeout_ms: number;
+  private readonly min_poll_interval_ms: number;
+  private readonly max_poll_interval_ms: number;
+
+  constructor(options: ImagePluginOptions) {
+    super();
+    const name = String(options.name || DEFAULT_IMAGE_PLUGIN_NAME).trim();
+    if (!name) {
+      throw new Error("ImagePlugin requires a non-empty name");
+    }
+    if (typeof options.image_create !== "function") {
+      throw new Error("ImagePlugin requires an image_create function");
+    }
+    if (typeof options.image_result !== "function") {
+      throw new Error("ImagePlugin requires an image_result function");
+    }
+    this.name = name;
+    this.title = String(options.title || DEFAULT_IMAGE_PLUGIN_TITLE).trim();
+    this.description = String(
+      options.description || DEFAULT_IMAGE_PLUGIN_DESCRIPTION,
+    ).trim();
+    this.image_create = options.image_create;
+    this.image_result = options.image_result;
+    this.timeout_ms = normalize_positive_number(
+      options.timeout_ms,
+      DEFAULT_TIMEOUT_MS,
+    );
+    this.min_poll_interval_ms = normalize_positive_number(
+      options.min_poll_interval_ms,
+      DEFAULT_MIN_POLL_INTERVAL_MS,
+    );
+    this.max_poll_interval_ms = normalize_positive_number(
+      options.max_poll_interval_ms,
+      DEFAULT_MAX_POLL_INTERVAL_MS,
+    );
+  }
+
+  /**
+   * 图片插件给模型的最小使用说明。
+   */
+  system(_context: AgentContext): string {
+    return [
+      "Image generation is available through the plugin_call tool.",
+      `Call plugin "${this.name}" action "generate" when the user asks to create, render, draw, or edit an image.`,
+      "Pass a JSON payload with prompt, optional size/aspect_ratio/quality/n, and optional provider_options.",
+      "The generated image files will be attached to the final assistant message automatically.",
+    ].join("\n");
+  }
+
+  private async generate_image(
+    input: ImagePluginInput,
+  ): Promise<ImagePluginResult> {
+    const created = await this.image_create(input);
+    validate_created_job(created);
+    const deadline = Date.now() + this.timeout_ms;
+    let poll_after_ms = created.poll_after_ms;
+
+    while (Date.now() < deadline) {
+      await sleep(
+        clamp_poll_interval(
+          poll_after_ms,
+          this.min_poll_interval_ms,
+          this.max_poll_interval_ms,
+        ),
+      );
+      const current = await this.image_result({ job_id: created.job_id });
+      validate_job_result(current);
+      poll_after_ms = current.poll_after_ms;
+      if (current.status === "succeeded") {
+        if (!current.result) {
+          throw new Error(`Image job ${created.job_id} succeeded without result`);
+        }
+        return normalize_image_result(current.result);
+      }
+      if (current.status === "failed") {
+        throw new Error(
+          `Image job failed: ${current.error ?? current.message ?? created.job_id}`,
+        );
+      }
+    }
+
+    throw new Error(`Image job timed out: ${created.job_id}`);
+  }
+
+  /**
+   * 显式 action 集合。
+   */
+  readonly actions = {
+    generate: {
+      execute: async ({ payload }: { payload: JsonValue }) => {
+        try {
+          const input = normalize_image_payload(payload);
+          const message = await this.generate_image(input);
+          return {
+            success: true,
+            data: message as unknown as JsonObject,
+            message: "image generated",
+          };
+        } catch (error) {
+          return {
+            success: false,
+            error: String(error),
+            message: String(error),
+          };
+        }
+      },
+    },
+  };
+}

package/src/image/types/ImagePlugin.ts

@@ -0,0 +1,157 @@
+/**
+ * ImagePlugin 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里仅定义图片 plugin 对图片能力的最低层协议，不绑定 city 或任意上游 provider。
+ * - 图片生成结果使用 AI SDK UIMessage，保证 session 落盘格式与现有消息系统一致。
+ * - 字段保持 JSON 可序列化，便于通过 plugin action 与 tool bridge 传递。
+ */
+
+import type { UIMessage } from "ai";
+import type {
+  JsonObject,
+  JsonValue,
+} from "@downcity/agent/internal/types/common/Json.js";
+
+/**
+ * 图片生成文本内容片段。
+ */
+export interface ImagePluginTextContent {
+  /** 内容类型，固定为文本。 */
+  type: "text";
+  /** 生图提示词或上下文文本。 */
+  text: string;
+}
+
+/**
+ * 图片生成参考图片内容片段。
+ */
+export interface ImagePluginFileContent {
+  /** 内容类型，固定为图片。 */
+  type: "image";
+  /** 远程图片 URL。 */
+  url?: string;
+  /** data URL 图片内容。 */
+  data_url?: string;
+  /** 图片 MIME 类型，例如 `image/png`。 */
+  media_type?: string;
+}
+
+/**
+ * 图片生成多模态内容片段。
+ */
+export type ImagePluginContent =
+  | ImagePluginTextContent
+  | ImagePluginFileContent;
+
+/**
+ * 图片生成上下文消息。
+ */
+export interface ImagePluginMessage {
+  /** 消息角色。 */
+  role: "system" | "user" | "assistant";
+  /** 该消息内的文本与图片内容。 */
+  content: ImagePluginContent[];
+}
+
+/**
+ * ImagePlugin 调用输入。
+ */
+export interface ImagePluginInput {
+  /** 图片模型引用。 */
+  model?: string;
+  /** 单句快捷提示词。 */
+  prompt?: string;
+  /** 多轮或多模态图片生成上下文。 */
+  messages?: ImagePluginMessage[];
+  /** 生成图片数量。 */
+  n?: number;
+  /** 生成图片数量，兼容部分上游使用的 count 命名。 */
+  count?: number;
+  /** 图片尺寸，例如 `1024x1024`。 */
+  size?: string;
+  /** 图片宽高比，例如 `1:1`。 */
+  aspect_ratio?: string;
+  /** 图片宽高比，兼容部分上游使用的 ratio 命名。 */
+  ratio?: string;
+  /** 图片质量，例如 `standard`、`hd`、`ultra`、`4k`。 */
+  quality?: string;
+  /** 随机种子。 */
+  seed?: number;
+  /** 业务侧任务 ID，用于 provider 侧幂等、追踪和恢复。 */
+  client_job_id?: string;
+  /** Provider 私有参数，例如 `{ openai: {...}, gemini: {...}, luchi: {...} }`。 */
+  provider_options?: JsonObject;
+  /** 允许外部 image 函数接收其他 JSON 可序列化参数。 */
+  [key: string]: JsonValue | ImagePluginMessage[] | undefined;
+}
+
+/**
+ * ImagePlugin 生成结果。
+ */
+export type ImagePluginResult = UIMessage;
+
+/**
+ * 图片生成任务状态。
+ */
+export type ImagePluginJobStatus =
+  | "queued"
+  | "running"
+  | "succeeded"
+  | "failed";
+
+/**
+ * 图片任务创建结果。
+ */
+export interface ImagePluginJobCreateResult {
+  /** 图片任务 ID。 */
+  job_id: string;
+  /** 创建后的任务状态。 */
+  status: ImagePluginJobStatus;
+  /** 建议下一次轮询的间隔毫秒数。 */
+  poll_after_ms?: number;
+}
+
+/**
+ * 图片任务查询结果。
+ */
+export interface ImagePluginJobResult {
+  /** 图片任务 ID。 */
+  job_id: string;
+  /** 当前任务状态。 */
+  status: ImagePluginJobStatus;
+  /** 成功时返回的 AI SDK UIMessage。 */
+  result?: ImagePluginResult;
+  /** 失败时返回的错误消息。 */
+  error?: string;
+  /** 当前任务状态说明。 */
+  message?: string;
+  /** 建议下一次轮询的间隔毫秒数。 */
+  poll_after_ms?: number;
+}
+
+/**
+ * ImagePlugin 构造参数。
+ */
+export interface ImagePluginOptions {
+  /** Plugin 稳定名称，默认 `image`。 */
+  name?: string;
+  /** Plugin 展示标题，默认 `Image`。 */
+  title?: string;
+  /** Plugin 用途说明。 */
+  description?: string;
+  /** 创建图片生成任务，通常传入 `(input) => city.ai.image_create(input)`。 */
+  image_create?: (
+    input: ImagePluginInput,
+  ) => Promise<ImagePluginJobCreateResult> | ImagePluginJobCreateResult;
+  /** 查询图片生成任务，通常传入 `(input) => city.ai.image_result(input)`。 */
+  image_result?: (input: {
+    job_id: string;
+  }) => Promise<ImagePluginJobResult> | ImagePluginJobResult;
+  /** 图片任务最大等待时间，默认 300000ms。 */
+  timeout_ms?: number;
+  /** 轮询间隔下限，默认 100ms。 */
+  min_poll_interval_ms?: number;
+  /** 轮询间隔上限，默认 10000ms。 */
+  max_poll_interval_ms?: number;
+}

package/src/index.ts

@@ -13,6 +13,7 @@ export {
 } from "./BuiltinPlugins.js";
 export type { BuiltinPluginClass } from "./BuiltinPlugins.js";
 export { ChatPlugin } from "./chat/ChatPlugin.js";
+export { ImagePlugin } from "./image/ImagePlugin.js";
 export { ChatChannelAccountManager } from "./chat/accounts/ChannelAccountManager.js";
 export { ChatAuthorizationPlugin } from "./auth/Plugin.js";
 export { SkillPlugin } from "./skill/Plugin.js";
@@ -42,6 +43,18 @@ export type {
   ChatPluginQqOptions,
   ChatPluginTelegramOptions,
 } from "./chat/ChatPluginTypes.js";
+export type {
+  ImagePluginContent,
+  ImagePluginFileContent,
+  ImagePluginInput,
+  ImagePluginJobCreateResult,
+  ImagePluginJobResult,
+  ImagePluginJobStatus,
+  ImagePluginMessage,
+  ImagePluginOptions,
+  ImagePluginResult,
+  ImagePluginTextContent,
+} from "./image/types/ImagePlugin.js";
 export type {
   ChatAuthorizationCatalog,
   ChatAuthorizationChannel,

package/src/shell/ShellPlugin.ts

@@ -7,7 +7,6 @@
  * - ShellActionRuntime 只保留纯运行时流程，不再承载模块级单例状态。
  */
 
-import type { AgentRuntime } from "@downcity/agent/internal/types/runtime/agent/AgentRuntime.js";
 import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
 import type { PluginActions } from "@downcity/agent/internal/plugin/types/Plugin.js";
 import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
@@ -61,8 +60,8 @@ export class ShellPlugin extends BasePlugin {
    */
   public readonly sessions: Map<string, ShellSessionRuntimeState>;
 
-  constructor(agent: AgentRuntime | null) {
-    super(agent);
+  constructor() {
+    super();
     this.state = createShellPluginState();
     this.sessions = this.state.sessions;
     this.actions = {

package/src/skill/Action.ts

@@ -9,7 +9,6 @@
 import fs from "fs-extra";
 import path from "node:path";
 import { discoverClaudeSkillsSync } from "@/skill/runtime/Discovery.js";
-import { loadDowncityConfig } from "@downcity/agent/internal/config/Config.js";
 import type { ClaudeSkill } from "@/skill/types/ClaudeSkill.js";
 import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
 import type {
@@ -18,6 +17,7 @@ import type {
   SkillLookupResponse,
   SkillSummary,
 } from "@/skill/types/SkillCommand.js";
+import type { SkillPluginOptions } from "@/skill/types/SkillPlugin.js";
 
 function normalizeAllowedTools(input: JsonValue | undefined): string[] {
   if (!Array.isArray(input)) return [];
@@ -64,10 +64,12 @@ function findSkill(skills: ClaudeSkill[], name: string): ClaudeSkill | null {
   );
 }
 
-function getSkills(projectRoot: string): ClaudeSkill[] {
+function getSkills(
+  projectRoot: string,
+  options?: SkillPluginOptions | null,
+): ClaudeSkill[] {
   const root = path.resolve(projectRoot);
-  const config = loadDowncityConfig(root);
-  return discoverClaudeSkillsSync(root, config);
+  return discoverClaudeSkillsSync(root, options);
 }
 
 /**
@@ -76,8 +78,9 @@ function getSkills(projectRoot: string): ClaudeSkill[] {
 export function findLearnedSkillExact(
   projectRoot: string,
   query: string,
+  options?: SkillPluginOptions | null,
 ): SkillSummary | null {
-  const skills = getSkills(projectRoot);
+  const skills = getSkills(projectRoot, options);
   const target = findSkillExact(skills, query);
   return target ? toSkillSummary(target) : null;
 }
@@ -89,11 +92,12 @@ export function searchLearnedSkills(
   projectRoot: string,
   query: string,
   limit: number = 10,
+  options?: SkillPluginOptions | null,
 ): SkillSummary[] {
   const q = String(query || "").trim().toLowerCase();
   if (!q) return [];
 
-  const skills = getSkills(projectRoot);
+  const skills = getSkills(projectRoot, options);
   const matched = skills.filter((item) => {
     const id = item.id.toLowerCase();
     const name = item.name.toLowerCase();
@@ -107,8 +111,11 @@ export function searchLearnedSkills(
 /**
  * 列出当前项目下可发现的全部 skill。
  */
-export function listSkills(projectRoot: string): SkillListResponse {
-  const skills = getSkills(projectRoot).map(toSkillSummary);
+export function listSkills(
+  projectRoot: string,
+  options?: SkillPluginOptions | null,
+): SkillListResponse {
+  const skills = getSkills(projectRoot, options).map(toSkillSummary);
   return {
     success: true,
     skills,
@@ -127,9 +134,13 @@ export async function lookupSkill(params: {
    * skill lookup 请求。
    */
   request: SkillLookupRequest;
+  /**
+   * SkillPlugin 构造参数。
+   */
+  options?: SkillPluginOptions | null;
 }): Promise<SkillLookupResponse> {
   const root = path.resolve(params.projectRoot);
-  const skills = getSkills(root);
+  const skills = getSkills(root, params.options);
   const target = findSkill(skills, params.request.name);
   if (!target) {
     return {

package/src/skill/Command.ts

@@ -3,15 +3,13 @@
  *
  * 设计目标（中文）
  * - 尽量不自建 registry：直接复用社区的 `npx skills` 生态（find/install）。
- * - 同时提供本地视角的 `list`：列出 Downcity 当前能发现的 skills（含 project/home）。
+ * - 同时提供本地视角的 `list`：按 SkillPlugin 默认构造参数列出当前项目 skills。
  */
 
 import path from "node:path";
-import fs from "fs-extra";
 import { execa } from "execa";
 import { discoverClaudeSkillsSync } from "@/skill/runtime/Discovery.js";
 import { getClaudeSkillSearchRoots } from "@/skill/runtime/Paths.js";
-import { loadDowncityConfig } from "@downcity/agent/internal/config/Config.js";
 
 async function runNpxSkills(args: string[], opts?: { yes?: boolean }): Promise<number> {
   const yes = opts?.yes !== false;
@@ -76,16 +74,8 @@ export async function skillInstallCommand(
  */
 export async function skillListCommand(cwd: string = "."): Promise<void> {
   const projectRoot = path.resolve(String(cwd || "."));
-  const shipJson = path.join(projectRoot, "downcity.json");
-  if (!fs.existsSync(shipJson)) {
-    throw new Error(
-      `downcity.json not found at ${shipJson}. Run "town agent create" first or pass the correct path.`,
-    );
-  }
-
-  const config = loadDowncityConfig(projectRoot);
-  const roots = getClaudeSkillSearchRoots(projectRoot, config);
-  const skills = discoverClaudeSkillsSync(projectRoot, config);
+  const roots = getClaudeSkillSearchRoots(projectRoot);
+  const skills = discoverClaudeSkillsSync(projectRoot);
 
   console.log("Skill roots:");
   for (const root of roots) console.log(`- [${root.source}] ${root.display}`);

package/src/skill/Config.ts

@@ -1,51 +1,58 @@
 /**
- * skill plugin 配置读取工具。
+ * SkillPlugin 构造参数归一化工具。
  *
  * 关键点（中文）
- * - skill 已迁到 plugin 体系，因此发现路径等配置统一从 `plugins.skill` 读取。
- * - 这里负责把原始 JSON 配置归一化成 runtime 可直接消费的稳定结构。
+ * - SkillPlugin 不再读取 `downcity.json.plugins.skill` 私有配置。
+ * - constructor options 是唯一行为配置入口，便于 SDK 用户直接理解。
+ * - 这里只做默认值与去重，不做文件系统扫描。
  */
 
-import type { DowncityConfig } from "@downcity/agent/internal/types/config/DowncityConfig.js";
 import type {
-  ResolvedSkillPluginConfig,
-  SkillPluginConfig,
+  ResolvedSkillPluginOptions,
+  SkillPluginOptions,
 } from "@/skill/types/SkillPlugin.js";
 
 /**
- * skill plugin 默认配置。
+ * skill plugin 默认构造参数。
  */
-export const DEFAULT_SKILL_PLUGIN_CONFIG: ResolvedSkillPluginConfig = {
-  paths: [".agents/skills"],
-  allowExternalPaths: false,
+export const DEFAULT_SKILL_PLUGIN_OPTIONS: ResolvedSkillPluginOptions = {
+  use: ["project"],
+  paths: [],
+  ignore: [],
 };
 
-/**
- * 读取并归一化 skill plugin 配置。
- */
-export function readSkillPluginConfig(
-  config?: DowncityConfig | null,
-): ResolvedSkillPluginConfig {
-  const raw = config?.plugins?.skill;
-  const skillConfig =
-    raw && typeof raw === "object" && !Array.isArray(raw)
-      ? (raw as SkillPluginConfig)
-      : null;
+function normalizeUse(
+  input: SkillPluginOptions["use"],
+): ResolvedSkillPluginOptions["use"] {
+  if (!Array.isArray(input)) return [...DEFAULT_SKILL_PLUGIN_OPTIONS.use];
+  const values: ResolvedSkillPluginOptions["use"] = [];
+  for (const item of input) {
+    if ((item === "project" || item === "home") && !values.includes(item)) {
+      values.push(item);
+    }
+  }
+  return values;
+}
 
-  const normalizedPaths = Array.isArray(skillConfig?.paths)
-    ? skillConfig.paths
-        .map((item) => String(item || "").trim())
-        .filter(Boolean)
-    : [];
+function normalizePaths(input: SkillPluginOptions["paths"]): string[] {
+  if (!Array.isArray(input)) return [...DEFAULT_SKILL_PLUGIN_OPTIONS.paths];
+  const values: string[] = [];
+  for (const item of input) {
+    const value = String(item || "").trim();
+    if (value && !values.includes(value)) values.push(value);
+  }
+  return values;
+}
 
+/**
+ * 读取并归一化 SkillPlugin 构造参数。
+ */
+export function resolveSkillPluginOptions(
+  options?: SkillPluginOptions | null,
+): ResolvedSkillPluginOptions {
   return {
-    paths:
-      normalizedPaths.length > 0
-        ? normalizedPaths
-        : [...DEFAULT_SKILL_PLUGIN_CONFIG.paths],
-    allowExternalPaths:
-      typeof skillConfig?.allowExternalPaths === "boolean"
-        ? skillConfig.allowExternalPaths
-        : DEFAULT_SKILL_PLUGIN_CONFIG.allowExternalPaths,
+    use: normalizeUse(options?.use),
+    paths: normalizePaths(options?.paths),
+    ignore: Array.isArray(options?.ignore) ? [...options.ignore] : [],
   };
 }

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使用技能时需要首先通过 `town skill lookup <name>` 命令载入对应的技能内容。\n\n你也可以使用 `town skill --help` 命令对skill进行其他操作。比如 `list`, `find`, `install`等等。\n";
+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";
 
 export default TEXT_MODULE_CONTENT;