@downcity/agent 1.1.7 → 1.1.10

package/bin/plugin/builtins/auth/types/AuthPlugin.js

@@ -0,0 +1,115 @@
+/**
+ * Auth Plugin 类型与契约定义。
+ *
+ * 关键点（中文）
+ * - 统一维护 auth plugin 的领域类型、扩展点/action 名称、payload 契约。
+ * - 业务层不应散落硬编码字符串，如 `chat.authorizeIncoming`、`set-user-role`。
+ * - chat / console / plugin 执行链路都从这里共享同一份边界定义。
+ */
+import { CHAT_PLUGIN_POINTS } from "../../../../service/builtins/chat/runtime/PluginPoints.js";
+/**
+ * auth plugin 稳定名称。
+ */
+export const AUTH_PLUGIN_NAME = "auth";
+/**
+ * auth 支持的渠道目录。
+ */
+export const CHAT_AUTHORIZATION_CHANNELS = ["telegram", "feishu", "qq"];
+/**
+ * auth 扩展点名称集合。
+ */
+export const AUTH_PLUGIN_POINTS = {
+    observePrincipal: CHAT_PLUGIN_POINTS.observePrincipal,
+    authorizeIncoming: CHAT_PLUGIN_POINTS.authorizeIncoming,
+    resolveUserRole: CHAT_PLUGIN_POINTS.resolveUserRole,
+};
+/**
+ * auth action 名称集合。
+ */
+export const AUTH_ACTIONS = {
+    snapshot: "snapshot",
+    readConfig: "read-config",
+    writeConfig: "write-config",
+    setUserRole: "set-user-role",
+};
+/**
+ * 可配置的授权权限目录。
+ */
+export const CHAT_AUTHORIZATION_PERMISSIONS = [
+    "chat.dm.use",
+    "chat.group.use",
+    "auth.manage.users",
+    "auth.manage.roles",
+    "agent.view.logs",
+    "agent.manage",
+];
+/**
+ * 权限展示文案映射。
+ */
+export const CHAT_AUTHORIZATION_PERMISSION_LABELS = {
+    "chat.dm.use": "DM",
+    "chat.group.use": "Group",
+    "auth.manage.users": "Users",
+    "auth.manage.roles": "Roles",
+    "agent.view.logs": "Logs",
+    "agent.manage": "Agent",
+};
+/**
+ * 权限说明文案映射。
+ */
+export const CHAT_AUTHORIZATION_PERMISSION_DESCRIPTIONS = {
+    "chat.dm.use": "允许用户在私聊场景中直接向 agent 发送请求并得到响应。",
+    "chat.group.use": "允许用户在群聊或频道场景中触发 agent 执行对话与任务。",
+    "auth.manage.users": "允许修改用户与权限组之间的绑定关系。",
+    "auth.manage.roles": "允许编辑权限组定义，以及调整各渠道的新用户默认组。",
+    "agent.view.logs": "允许查看当前 agent 的运行日志与排障信息。",
+    "agent.manage": "允许执行高权限管理动作，例如变更配置、操作服务与任务。",
+};
+/**
+ * auth 统一目录常量。
+ */
+export const CHAT_AUTHORIZATION_CATALOG = {
+    channels: [...CHAT_AUTHORIZATION_CHANNELS],
+    permissions: [...CHAT_AUTHORIZATION_PERMISSIONS],
+    permissionLabels: { ...CHAT_AUTHORIZATION_PERMISSION_LABELS },
+    permissionMeta: Object.fromEntries(CHAT_AUTHORIZATION_PERMISSIONS.map((permission) => [
+        permission,
+        {
+            permission,
+            name: CHAT_AUTHORIZATION_PERMISSION_LABELS[permission],
+            description: CHAT_AUTHORIZATION_PERMISSION_DESCRIPTIONS[permission],
+        },
+    ])),
+};
+/**
+ * 构建默认权限组。
+ */
+export function createDefaultChatAuthorizationRoles() {
+    return {
+        default: {
+            roleId: "default",
+            name: "Default",
+            description: "新用户的起始权限组，不授予任何消息或管理能力。",
+            permissions: [],
+        },
+        member: {
+            roleId: "member",
+            name: "Member",
+            description: "标准协作者，可在私聊与群聊中使用 agent。",
+            permissions: ["chat.dm.use", "chat.group.use"],
+        },
+        admin: {
+            roleId: "admin",
+            name: "Admin",
+            description: "完全管理权限，可调整授权、查看日志并执行 agent 管理动作。",
+            permissions: [...CHAT_AUTHORIZATION_PERMISSIONS],
+        },
+    };
+}
+/**
+ * 判断给定值是否为 auth 支持的渠道。
+ */
+export function isChatAuthorizationChannel(value) {
+    return CHAT_AUTHORIZATION_CHANNELS.includes(String(value || "").trim().toLowerCase());
+}
+//# sourceMappingURL=AuthPlugin.js.map

