
Quick Summary Skill【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20 more CLI Agent | Customize your assistants | Team them upStar if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUiYou are a concise project summarizer.When user asks for a summary:Output 3-6 bullet points.Include: goal, current status, and next action.Keep each bullet under 20 words.这份文件由四个层次构成对应编写任何技能都应遵守的骨架 | 层次 | 原文内容 | 作用 | | --- | --- | --- | | 标题 | # Quick Summary Skill | 以 Markdown H1 声明技能身份便于在技能列表中识别 | | 角色设定 | You are a concise project summarizer. | 为 Agent 定义一个明确的人格/专业角色决定后续行为的基调 | | 触发条件 | When user asks for a summary: | 明确该技能在何种用户请求下生效避免误触发 | | 行为指令 | 编号列表 1-3 | 给出可执行、可量化的输出规则直接约束 Agent 的回答格式 | 值得注意的两点设计 - **用「简洁concise」一词贯穿全局**角色设定里的 concise 与第 3 条 under 20 words每条少于 20 词形成前后呼应把「简洁」从抽象形容词落地为可校验的量化约束。 - **输出结构固定化**第 2 条要求必须包含 goal目标、current status当前状态、next action下一步行动三个字段。这种「结构化输出」约束让总结结果稳定、易读也便于下游消费。 ## 技能的四种编写形态对比仓库中的其他技能 Hello World 扩展目录下还提供了另一个技能 [issue-breakdown.md](https://link.gitcode.com/i/fd7222e511c980915d83bf3cea798806)它演示了「流程化指令」的写法 markdown # Issue Breakdown Skill You are an issue triage assistant. For any bug report: 1. Restate the issue in one sentence. 2. Provide likely root causes (max 3). 3. Give a minimal verification checklist.同样是「标题 角色 触发条件 编号指令」的结构但每条指令都带有数量上限约束max 3个根因和粒度约束一句话复述、最小化验证清单适合 Bug 分类这种需要控制输出规模的场景。再看 E2E 完整扩展examples/e2e-full-extension中的两个技能它们展示了另两种风格coding-skill.md ——能力清单式不设触发条件直接用无序列表声明Help with code generation、Support multiple programming languages、Provide code reviews等能力范围适合常驻型通用技能test-skill.md ——强制格式式要求Always respond with structured JSON、Include a status field in every response用强约束保证输出可被程序解析适合与自动化流水线对接的技能。四种形态量化约束式、流程分步式、能力清单式、强制格式式可自由组合共同点是都必须包含清晰的角色设定与可执行指令。把技能注册进扩展contributes/skills.json仅放置 Markdown 文件并不会被 AionUI 识别技能必须在扩展清单中登记。Hello World 扩展通过 contributes/skills.json 完成注册[ { name: hello-quick-summary, description: Generate a short project summary with clear bullet points, file: skills/quick-summary.md }, { name: hello-issue-breakdown, description: Break a user issue into reproducible steps and checks, file: skills/issue-breakdown.md } ]每个技能条目包含三个字段字段取值示例说明namehello-quick-summary全局唯一的技能标识被 Agent/Assistant 的enabledSkills引用也出现在扩展快照的skills列表中descriptionGenerate a short project summary with clear bullet points技能的能力摘要供系统在技能索引注入与用户选择时展示fileskills/quick-summary.md技能文件路径相对于扩展根目录解析除外部 JSON 文件外技能也可以像 e2e-full-extension/aion-extension.json 第 53-64 行那样直接内联在扩展清单的contributes.skills数组中e2e-test-skill、e2e-coding-skill两种写法等价外部文件方式更利于模块化组织。扩展清单中的声明链路aion-extension.jsonhello-world-extension/aion-extension.json 展示了技能在扩展整体架构中的位置{ $schema: ../../schemas/aion-extension-v1.json, name: hello-world, displayName: Hello World Extension, version: 1.0.0, permissions: { storage: true, network: false, shell: false, filesystem: extension-only, events: true }, contributes: { acpAdapters: $file:contributes/acp-adapters.json, mcpServers: $file:contributes/mcp-servers.json, assistants: $file:contributes/assistants.json, agents: $file:contributes/agents.json, skills: $file:contributes/skills.json, themes: $file:contributes/themes.json, settingsTabs: $file:contributes/settings-tabs.json } }关键点contributes.skills使用$file:前缀指向外部 JSON与 ACP 适配器、MCP 服务器、助手、Agent、主题、设置页并列是扩展七大贡献类别之一engine.aionui: ^1.0.0声明扩展兼容的 AionUI 引擎版本permissions.filesystem: extension-only表明扩展对文件系统的访问被限制在自身目录内——这与后文技能文件加载时的路径校验机制相互印证扩展还提供可选的lifecycle脚本onActivate/onDeactivate技能文件属于静态资源不依赖生命周期即可被加载。技能与 Agent/Assistant 的绑定enabledSkills 机制技能注册后还需显式绑定到 Agent 或 Assistant 才会在实际会话中生效。Hello World 扩展的 contributes/agents.json 中「Hello Coder」Agent 通过enabledSkills引用技能{ id: hello-coder, name: Hello Coder, description: A coding agent that helps with code generation and review, presetAgentType: hello-stdio-agent, contextFile: agents/hello-coder-context.md, models: [demo-model], enabledSkills: [hello-quick-summary], prompts: [You are a coding agent. Help users write clean, efficient code.] }该 Agent 同时配有 agents/hello-coder-context.md 作为系统上下文声明代码生成、重构、审查、Bug 修复等能力与行为准则而enabledSkills: [hello-quick-summary]则把hello-quick-summary技能挂载到该 Agent 上。同理e2e-full-extension/aion-extension.json 第 132-143 行的e2e-test-assistant通过enabledSkills: [e2e-test-skill]完成 Assistant 级绑定。从源码结构看如 GuidActionRow.tsx 的enabledSkills处理逻辑渲染层会依据disabledBuiltinSkills与enabledSkills的并集/差集计算实际启用的技能集合。技能的底层加载与安全机制skillFiles 服务源码解析技能文件的读取由主进程服务 packages/desktop/src/process/services/skills/skillFiles.ts 提供并在 applicationBridgeCore.ts 第 20-24 行注册为 IPC provideripcBridge.fs.listSkillFiles.provider(({ skill_location }) skillFiles.list(skill_location)); ipcBridge.fs.readSkillFile.provider(({ skill_location, relative_path }) skillFiles.read(skill_location, relative_path) );【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20 more CLI Agent | Customize your assistants | Team them upStar if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUi创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考