@downcity/plugins 1.0.174 → 1.0.194

package/bin/skill/Command.js

@@ -1,14 +1,11 @@
 /**
- * `downcity skill` 命令 helper。
+ * Skill 安装命令 helper。
  *
  * 设计目标（中文）
- * - 尽量不自建 registry：直接复用社区的 `npx skills` 生态（find/install）。
- * - 同时提供本地视角的 `list`：按 SkillPlugin 默认构造参数列出当前项目 skills。
+ * - 不自建 registry，直接复用社区的 `npx skills` 安装生态。
+ * - 当前 helper 由需要准备 skill 依赖的其他 plugin 复用，不作为 SkillPlugin action 暴露。
  */
-import path from "node:path";
 import { execa } from "execa";
-import { discoverSkillsSync } from "../skill/runtime/Discovery.js";
-import { getSkillSearchRoots } from "../skill/runtime/Paths.js";
 async function runNpxSkills(args, opts) {
     const yes = opts?.yes !== false;
     const result = await execa("npx", [yes ? "-y" : "", "skills", ...args].filter(Boolean), {
@@ -16,15 +13,6 @@ async function runNpxSkills(args, opts) {
     });
     return result.exitCode ?? 0;
 }
-/**
- * 执行远程 skill 查找。
- */
-export async function skillFindCommand(query) {
-    const q = String(query || "").trim();
-    if (!q)
-        throw new Error("Missing query");
-    await runNpxSkills(["find", q], { yes: true });
-}
 /**
  * 安装指定 skill。
  */
@@ -44,20 +32,4 @@ export async function skillInstallCommand(spec, options = {}) {
         args.push("-g");
     await runNpxSkills(args, { yes });
 }
-/**
- * 输出当前项目的本地 skill 列表。
- */
-export async function skillListCommand(cwd = ".") {
-    const projectRoot = path.resolve(String(cwd || "."));
-    const roots = getSkillSearchRoots(projectRoot);
-    const skills = discoverSkillsSync(projectRoot);
-    console.log("Skill roots:");
-    for (const root of roots)
-        console.log(`- [${root.source}] ${root.display}`);
-    console.log(`\nFound: ${skills.length}`);
-    for (const skill of skills) {
-        const desc = skill.description ? ` — ${skill.description}` : "";
-        console.log(`- [${skill.source}] ${skill.id}: ${skill.name}${desc}`);
-    }
-}
 //# sourceMappingURL=Command.js.map

package/bin/skill/Command.js.map

@@ -1 +1 @@
-{"version":3,"file":"Command.js","sourceRoot":"","sources":["../../src/skill/Command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Command.js","sourceRoot":"","sources":["../../src/skill/Command.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,KAAK,UAAU,YAAY,CAAC,IAAc,EAAE,IAAwB;IAClE,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,KAAK,KAAK,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QACtF,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;AAC9B,CAAC;AAoBD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,UAA+B,EAAE;IAEjC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;IAExC,MAAM,IAAI,GAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC;IAClC,IAAI,GAAG;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEzB,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC;IAC/C,IAAI,aAAa;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnC,MAAM,YAAY,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/bin/skill/PROMPT.d.ts

@@ -2,6 +2,6 @@
  * 自动生成文件，请勿手改。
  * 源文件：由同路径 `*.ts.txt` 生成。
  */
-declare 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";
+declare 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 are `find`, `install`, `list`, and `lookup`.\n\n`find` and `install` are instruction-only actions. They return the Shell steps the agent should take, but never execute commands, access the network, install a skill, or change files themselves. The `install` instructions are generated from this SkillPlugin instance's configured scan roots.\n\nThe returned installation prompt tells the agent to call `list` after running the Shell command. This is workflow guidance, not code-level enforcement. If the installed skill appears in `list`, call `lookup` before using it.\n";
 export default TEXT_MODULE_CONTENT;
 //# sourceMappingURL=PROMPT.d.ts.map

package/bin/skill/PROMPT.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PROMPT.d.ts","sourceRoot":"","sources":["../../src/skill/PROMPT.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,QAAA,MAAM,mBAAmB,ygBAAygB,CAAC;AAEniB,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"PROMPT.d.ts","sourceRoot":"","sources":["../../src/skill/PROMPT.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,QAAA,MAAM,mBAAmB,ghCAAghC,CAAC;AAE1iC,eAAe,mBAAmB,CAAC"}

package/bin/skill/PROMPT.js

@@ -3,6 +3,6 @@
  * 源文件：由同路径 `*.ts.txt` 生成。
  */
 // Source: src/skill/PROMPT.ts.txt
-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";
+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 are `find`, `install`, `list`, and `lookup`.\n\n`find` and `install` are instruction-only actions. They return the Shell steps the agent should take, but never execute commands, access the network, install a skill, or change files themselves. The `install` instructions are generated from this SkillPlugin instance's configured scan roots.\n\nThe returned installation prompt tells the agent to call `list` after running the Shell command. This is workflow guidance, not code-level enforcement. If the installed skill appears in `list`, call `lookup` before using it.\n";
 export default TEXT_MODULE_CONTENT;
 //# sourceMappingURL=PROMPT.js.map

package/bin/skill/PROMPT.js.map

@@ -1 +1 @@
-{"version":3,"file":"PROMPT.js","sourceRoot":"","sources":["../../src/skill/PROMPT.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kCAAkC;AAClC,MAAM,mBAAmB,GAAG,sgBAAsgB,CAAC;AAEniB,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"PROMPT.js","sourceRoot":"","sources":["../../src/skill/PROMPT.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kCAAkC;AAClC,MAAM,mBAAmB,GAAG,6gCAA6gC,CAAC;AAE1iC,eAAe,mBAAmB,CAAC"}

package/bin/skill/Plugin.d.ts

@@ -3,13 +3,14 @@
  *
  * 关键点（中文）
  * - skill 不再作为 service 存在，而是作为显式 action + system 提供者接入 plugin 体系。
- * - `find/install/list/lookup` 全部通过 plugin actions 暴露。
+ * - `find/install` action 只返回 Shell 操作提示，不执行命令或修改文件。
+ * - `list/lookup` action 负责读取当前可发现的本地 skill。
  * - skills overview 文本通过 `plugin.system` 注入，不再依赖 plugin.system。
  */
 import { BasePlugin } from "@downcity/agent";
 import type { SkillPluginOptions } from "../skill/types/SkillPlugin.js";
 /**
- * SkillPlugin：技能发现、安装、读取与 system 注入。
+ * SkillPlugin：技能发现、读取与扫描感知的 system 注入。
  */
 export declare class SkillPlugin extends BasePlugin {
     readonly name = "skill";

package/bin/skill/Plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/skill/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C,OAAO,KAAK,EAIV,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AAkYtC;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC,QAAQ,CAAC,IAAI,WAAW;gBAEZ,OAAO,GAAE,kBAAuB;CAK7C"}
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/skill/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C,OAAO,KAAK,EAIV,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AAsRtC;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC,QAAQ,CAAC,IAAI,WAAW;gBAEZ,OAAO,GAAE,kBAAuB;CAK7C"}

package/bin/skill/Plugin.js

@@ -3,7 +3,8 @@
  *
  * 关键点（中文）
  * - skill 不再作为 service 存在，而是作为显式 action + system 提供者接入 plugin 体系。
- * - `find/install/list/lookup` 全部通过 plugin actions 暴露。
+ * - `find/install` action 只返回 Shell 操作提示，不执行命令或修改文件。
+ * - `list/lookup` action 负责读取当前可发现的本地 skill。
  * - skills overview 文本通过 `plugin.system` 注入，不再依赖 plugin.system。
  */
 import { BasePlugin } from "@downcity/agent";
@@ -11,9 +12,9 @@ import { createAction } from "@downcity/agent";
 import { z } from "zod";
 import { SKILL_PLUGIN_ACTIONS } from "../skill/types/SkillPlugin.js";
 import { resolveSkillPluginOptions } from "../skill/Config.js";
-import { skillFindCommand, skillInstallCommand } from "../skill/Command.js";
-import { findLearnedSkillExact, listSkills, lookupSkill, searchLearnedSkills, } from "../skill/Action.js";
+import { listSkills, lookupSkill, } from "../skill/Action.js";
 import { buildSkillsSystemText } from "../skill/runtime/SystemProvider.js";
+import { render_skill_find_prompt, render_skill_install_prompt, } from "../skill/runtime/Prompt.js";
 import { SKILL_PLUGIN_PROMPT } from "../skill/SkillPromptAssets.js";
 /**
  * 读取 JSON object。
@@ -24,20 +25,6 @@ function readJsonObject(value) {
     }
     return value;
 }
-/**
- * 读取字符串选项。
- */
-function getStringOpt(opts, key) {
-    const value = opts[key];
-    return typeof value === "string" ? value.trim() : undefined;
-}
-/**
- * 读取布尔选项。
- */
-function getBooleanOpt(opts, key) {
-    const value = opts[key];
-    return typeof value === "boolean" ? value : undefined;
-}
 /**
  * XML 属性转义。
  */
@@ -48,57 +35,44 @@ function sanitizeXmlAttr(value) {
         .replace(/</g, "&lt;")
         .replace(/>/g, "&gt;");
 }
-/**
- * 从 install spec 推断候选 skill 标识。
- */
-function inferSkillQueryFromSpec(spec) {
-    const raw = String(spec || "").trim();
-    if (!raw)
-        return "";
-    const normalized = raw.split(/[?#]/, 1)[0]?.trim() || raw;
-    const atIndex = normalized.lastIndexOf("@");
-    if (atIndex > 0 && atIndex < normalized.length - 1) {
-        return normalized.slice(atIndex + 1).trim();
-    }
-    if (!normalized.includes("/"))
-        return normalized;
-    return "";
-}
 function createSkillPluginDefinition(options) {
     return {
         name: "skill",
         title: "Skill Catalog And Loader",
-        description: "Finds, installs, lists, and reads local skills, and injects the current skill overview into system prompts so the agent knows what capabilities are available.",
-        async system(context) {
+        description: "Lists and reads local skills, and injects scan-aware discovery and installation guidance into system prompts.",
+        async system(context, run_context) {
             const dynamicText = String(await buildSkillsSystemText({
                 rootPath: context.rootPath,
                 options,
-            })).trim();
+            }, run_context)).trim();
             return [SKILL_PLUGIN_PROMPT, dynamicText].filter(Boolean).join("\n\n");
         },
         actions: {
             [SKILL_PLUGIN_ACTIONS.find]: createAction({
-                description: "Find unlearned skills that are not in `list`; install only if missing.",
+                description: "Return shell instructions for finding a skill. This action does not execute the search.",
                 input_schema: {
                     zod: z.object({
-                        query: z.string(),
+                        query: z.string().trim().min(1),
                     }),
                     json_schema: {
                         type: "object",
                         required: ["query"],
                         properties: {
-                            query: { type: "string", description: "Skill search query." },
+                            query: {
+                                type: "string",
+                                description: "Skill search query.",
+                            },
                         },
                     },
                 },
                 examples: [
                     {
-                        title: "Find skill",
-                        payload: { query: "web-search" },
+                        title: "Get skill search instructions",
+                        payload: { query: "web access" },
                     },
                 ],
                 command: {
-                    description: "Find unlearned skills that are not in `list`; install only if missing.",
+                    description: "Return shell instructions for finding a skill without executing the search.",
                     configure(command) {
                         command.argument("<query>");
                     },
@@ -109,129 +83,63 @@ function createSkillPluginDefinition(options) {
                         return { query };
                     },
                 },
-                async execute(params) {
+                execute(params) {
                     const payload = params.input;
-                    const rootPath = params.context.rootPath;
-                    const exactLearned = findLearnedSkillExact(rootPath, payload.query, options);
-                    if (exactLearned) {
-                        return {
-                            success: true,
-                            data: {
-                                query: payload.query,
-                                message: "This skill is already in list; installation is not needed. Run lookup before using it.",
-                                workflow: ["list", "lookup"],
-                                nextAction: "lookup",
-                                learnedSkill: exactLearned,
-                                learnedHints: [],
-                            },
-                        };
-                    }
-                    const learnedHints = searchLearnedSkills(rootPath, payload.query, 5, options);
-                    await skillFindCommand(payload.query);
                     return {
                         success: true,
+                        message: "Skill search instructions ready; no search was executed.",
                         data: {
+                            kind: "instructions",
                             query: payload.query,
-                            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,
-                            learnedHints,
+                            prompt: render_skill_find_prompt(payload.query),
                         },
                     };
                 },
             }),
             [SKILL_PLUGIN_ACTIONS.install]: createAction({
-                description: "Install a skill that is not in `list`; run lookup after installation.",
+                description: "Return scan-aware shell instructions for installing a skill. This action does not install anything.",
                 input_schema: {
                     zod: z.object({
-                        spec: z.string(),
-                        global: z.boolean().optional(),
-                        yes: z.boolean().optional(),
-                        agent: z.string().optional(),
+                        spec: z.string().trim().min(1),
                     }),
                     json_schema: {
                         type: "object",
                         required: ["spec"],
                         properties: {
-                            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." },
+                            spec: {
+                                type: "string",
+                                description: "Skill installation source or spec.",
+                            },
                         },
                     },
                 },
                 examples: [
                     {
-                        title: "Install skill",
-                        payload: { spec: "web-search", global: true, yes: true },
+                        title: "Get skill installation instructions",
+                        payload: { spec: "owner/repository@skill-name" },
                     },
                 ],
                 command: {
-                    description: "Install a skill that is not in `list`; run lookup after installation.",
+                    description: "Return scan-aware shell instructions without installing a skill.",
                     configure(command) {
-                        command
-                            .argument("<spec>")
-                            .option("-g, --global", "全局安装（默认 true）", true)
-                            .option("-y, --yes", "跳过确认（默认 true）", true)
-                            .option("--agent <agent>", "指定 agent");
+                        command.argument("<spec>");
                     },
-                    mapInput({ args, opts }) {
+                    mapInput({ args }) {
                         const spec = String(args[0] || "").trim();
                         if (!spec)
                             throw new Error("Missing spec");
-                        return {
-                            spec,
-                            global: getBooleanOpt(opts, "global"),
-                            yes: getBooleanOpt(opts, "yes"),
-                            agent: getStringOpt(opts, "agent"),
-                        };
+                        return { spec };
                     },
                 },
-                async execute(params) {
+                execute(params) {
                     const payload = params.input;
-                    const rootPath = params.context.rootPath;
-                    const queryFromSpec = inferSkillQueryFromSpec(payload.spec);
-                    const beforeList = listSkills(rootPath, options).skills;
-                    const beforeIds = new Set(beforeList.map((item) => item.id));
-                    const learnedBefore = findLearnedSkillExact(rootPath, queryFromSpec, options) ||
-                        findLearnedSkillExact(rootPath, payload.spec, options);
-                    if (learnedBefore) {
-                        return {
-                            success: true,
-                            data: {
-                                spec: payload.spec,
-                                skipped: true,
-                                message: "The skill is already in list; installation is not needed. Run lookup before using it.",
-                                workflow: ["list", "lookup"],
-                                nextAction: "lookup",
-                                queryFromSpec,
-                                addedSkills: [],
-                                learnedSkill: learnedBefore,
-                            },
-                        };
-                    }
-                    await skillInstallCommand(payload.spec, {
-                        global: payload.global,
-                        yes: payload.yes,
-                        agent: payload.agent,
-                    });
-                    const afterList = listSkills(rootPath, options).skills;
-                    const addedSkills = afterList.filter((item) => !beforeIds.has(item.id));
-                    const learnedAfter = findLearnedSkillExact(rootPath, queryFromSpec, options) ||
-                        findLearnedSkillExact(rootPath, payload.spec, options) ||
-                        (addedSkills.length === 1 ? addedSkills[0] : undefined);
                     return {
                         success: true,
+                        message: "Skill installation instructions ready; no files were changed.",
                         data: {
+                            kind: "instructions",
                             spec: payload.spec,
-                            message: "Skill learning completed. Before using the skill, run lookup to read its SKILL.md content.",
-                            workflow: ["find", "install", "lookup"],
-                            nextAction: "lookup",
-                            skipped: false,
-                            queryFromSpec,
-                            addedSkills,
-                            learnedSkill: learnedAfter || null,
+                            prompt: render_skill_install_prompt(params.context.rootPath, options, payload.spec),
                         },
                     };
                 },
@@ -360,7 +268,7 @@ function createSkillPluginDefinition(options) {
     };
 }
 /**
- * SkillPlugin：技能发现、安装、读取与 system 注入。
+ * SkillPlugin：技能发现、读取与扫描感知的 system 注入。
  */
 export class SkillPlugin extends BasePlugin {
     name = "skill";

package/bin/skill/Plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/skill/Plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/skill/Plugin.ts"],"names":[],"mappings":"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"}

package/bin/skill/runtime/Prompt.d.ts

@@ -2,18 +2,27 @@
  * Skill plugin prompt section 渲染器。
  *
  * 关键点（中文）
- * - 仅负责渲染运行时动态清单（已发现 skills + 扫描根目录）。
+ * - 负责渲染运行时动态清单，以及 find/install action 返回的纯提示词。
  * - 稳定规则放在 `SkillPromptAssets.ts`，避免分散在代码里维护。
  * - 仅做字符串渲染，不做文件 IO。
  */
 import type { SkillDefinition } from "../../skill/types/SkillDefinition.js";
 import type { SkillPluginOptions } from "../../skill/types/SkillPlugin.js";
+/**
+ * 生成 find action 返回的纯提示词。
+ */
+export declare function render_skill_find_prompt(query: string): string;
+/**
+ * 生成 install action 返回的扫描感知纯提示词。
+ */
+export declare function render_skill_install_prompt(project_root: string, options: SkillPluginOptions | null | undefined, spec: string): string;
 /**
  * 渲染 skills 系统提示片段。
  *
  * 约束（中文）
  * - 为控制 token 成本，最多展示前 40 个 skill。
  * - roots 会按扫描顺序输出，便于排查冲突覆盖。
+ * - 查找与安装指引必须根据实际 roots 生成，不能假设固定安装范围。
  */
-export declare function renderSkillsPromptSection(projectRoot: string, options: SkillPluginOptions | null | undefined, skills: SkillDefinition[]): string;
+export declare function render_skills_prompt_section(project_root: string, options: SkillPluginOptions | null | undefined, skills: SkillDefinition[]): string;
 //# sourceMappingURL=Prompt.d.ts.map

package/bin/skill/runtime/Prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Prompt.d.ts","sourceRoot":"","sources":["../../../src/skill/runtime/Prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,EAC9C,MAAM,EAAE,eAAe,EAAE,GACxB,MAAM,CAoCR"}
+{"version":3,"file":"Prompt.d.ts","sourceRoot":"","sources":["../../../src/skill/runtime/Prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AA+CvE;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY9D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,EAC9C,IAAI,EAAE,MAAM,GACX,MAAM,CAgBR;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,EAC9C,MAAM,EAAE,eAAe,EAAE,GACxB,MAAM,CA+CR"}

package/bin/skill/runtime/Prompt.js

@@ -2,21 +2,97 @@
  * Skill plugin prompt section 渲染器。
  *
  * 关键点（中文）
- * - 仅负责渲染运行时动态清单（已发现 skills + 扫描根目录）。
+ * - 负责渲染运行时动态清单，以及 find/install action 返回的纯提示词。
  * - 稳定规则放在 `SkillPromptAssets.ts`，避免分散在代码里维护。
  * - 仅做字符串渲染，不做文件 IO。
  */
 import { getSkillSearchRoots } from "./Paths.js";
+/**
+ * 把外部输入编码为单个 POSIX Shell 参数。
+ *
+ * 关键点（中文）：action 只返回提示词，但提示中的命令仍需避免把 query/spec 解释为额外 Shell 语法。
+ */
+function quote_shell_argument(value) {
+    return `'${String(value).replaceAll("'", "'\\''")}'`;
+}
+/**
+ * 根据已配置扫描根生成安装位置提示。
+ */
+function render_install_root_instructions(roots, spec_argument) {
+    if (roots.length === 0) {
+        return [
+            "- No scan roots are configured.",
+            "  Do not install a skill until the SkillPlugin configuration provides a discoverable root.",
+        ].join("\n");
+    }
+    return roots
+        .map((root) => {
+        if (root.source === "project") {
+            return [
+                `- [project] Install from the project root with \`npx -y skills add ${spec_argument} -y\`.`,
+                `  The installed skill must end up under \`${root.resolved}/<skill-id>/SKILL.md\`.`,
+            ].join("\n");
+        }
+        if (root.source === "home") {
+            return [
+                `- [home] Install globally with \`npx -y skills add ${spec_argument} -g -y\`.`,
+                `  The installed skill must end up under \`${root.resolved}/<skill-id>/SKILL.md\`.`,
+            ].join("\n");
+        }
+        return [
+            `- [custom] Install or copy the skill into \`${root.resolved}/<skill-id>/SKILL.md\`.`,
+            "  The skills CLI has no generic custom-root flag, so verify the final path instead of assuming installation succeeded.",
+        ].join("\n");
+    })
+        .join("\n");
+}
+/**
+ * 生成 find action 返回的纯提示词。
+ */
+export function render_skill_find_prompt(query) {
+    const query_argument = quote_shell_argument(query);
+    return [
+        "# Find Skill Instructions",
+        "",
+        "This action only returns instructions. It has not searched for or installed anything.",
+        "Use the available web or browser capability to search these Skill catalogs:",
+        "- https://www.skills.sh/",
+        "- https://app.lobehub.com/community/skill",
+        `Use the available shell tool to run \`npx -y skills find ${query_argument}\`.`,
+        "Compare the catalog and CLI results, then choose an installation spec before calling the `skill.install` action.",
+    ].join("\n");
+}
+/**
+ * 生成 install action 返回的扫描感知纯提示词。
+ */
+export function render_skill_install_prompt(project_root, options, spec) {
+    const roots = getSkillSearchRoots(project_root, options);
+    const spec_argument = quote_shell_argument(spec);
+    return [
+        "# Install Skill Instructions",
+        "",
+        "This action only returns instructions. It has not installed or changed any files.",
+        "Install only into one of the configured scan roots:",
+        render_install_root_instructions(roots, spec_argument),
+        "",
+        [
+            "After the shell installation command completes, call",
+            "`plugin_call({ plugin: \"skill\", action: \"list\", payload: {} })`",
+            "and check whether the new skill appears. Then call `skill.lookup` before using it.",
+        ].join(" "),
+    ].join("\n");
+}
 /**
  * 渲染 skills 系统提示片段。
  *
  * 约束（中文）
  * - 为控制 token 成本，最多展示前 40 个 skill。
  * - roots 会按扫描顺序输出，便于排查冲突覆盖。
+ * - 查找与安装指引必须根据实际 roots 生成，不能假设固定安装范围。
  */
-export function renderSkillsPromptSection(projectRoot, options, skills) {
-    const roots = getSkillSearchRoots(projectRoot, options);
-    const skillsSection = skills.length > 0
+export function render_skills_prompt_section(project_root, options, skills) {
+    const roots = getSkillSearchRoots(project_root, options);
+    const skills_section = skills.length > 0
         ? skills
             .map((skill) => {
             const desc = skill.description ? ` - ${skill.description}` : "";
@@ -24,13 +100,16 @@ export function renderSkillsPromptSection(projectRoot, options, skills) {
         })
             .join("\n")
         : "- (none)";
-    const rootsSection = roots.length > 0
+    const roots_section = roots.length > 0
         ? roots
             .map((root) => {
-            return `- [${root.source}] ${root.display}`;
+            return `- [${root.source}] ${root.display} -> ${root.resolved}`;
         })
             .join("\n")
         : "- (none)";
+    const ignore_notice = Array.isArray(options?.ignore) && options.ignore.length > 0
+        ? "Configured ignore rules are active. A matching skill will not appear in `list`, even if its files exist in a scan root."
+        : "";
     return [
         "# Runtime Skills Inventory",
         "",
@@ -38,10 +117,16 @@ export function renderSkillsPromptSection(projectRoot, options, skills) {
         "All skills in `Available Skills` are already available locally.",
         "",
         "## Available Skills",
-        skillsSection,
+        skills_section,
         "",
         "## Skill Roots (scan order, higher wins on conflicts)",
-        rootsSection,
+        roots_section,
+        "",
+        "## Missing Skill Workflow",
+        "Call `skill.find` with the search query to receive Shell search instructions.",
+        "After choosing a spec, call `skill.install` to receive scan-aware installation instructions.",
+        "Both actions return prompts only. They do not execute commands or change files.",
+        ignore_notice,
     ]
         .filter(Boolean)
         .join("\n");

package/bin/skill/runtime/Prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"Prompt.js","sourceRoot":"","sources":["../../../src/skill/runtime/Prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,WAAmB,EACnB,OAA8C,EAC9C,MAAyB;IAEzB,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAExD,MAAM,aAAa,GACjB,MAAM,CAAC,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,MAAM;aACH,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACtC,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,UAAU,CAAC;IAEjB,MAAM,YAAY,GAChB,KAAK,CAAC,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,KAAK;aACF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,OAAO,MAAM,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9C,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,UAAU,CAAC;IAEjB,OAAO;QACL,4BAA4B;QAC5B,EAAE;QACF,cAAc,MAAM,CAAC,MAAM,8BAA8B;QACzD,iEAAiE;QACjE,EAAE;QACF,qBAAqB;QACrB,aAAa;QACb,EAAE;QACF,uDAAuD;QACvD,YAAY;KACb;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}
+{"version":3,"file":"Prompt.js","sourceRoot":"","sources":["../../../src/skill/runtime/Prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAKjD;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAS,gCAAgC,CACvC,KAAkB,EAClB,aAAqB;IAErB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,iCAAiC;YACjC,4FAA4F;SAC7F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;gBACL,sEAAsE,aAAa,QAAQ;gBAC3F,6CAA6C,IAAI,CAAC,QAAQ,yBAAyB;aACpF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,OAAO;gBACL,sDAAsD,aAAa,WAAW;gBAC9E,6CAA6C,IAAI,CAAC,QAAQ,yBAAyB;aACpF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QACD,OAAO;YACL,+CAA+C,IAAI,CAAC,QAAQ,yBAAyB;YACrF,wHAAwH;SACzH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,MAAM,cAAc,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACnD,OAAO;QACL,2BAA2B;QAC3B,EAAE;QACF,uFAAuF;QACvF,6EAA6E;QAC7E,0BAA0B;QAC1B,2CAA2C;QAC3C,4DAA4D,cAAc,KAAK;QAC/E,kHAAkH;KACnH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,YAAoB,EACpB,OAA8C,EAC9C,IAAY;IAEZ,MAAM,KAAK,GAAG,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO;QACL,8BAA8B;QAC9B,EAAE;QACF,mFAAmF;QACnF,qDAAqD;QACrD,gCAAgC,CAAC,KAAK,EAAE,aAAa,CAAC;QACtD,EAAE;QACF;YACE,sDAAsD;YACtD,qEAAqE;YACrE,oFAAoF;SACrF,CAAC,IAAI,CAAC,GAAG,CAAC;KACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAC1C,YAAoB,EACpB,OAA8C,EAC9C,MAAyB;IAEzB,MAAM,KAAK,GAAG,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAEzD,MAAM,cAAc,GAClB,MAAM,CAAC,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,MAAM;aACH,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACtC,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,UAAU,CAAC;IAEjB,MAAM,aAAa,GACjB,KAAK,CAAC,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,KAAK;aACF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,OAAO,MAAM,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClE,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,UAAU,CAAC;IAEjB,MAAM,aAAa,GACjB,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACzD,CAAC,CAAC,yHAAyH;QAC3H,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACL,4BAA4B;QAC5B,EAAE;QACF,cAAc,MAAM,CAAC,MAAM,8BAA8B;QACzD,iEAAiE;QACjE,EAAE;QACF,qBAAqB;QACrB,cAAc;QACd,EAAE;QACF,uDAAuD;QACvD,aAAa;QACb,EAAE;QACF,2BAA2B;QAC3B,+EAA+E;QAC/E,8FAA8F;QAC9F,iFAAiF;QACjF,aAAa;KACd;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}