package/bin/plugin/builtins/auth/types/AuthPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthPlugin.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/auth/types/AuthPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAErF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAU,CAAC;AAOjF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,gBAAgB,EAAE,kBAAkB,CAAC,gBAAgB;IACrD,iBAAiB,EAAE,kBAAkB,CAAC,iBAAiB;IACvD,eAAe,EAAE,kBAAkB,CAAC,eAAe;CAC3C,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,aAAa;IACzB,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,eAAe;CACpB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,aAAa;IACb,gBAAgB;IAChB,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,cAAc;CACN,CAAC;AAOX;;GAEG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAG7C;IACF,aAAa,EAAE,IAAI;IACnB,gBAAgB,EAAE,OAAO;IACzB,mBAAmB,EAAE,OAAO;IAC5B,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,MAAM;IACzB,cAAc,EAAE,OAAO;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAGnD;IACF,aAAa,EAAE,gCAAgC;IAC/C,gBAAgB,EAAE,gCAAgC;IAClD,mBAAmB,EAAE,oBAAoB;IACzC,mBAAmB,EAAE,2BAA2B;IAChD,iBAAiB,EAAE,0BAA0B;IAC7C,cAAc,EAAE,6BAA6B;CAC9C,CAAC;AA+CF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAA6B;IAClE,QAAQ,EAAE,CAAC,GAAG,2BAA2B,CAAC;IAC1C,WAAW,EAAE,CAAC,GAAG,8BAA8B,CAAC;IAChD,gBAAgB,EAAE,EAAE,GAAG,oCAAoC,EAAE;IAC7D,cAAc,EAAE,MAAM,CAAC,WAAW,CAChC,8BAA8B,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;QACjD,UAAU;QACV;YACE,UAAU;YACV,IAAI,EAAE,oCAAoC,CAAC,UAAU,CAAC;YACtD,WAAW,EAAE,0CAA0C,CAAC,UAAU,CAAC;SACpE;KACF,CAAC,CACqE;CAC1E,CAAC;AA2BF;;GAEG;AACH,MAAM,UAAU,mCAAmC;IACjD,OAAO;QACL,OAAO,EAAE;YACP,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,yBAAyB;YACtC,WAAW,EAAE,EAAE;SAChB;QACD,MAAM,EAAE;YACN,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yBAAyB;YACtC,WAAW,EAAE,CAAC,aAAa,EAAE,gBAAgB,CAAC;SAC/C;QACD,KAAK,EAAE;YACL,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,kCAAkC;YAC/C,WAAW,EAAE,CAAC,GAAG,8BAA8B,CAAC;SACjD;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAc;IAEd,OAAO,2BAA2B,CAAC,QAAQ,CACzC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAA8B,CACrE,CAAC;AACJ,CAAC"}

package/bin/plugin/builtins/skill/Action.d.ts

@@ -0,0 +1,34 @@
+/**
+ * skill plugin action helper。
+ *
+ * 关键点（中文）
+ * - 与 runtime tool 解耦：CLI / plugin action / server 都可统一复用。
+ * - `lookup` 采用无状态实现：直接返回 `SKILL.md` 内容，不做 pin 持久化。
+ */
+import type { SkillListResponse, SkillLookupRequest, SkillLookupResponse, SkillSummary } from "../../../plugin/builtins/skill/types/SkillCommand.js";
+/**
+ * 在“已学会（本地可发现）”技能里做精确匹配。
+ */
+export declare function findLearnedSkillExact(projectRoot: string, query: string): SkillSummary | null;
+/**
+ * 在“已学会（本地可发现）”技能里做模糊搜索。
+ */
+export declare function searchLearnedSkills(projectRoot: string, query: string, limit?: number): SkillSummary[];
+/**
+ * 列出当前项目下可发现的全部 skill。
+ */
+export declare function listSkills(projectRoot: string): SkillListResponse;
+/**
+ * 读取指定 skill 的正文内容。
+ */
+export declare function lookupSkill(params: {
+    /**
+     * 项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * skill lookup 请求。
+     */
+    request: SkillLookupRequest;
+}): Promise<SkillLookupResponse>;
+//# sourceMappingURL=Action.d.ts.map

