QDKT15-1把功能/应用封装为 Agent 可用的 Skill 技能

如何将已有产品/项目能力抽象、封装为Agent可用的Skill一、核心概念对齐1.1 产品的基本组成所有产品网页、APP、小程序等都由前端和后端组成前端人机交互界面HTML、CSS、Markdown等标记语言渲染。后端处理逻辑、数据存储、API接口。前后端通过HTTP请求/API通信。1.2 Skill的本质Skill是Agent的插件/能力扩展不是Agent的必备品。目标将原有的人机图形界面交互转变为面向对话的交互范式。前端 → 对话式消息渲染支持Markdown、HTML等。后端 → 拆解为原子化的能力脚本、Webhook、API、持久化数据。两种后端服务类型状态型持久化数据如数据库读取可存为reference或资产文件。动作型临时计算/触发操作如弹窗、计算封装为脚本或API。1.3 为什么要进行skill化改造让Agent能够调用现有产品的能力实现自动化的多步骤任务。将用户的操作流程点击按钮 → 脚本 → 后端转化为对话指令用户说“帮我拉取资讯” → Agent调用对应skill。每一步可确认、可追踪、可回滚提升交互友好性。二、产品skill化改造的通用方法论2.1 核心思路解耦前后端原有前端图形界面 → 对话式输出消息/流式数据。原有后端逻辑 → 拆成独立可调用的脚本/API。重构数据结构避免返回超长、无效的上下文如古早RSS的冗长XML应萃取为结构化、简洁的格式如Markdown或精简JSON。原子化拆解按用户旅程任务流程而非页面/API拆分功能。每个技能对应一个完整的任务步骤。2.2 改造流程推荐分步执行步骤一输出项目功能拆解报告输入已有产品的代码库如GitHub开源项目。要求AI分析产品核心功能、用户操作路径、前端页面映射。后端接口依赖、数据流向。识别仅存在于前端的逻辑如表单、下拉菜单并建议如何下沉到服务层或前置为输入参数。识别过于面向页面的后端接口提出重构建议如独立API端点。交付物功能拆解报告含功能地图、用户操作清单、前后端映射、待确认问题等。步骤二封装为Skill规划基于步骤一的报告将每个用户任务抽象为一个Skill候选项。每个Skill应包含名称、使用场景、触发意图、输入/输出参数。依赖的后端能力脚本/API/数据文件。优先级、复杂度、是否需要用户确认。重要原则按流程拆分不要按API拆分一个Skill应完成一个完整任务。自包含Skill不应依赖其他Skill才能工作避免类似飞书Lark share的强依赖问题。如需共享认证/配置应内置或通过环境变量/本地文件解决。避免巨型Skill保持每个Skill小而精。环境变量所有API Key等敏感信息必须存放在.env文件中禁止硬编码在Skill里。返回文件路径本地环境应返回文件路径而非二进制内容。输出Skill规划文档含索引表、详细描述、封装顺序建议。步骤三创建Skill使用Skill Creator工具推荐使用Skill Creator 1.0简单、适合日常或2.0严格、适合分发/售卖。要求AI按规划逐个创建Skill每个Skill单独生成不要一次性生成所有。可启用子Agent并行创建多个Skill提高效率。每个Skill的skill.md应保持精简低频/详细内容如API规范、业务规则放到references/目录下按需读取。2.3 一键梭哈方式不推荐新手提供超长提示词让AI一次性完成全部拆解封装。对模型上下文长度要求极高可能需要24万 token且结果质量不稳定。仅适合经验丰富且使用强模型如Claude Code的场景。三、测评方法3.1 简单测评检查Skill完整性、代码可溯源不能编造能力。启用子Agent实际调用Skill执行任务验证可用性。输出验收报告。3.2 标准测评推荐使用Skill Creator 2.0内置的测试用例和流程。该工具提供结构化测试提示词。生成带人工审核界面的网页记录输入/输出和反馈。支持根据反馈迭代优化Skill。此方法同样可用于测评Agent本身。四、关键注意事项类别要求拆分粒度按用户旅程拆分不要按页面/API拆分依赖关系Skill必须自包含不依赖其他Skill信息存储低频/详细内容放references/skill.md保持精简敏感信息使用环境变量.env禁止硬编码返回格式本地环境返回文件路径网页环境返回URL错误处理允许自动重试建议最多3次失败后告知用户上下文效率避免一次加载全部API文档应分步骤按需读取reference执行步骤小步原子化便于用户反馈和中断恢复五、推荐工具与资源工具/资源用途Skill Creator 1.0日常快速开发Skill规范简洁Skill Creator 2.0严格测评、分发、商业化场景Cursor / Claude Code执行拆解和封装的IDE/CLI工具GitHub开源项目作为练习/改造的目标代码库腾讯文档示例存储提示词模板尽管主讲人吐槽其交互六、典型问题与解答摘录Q1什么时候用Skill什么时候直接写代码脚本Skill为Agent扩展能力外挂式插件不修改Agent本身。适合让不同Agent都能调用同一产品能力。代码脚本如果你自己开发一个Agent产品直接写Agent逻辑即可无需再包一层Skill。Q2如何让AI不偷懒只看文件名/函数名就下结论在提示词中明确要求“基于代码内容分析不要仅看文件名或函数名”。提供足够的知识资料如Skill规范、模板。要求输出标注不确定项说明需要补充的信息。Q3原产品后端未暴露独立API怎么办需要在改造计划中明确建议为每个管线/能力增加独立API端点确保Skill可调用。对于纯前端逻辑如表单应将其转化为Skill的输入参数或下沉为后端校验。七、总结本次会议核心掌握将现有产品“skill化”的三步法拆解 → 规划 → 封装理解自包含、原子化、对话式交互的设计原则。