《扣子编程从一句话到产品上线：零门槛AI心流开发》全书案例分享~持续更新-CSDN博客
3.2.1 技能标准文件结构
在扣子智能体开发框架中，每一个自定义技能都是一套独立、完整、规范的文档工程。一个技能在系统中是独立文件夹，SKILL.md 是唯一必填核心（说明书本体，Markdown 编写），剩余两类为选配。
1）核心主文件SKILL.md（必选）
这是技能的本体，也就是AI读取的"工作说明书全文"。所有触发条件、参数定义、执行步骤、业务逻辑、输出格式、约束规范全部写在该 Markdown 文件中。大模型运行技能的本质，就是读取并严格执行这份文档的所有条款。
2）脚本目录scripts（可选）
存放接口调用、数据处理、自动化脚本等底层执行代码，对应插件能力。
3）参考目录references（可选）
存放行业规范、模板案例、参考标准，用于辅助AI完成标准化输出。
3.2.2 技能的完整运行机制
大模型负责理解、判断、统筹决策；技能说明书负责定义流程、约束规则、规范输出，两者形成"决策---指令---执行"的完整闭环，完整流程分为五个步骤。
第一步：用户输入需求，智能体识别业务场景
用户向智能体提交自然语言需求，例如输入股票代码、提出选股需求、请求数据分析等。此时大模型首先完成语义理解，识别用户的真实意图、任务类型、输入参数是否合规，判断当前任务属于哪一类业务场景。如果用户输入格式错误、参数缺失、内容违规，大模型会依据基础规则直接拦截并提示用户重新输入。这一步是整个任务的入口，起到场景定位、合法性校验、任务初始化的作用，为后续匹配对应技能流程做铺垫。
第二步：大模型自动匹配对应的 技能标准化说明书
智能体挂载的每一项技能，都是一份独立、完整、场景专属的标准化SOP作业说明书。大模型会根据识别到的用户场景，自动检索、匹配当前任务唯一对应的技能文档。不同于自由对话模式，进入技能模式后，大模型不再自主构思任务流程，而是强制切换为"执行者模式"，完全以匹配到的技能文档为唯一执行标准。技能说明书中定义的触发条件、任务目标、执行规范，成为大模型接下来所有操作的最高准则，从根源限制大模型的自由发挥。
第三步：大模型依据 技能规则，调度插件工具、传入参数、获取原始数据
这是智能体从"纯文本思考"转向"实际干活"的关键一步。技能说明书中会提前写明完整的工具调用规则：需要调用哪些插件、何时调用、需要传入什么参数、数据来源是什么。大模型严格读取这些既定规则，自动组装用户输入的参数，精准调用对应的插件与公开接口，自动发起数据请求，采集任务所需的全部原始数据。大模型只负责调度统筹，严格遵循技能指令，不随意增减工具、不篡改参数、不跳过任何执行步骤，确保数据采集过程完全标准化、可复现。
第四步：按照 技能既定规范，完成数据推理、加工与结构化整理
获取原始数据后，大模型不会自由分析、随意排版，而是严格遵照技能说明书中提前定义的分析维度、筛选逻辑、评判标准、排版结构，对零散原始数据进行清洗、筛选、对比、推理、归纳与重组。
第五步：遵循 技能强制格式，输出标准化最终结果
完成数据处理与分析后，大模型最终按照技能说明书中固定的输出模板、分级标题、段落结构、字段规范、免责声明等强制格式，生成排版工整、结构统一、内容规范的最终成果。
整个运行机制可以凝练为一句核心原理：技能负责定义全部流程与规范，是作业指导书；大模型负责阅读理解说明书、按规推理输出，是执行大脑。