package/bin/plugin/builtins/skill/Action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/skill/Action.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACb,MAAM,+CAA+C,CAAC;AAqDvD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,IAAI,CAIrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,GACjB,YAAY,EAAE,CAahB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAMjE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC;CAC7B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6B/B"}

package/bin/plugin/builtins/skill/Action.js

@@ -0,0 +1,122 @@
+/**
+ * skill plugin action helper。
+ *
+ * 关键点（中文）
+ * - 与 runtime tool 解耦：CLI / plugin action / server 都可统一复用。
+ * - `lookup` 采用无状态实现：直接返回 `SKILL.md` 内容，不做 pin 持久化。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { discoverClaudeSkillsSync } from "../../../plugin/builtins/skill/runtime/Discovery.js";
+import { loadDowncityConfig } from "../../../config/Config.js";
+function normalizeAllowedTools(input) {
+    if (!Array.isArray(input))
+        return [];
+    const values = [];
+    for (const item of input) {
+        const value = typeof item === "string" ? item.trim() : "";
+        if (!value)
+            continue;
+        values.push(value);
+    }
+    return Array.from(new Set(values));
+}
+function toSkillSummary(skill) {
+    return {
+        id: skill.id,
+        name: skill.name,
+        description: skill.description || "",
+        source: skill.source,
+        skillMdPath: skill.skillMdPath,
+        allowedTools: normalizeAllowedTools(skill.allowedTools),
+    };
+}
+function findSkillExact(skills, name) {
+    const q = String(name || "").trim().toLowerCase();
+    if (!q)
+        return null;
+    return (skills.find((item) => item.id.toLowerCase() === q) ||
+        skills.find((item) => item.name.toLowerCase() === q) ||
+        null);
+}
+function findSkill(skills, name) {
+    const q = String(name || "").trim().toLowerCase();
+    if (!q)
+        return null;
+    return (skills.find((item) => item.id.toLowerCase() === q) ||
+        skills.find((item) => item.name.toLowerCase() === q) ||
+        skills.find((item) => item.name.toLowerCase().includes(q)) ||
+        null);
+}
+function getSkills(projectRoot) {
+    const root = path.resolve(projectRoot);
+    const config = loadDowncityConfig(root);
+    return discoverClaudeSkillsSync(root, config);
+}
+/**
+ * 在“已学会（本地可发现）”技能里做精确匹配。
+ */
+export function findLearnedSkillExact(projectRoot, query) {
+    const skills = getSkills(projectRoot);
+    const target = findSkillExact(skills, query);
+    return target ? toSkillSummary(target) : null;
+}
+/**
+ * 在“已学会（本地可发现）”技能里做模糊搜索。
+ */
+export function searchLearnedSkills(projectRoot, query, limit = 10) {
+    const q = String(query || "").trim().toLowerCase();
+    if (!q)
+        return [];
+    const skills = getSkills(projectRoot);
+    const matched = skills.filter((item) => {
+        const id = item.id.toLowerCase();
+        const name = item.name.toLowerCase();
+        const description = String(item.description || "").toLowerCase();
+        return id.includes(q) || name.includes(q) || description.includes(q);
+    });
+    return matched.slice(0, Math.max(1, limit)).map(toSkillSummary);
+}
+/**
+ * 列出当前项目下可发现的全部 skill。
+ */
+export function listSkills(projectRoot) {
+    const skills = getSkills(projectRoot).map(toSkillSummary);
+    return {
+        success: true,
+        skills,
+    };
+}
+/**
+ * 读取指定 skill 的正文内容。
+ */
+export async function lookupSkill(params) {
+    const root = path.resolve(params.projectRoot);
+    const skills = getSkills(root);
+    const target = findSkill(skills, params.request.name);
+    if (!target) {
+        return {
+            success: false,
+            error: `Skill not found: ${params.request.name}`,
+        };
+    }
+    let content = "";
+    try {
+        content = String(await fs.readFile(target.skillMdPath, "utf-8")).trim();
+    }
+    catch {
+        content = "";
+    }
+    if (!content) {
+        return {
+            success: false,
+            error: `Skill content is empty: ${target.id}`,
+        };
+    }
+    return {
+        success: true,
+        skill: toSkillSummary(target),
+        content,
+    };
+}
+//# sourceMappingURL=Action.js.map

package/bin/plugin/builtins/skill/Action.js.map

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

package/bin/plugin/builtins/skill/Command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/skill/Command.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAInE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBvE"}

package/bin/plugin/builtins/skill/Command.js

@@ -0,0 +1,70 @@
+/**
+ * `city skill` 命令 helper。
+ *
+ * 设计目标（中文）
+ * - 尽量不自建 registry：直接复用社区的 `npx skills` 生态（find/install）。
+ * - 同时提供本地视角的 `list`：列出 Downcity 当前能发现的 skills（含 project/home）。
+ */
+import path from "node:path";
+import fs from "fs-extra";
+import { execa } from "execa";
+import { discoverClaudeSkillsSync } from "../../../plugin/builtins/skill/runtime/Discovery.js";
+import { getClaudeSkillSearchRoots } from "../../../plugin/builtins/skill/runtime/Paths.js";
+import { loadDowncityConfig } from "../../../config/Config.js";
+async function runNpxSkills(args, opts) {
+    const yes = opts?.yes !== false;
+    const result = await execa("npx", [yes ? "-y" : "", "skills", ...args].filter(Boolean), {
+        stdio: "inherit",
+    });
+    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。
+ */
+export async function skillInstallCommand(spec, options = {}) {
+    const s = String(spec || "").trim();
+    if (!s)
+        throw new Error("Missing spec");
+    const args = ["add", s];
+    const agent = String(options.agent || "claude-code").trim();
+    if (agent)
+        args.push("--agent", agent);
+    const yes = options.yes !== false;
+    if (yes)
+        args.push("-y");
+    const globalInstall = options.global !== false;
+    if (globalInstall)
+        args.push("-g");
+    await runNpxSkills(args, { yes });
+}
+/**
+ * 输出当前项目的本地 skill 列表。
+ */
+export async function skillListCommand(cwd = ".") {
+    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 "city agent create" first or pass the correct path.`);
+    }
+    const config = loadDowncityConfig(projectRoot);
+    const roots = getClaudeSkillSearchRoots(projectRoot, config);
+    const skills = discoverClaudeSkillsSync(projectRoot, config);
+    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/plugin/builtins/skill/Command.js.map

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

package/bin/plugin/builtins/skill/Config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * skill plugin 配置读取工具。
+ *
+ * 关键点（中文）
+ * - skill 已迁到 plugin 体系，因此发现路径等配置统一从 `plugins.skill` 读取。
+ * - 这里负责把原始 JSON 配置归一化成 runtime 可直接消费的稳定结构。
+ */
+import type { DowncityConfig } from "../../../config/types/DowncityConfig.js";
+import type { ResolvedSkillPluginConfig } from "../../../plugin/builtins/skill/types/SkillPlugin.js";
+/**
+ * skill plugin 默认配置。
+ */
+export declare const DEFAULT_SKILL_PLUGIN_CONFIG: ResolvedSkillPluginConfig;
+/**
+ * 读取并归一化 skill plugin 配置。
+ */
+export declare function readSkillPluginConfig(config?: DowncityConfig | null): ResolvedSkillPluginConfig;
+//# sourceMappingURL=Config.d.ts.map

package/bin/plugin/builtins/skill/Config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/skill/Config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,8CAA8C,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,yBAGzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,GAC7B,yBAAyB,CAuB3B"}

package/bin/plugin/builtins/skill/Config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../../../src/plugin/builtins/skill/Config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA8B;IACpE,KAAK,EAAE,CAAC,gBAAgB,CAAC;IACzB,kBAAkB,EAAE,KAAK;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAA8B;IAE9B,MAAM,GAAG,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;IACnC,MAAM,WAAW,GACf,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QACnD,CAAC,CAAE,GAAyB;QAC5B,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC;QACvD,CAAC,CAAC,WAAW,CAAC,KAAK;aACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;aACxC,MAAM,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,KAAK,EACH,eAAe,CAAC,MAAM,GAAG,CAAC;YACxB,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,CAAC,GAAG,2BAA2B,CAAC,KAAK,CAAC;QAC5C,kBAAkB,EAChB,OAAO,WAAW,EAAE,kBAAkB,KAAK,SAAS;YAClD,CAAC,CAAC,WAAW,CAAC,kBAAkB;YAChC,CAAC,CAAC,2BAA2B,CAAC,kBAAkB;KACrD,CAAC;AACJ,CAAC"}

package/bin/plugin/builtins/skill/PROMPT.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+declare const TEXT_MODULE_CONTENT = "# Skill Plugin\n\nskill \u662F\u4F60\u62E5\u6709\u7684\u6280\u80FD\u3002\u7528\u6237\u7684\u63D0\u51FA\u7684\u9700\u6C42\u548C\u4EFB\u52A1\uFF0C\u4F60\u90FD\u9700\u8981\u5148\u8003\u8651\u5229\u7528\u76F8\u5173\u7684skill\u6765\u9AD8\u8D28\u91CF\u7684\u5B8C\u6210\u3002\n\n\n## \u4F7F\u7528\n\n\u4F7F\u7528\u6280\u80FD\u65F6\u9700\u8981\u9996\u5148\u901A\u8FC7 `city skill lookup <name>` \u547D\u4EE4\u8F7D\u5165\u5BF9\u5E94\u7684\u6280\u80FD\u5185\u5BB9\u3002\n\n\u4F60\u4E5F\u53EF\u4EE5\u4F7F\u7528 `city skill --help` \u547D\u4EE4\u5BF9skill\u8FDB\u884C\u5176\u4ED6\u64CD\u4F5C\u3002\u6BD4\u5982 `list`, `find`, `install`\u7B49\u7B49\u3002\n";
+export default TEXT_MODULE_CONTENT;
+//# sourceMappingURL=PROMPT.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PROMPT.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/skill/PROMPT.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,QAAA,MAAM,mBAAmB,yoBAA2N,CAAC;AAErP,eAAe,mBAAmB,CAAC"}

package/bin/plugin/builtins/skill/PROMPT.js

@@ -0,0 +1,8 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+// Source: src/plugin/builtins/skill/PROMPT.ts.txt
+const TEXT_MODULE_CONTENT = "# Skill Plugin\n\nskill 是你拥有的技能。用户的提出的需求和任务，你都需要先考虑利用相关的skill来高质量的完成。\n\n\n## 使用\n\n使用技能时需要首先通过 `city skill lookup <name>` 命令载入对应的技能内容。\n\n你也可以使用 `city skill --help` 命令对skill进行其他操作。比如 `list`, `find`, `install`等等。\n";
+export default TEXT_MODULE_CONTENT;
+//# sourceMappingURL=PROMPT.js.map

package/bin/plugin/builtins/skill/PROMPT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PROMPT.js","sourceRoot":"","sources":["../../../../src/plugin/builtins/skill/PROMPT.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAClD,MAAM,mBAAmB,GAAG,wNAAwN,CAAC;AAErP,eAAe,mBAAmB,CAAC"}

package/bin/plugin/builtins/skill/Plugin.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Skill Plugin。
+ *
+ * 关键点（中文）
+ * - skill 不再作为 service 存在，而是作为显式 action + system 提供者接入 plugin 体系。
+ * - `find/install/list/lookup` 全部通过 plugin actions 暴露。
+ * - skills overview 文本通过 `plugin.system` 注入，不再依赖 service.system。
+ */
+import type { Plugin } from "../../../plugin/types/Plugin.js";
+/**
+ * skillPlugin：技能发现、安装、读取与 system 注入。
+ */
+export declare const skillPlugin: Plugin;
+//# sourceMappingURL=Plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/skill/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAmFvD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MA8OzB,CAAC"}