go-stock 技能管理实战指南：基于 SKILL.md 的渐进式提示词注入机制详解

人工智能大模型AI 应用AI AgentRAG金融科技桌面应用MCP Clients【免费下载链接】go-stockAI赋能股票分析AI加持的股票分析/选股工具。股票行情获取AI热点资讯分析AI资金/财务分析涨跌报警推送。支持A股港股美股。支持市场整体/个股情绪分析AI辅助选股等。数据全部保留在本地。支持DeepSeekOpenAI OllamaLMStudioAnythingLLM硅基流动火山方舟阿里云百炼等平台或模型。项目地址https://gitcode.com/gh_mirrors/go/go-stock点击查看免费下载导读本文围绕 go-stock 的「技能管理」功能系统讲解技能Skill系统的核心原理与完整实操从渐进式提示词注入Progressive Disclosure的工作机制、SKILL.md的 FrontMatter 规范、skills/目录结构到技能包的导入、在线编辑、与 DeepAgents 模式的集成以及背后基于 eino ADK skill 中间件的源码级实现。读完本文你将掌握如何为 go-stock 编写、导入、管理可被 AI 按需激活的专业技能并理解其在 token 占用与上下文管理上的设计取舍。一、功能概述技能是什么技能Skill是 go-stock 提供的渐进式提示词注入机制让 AI 在 DeepAgents 模式下能够按需加载专业知识、工作流脚本或参考资料而无需在每次对话中都占用宝贵的上下文 token。技能以文件系统目录形式存储每个技能是一个独立的目录包含描述文件SKILL.md和可选的脚本、参考文档等资源。用户可以通过应用内的「技能管理」界面导入、编辑、管理这些技能。从项目描述看go-stock 定位为 AI 赋能股票分析/选股工具支持 A 股、港股、美股数据全部保留在本地技能系统正是为这类需要「K 线形态识别、技术指标解读、基本面分析、资讯研究」等复杂领域知识注入的场景而设计的把专业分析框架沉淀成技能包让 AI 在需要时自行加载。二、技能的工作原理2.1 渐进式展示Progressive Disclosurego-stock 基于 eino ADK 的 skill 中间件实现技能系统对应源码 backend/agent/agent.go 中buildSkillMiddleware的调用。其核心机制是启动时扫描DeepAgents 模式启动时扫描skills/目录下所有包含SKILL.md的一级子目录构建技能索引按需发现用户提问时AI 根据问题内容判断是否需要某个技能先读取技能的SKILL.md元数据激活注入当 AI 决定使用某技能时技能的完整提示词被注入到对话上下文资源加载技能可引用scripts/、references/等子目录中的脚本或文档按需读取。这种机制相比「始终注入所有提示词」的优势方式token 占用适用场景始终注入高每次对话都消耗简单固定的提示词渐进式展示低仅激活时消耗复杂、可组合的领域知识2.2 源码级的容错设计从源码结构看go-stock 并没有直接使用 eino 内置的filesystemBackend而是实现了一个tolerantSkillBackend容错后端backend/agent/skill_backend.go。其背景注释backend/agent/skill_backend.go说明了原因eino 内置的filesystemBackend.list()在加载 SKILL.md 时任意一个技能的 frontmatter 解析失败都会让 List/Get 返回错误。该错误会经由 skill 工具的Info()传播到NewToolNode导致整个 DeepAgents Agent 构建工具列表失败表现为[NodeRunError] failed to convert tool list from call option: ... failed to unmarshal frontmatter: yaml: unmarshal errors: line 2: cannot unmarshal !!seq into string也就是说一个手写/导入错误的 SKILL.md 会拖垮整个 Agent 运行。go-stock 的容错实现复用 eino 的 frontmatter 提取与解析逻辑但在单个技能解析失败时仅记录警告日志并跳过该技能保证其余技能正常加载、Agent 不受影响backend/agent/skill_backend.go。这一行为有测试用例直接验证TestTolerantSkillBackendSkipsBadFrontmatterbackend/agent/skill_backend_test.go构造了三个技能——正常技能、name被写成 YAML 序列的坏技能、缺少 frontmatter 分隔符的技能断言List仍能成功返回 1 个可用技能good-skill且Get(bad-skill)返回未找到错误。这意味着即使你的某个技能包格式有问题也不会影响其他技能和 Agent 的正常运行调试时请留意日志中的 skill 中间件: 跳过格式错误的技能文件 警告。2.3 仅 DeepAgents 模式生效技能系统仅在 DeepAgents 模式下启用原因参见 backend/agent/agent.go 的 createDeepAgent 设计说明DeepAgents 模式内置write_todos任务规划和task子 Agent 委派能力能够主动判断何时需要加载技能React / PlanExecute 模式架构不同不支持 skill 中间件若希望在简单任务中也使用技能请切换到 DeepAgents 模式。在 backend/agent/agent.go 中createDeepAgent会先构造文件系统 Backendtools.NewLocalFilesystemBackend与流式 Shelltools.NewLocalStreamingShell再通过buildSkillMiddleware挂载 skill 中间件并输出日志DeepAgents 启用 skill 中间件渐进式展示。三、技能目录结构每个技能是skills/下的一个一级子目录目录名即技能名。最小可用技能只包含一个SKILL.md文件skills/ └── my-skill/ └── SKILL.md完整技能可包含脚本、参考文档等资源skills/ └── my-skill/ ├── SKILL.md # 必需技能描述与提示词 ├── scripts/ # 可选脚本资源 │ ├── analyze.py # Python 脚本Agent 可调用 execute 工具运行 │ └── fetch.sh # Shell 脚本 ├── references/ # 可选参考文档 │ ├── api-spec.yaml # API 规范 │ └── examples.json # 示例数据 └── config.toml # 可选配置文件文件大小限制单文件≤ 10 MB单技能总大小≤ 100 MB。在源码层面技能目录的扫描通过GlobInfo以*/SKILL.md模式完成backend/agent/skill_backend.go即以skills/为 baseDir只匹配一级子目录下的SKILL.md与文档描述的「一级子目录」约束完全一致若skills/目录不存在或 glob 失败则视为无技能不阻塞 Agent。四、SKILL.md 格式规范SKILL.md是技能的核心文件包含技能的元数据和工作指引。文件由两部分组成YAML FrontMatter---之间的部分技能元数据中间件启动时解析Markdown 正文---之后技能的完整提示词AI 调用技能时才加载。建议格式如下--- name: 技能名称 description: 技能的简短描述AI 通过它判断是否激活本技能 context: fork # 可选执行模式fork / fork_with_context / 不设inline agent: sub-agent-name # 可选fork 模式下使用的子 Agent 名需配置 AgentHub model: deepseek-chat # 可选覆盖默认模型inline 下切换后续对话模型fork 下传给子 Agent --- # 技能名称 ## 技能说明 在此处编写 AI 应当遵循的工作流程、分析框架、输出格式要求等。 这部分内容只在 AI 调用 skill 工具时才会被加载到上下文渐进式展示。 ## 工作流程 1. 步骤一 2. 步骤二 3. 步骤三 ## 资源引用 - scripts/analyze.py数据预处理脚本 - references/api-spec.yamlAPI 接口规范FrontMatter 字段说明字段类型必需说明namestring是技能显示名称也是skill工具调用的参数值descriptionstring是技能描述AI 据此自主判断是否调用本技能不是关键词匹配contextstring否执行模式fork新子 Agent 无历史/fork_with_context新子 Agent 带历史/ 不设inline默认结果返回主对话agentstring否fork 模式下使用的子 Agent 名需配置 AgentHubgo-stock 当前未配置留空即可modelstring否覆盖默认模型名。inline 下后续 ChatModel 请求切换到该模型fork 下传给子 Agent 关键提示没有trigger_keywords字段。技能激活完全由 AI 根据description自主判断不是关键词匹配description应当清晰描述技能的适用场景例如「提供 K 线形态识别、技术指标解读、买卖点判断」比「技术分析」更有效FrontMatter 之外的正文内容启动时不加载仅在 AI 调用skill工具时才注入上下文。从源码看frontmatter 的解析逻辑backend/agent/skill_backend.go要求文件必须以---分隔符开头并在后续内容中找到\n---作为结束分隔符否则解析失败frontmatter与正文内容分别提取后正文经strings.TrimSpace处理作为Skill.Contentbackend/agent/skill_backend.go。此外还包含一个stripSkillLineNumbers兼容处理backend/agent/skill_backend.go某些文件系统后端会在每行前加「行号\t」前缀此处会剥离首个制表符之前的内容。五、界面介绍技能管理技能管理界面位于「研究中心」→「技能管理」对应前端组件 frontend/src/components/skill-manager.vue包含三个主要区域。5.1 工具栏按钮说明 导入技能包从.zip文件导入技能到skills/目录 刷新重新扫描skills/目录更新技能列表从 frontend/src/components/skill-manager.vue 可以看到工具栏还包含「技能广场」按钮可在线获取技能包以及技能卡片上的启用/停用开关handleToggleSkill卡片会展示技能名称缺失时回退到目录名与「已停用」标签。5.2 技能列表表格列说明技能名称取自SKILL.md的name字段或目录名目录技能在skills/下的目录名带文件夹图标描述技能的简短描述操作「编辑」打开文件编辑器、「删除」移除整个技能目录5.3 文件编辑器弹窗点击技能的「编辑」按钮后弹出采用左右分栏布局。左侧文件树「新建文件」按钮输入路径如scripts/run.py或config.yaml即可创建文件列表默认展开所有目录点击文件名切换编辑。右侧编辑器顶部当前文件路径标签 「保存」按钮 「删除文件」按钮SKILL.md不可删除编辑器.md文件 →MdEditor支持实时预览、工具栏.py/.pyw→CodeMirror 6Python 语法高亮.yaml/.yml→CodeMirror 6YAML 语法高亮.json→CodeMirror 6JSON 语法高亮其他扩展名 →CodeMirror 6无语法高亮但保留行号、Tab 缩进、括号匹配等基础能力。编辑器主题自动跟随应用主题亮色/暗色暗色下使用oneDark主题。六、使用流程6.1 导入技能包从其他网站或社区下载的技能包通常为.zip格式导入步骤点击工具栏「导入技能包」按钮在弹出的文件选择对话框中选中.zip文件系统自动校验并解压到skills/目录。ZIP 包格式要求必须包含SKILL.md文件否则提示「不是有效的技能包」支持两种结构扁平结构SKILL.md在 zip 根目录技能名取自 zip 文件名my-skill.zip ├── SKILL.md └── scripts/analyze.py嵌套结构SKILL.md在子目录中技能名取自第一级目录名my-skill.zip └── my-skill/ ├── SKILL.md └── scripts/analyze.py安全限制禁止包含..路径防 zip slip 攻击单文件 ≤ 10 MB总计 ≤ 100 MB若同名技能已存在先删除再覆盖导入。⚠️ 提示技能包导入后存放于skills/目录该目录位于应用工作目录go-stock 根目录下。这一点与源码中buildSkillMiddleware的skillsDir : filepath.Join(rootDir, skills)backend/agent/agent.go一致——DeepAgents 的文件系统沙箱根即应用可执行文件所在目录。6.2 在线编辑技能文件在技能列表中点击目标技能的「编辑」按钮弹窗左侧文件树中点击要编辑的文件右侧编辑器加载文件内容修改后点击顶部「保存」按钮写入文件系统。编辑器快捷操作Tab键缩进Python 文件默认 4 空格支持CtrlF查找替换CodeMirror 内置行号、括号匹配、自动缩进CodeMirror basicSetup。6.3 新建文件在文件编辑器左侧点击「新建文件」按钮输入文件路径如scripts/run.py或config.yaml按回车或点击「确定」文件创建后自动选中新文件。路径规则使用/作为路径分隔符支持创建子目录如scripts/utils/helper.py不允许包含..。6.4 删除文件在文件树中选中要删除的文件点击顶部「删除文件」按钮在确认弹窗中点击「确定」。⚠️SKILL.md是技能的必需文件不可删除。删除按钮对SKILL.md不显示。6.5 删除技能在技能列表中点击目标技能的「删除」按钮在确认弹窗中点击「确定」整个技能目录含所有文件从文件系统移除。⚠️ 删除操作不可恢复请谨慎操作。七、与 Agent 的集成7.1 自动加载技能在 DeepAgents 模式下提问时技能中间件的工作流程用户提问 ↓ Agent 读取 skills/ 下所有技能的元数据 ↓ 判断问题是否匹配某技能的 description ↓ 匹配 → 加载该技能的 SKILL.md 完整内容到上下文 ↓ Agent 按 SKILL.md 中的工作流执行任务 ↓ 需要时通过 execute 工具运行 scripts/ 下的脚本 需要时通过 read_file 工具读取 references/ 下的文档在源码层面「启动时扫描 → 判断是否注册中间件」发生在 backend/agent/agent.go 的buildSkillMiddleware先用容错后端List所有可用技能若len(matters) 0目录不存在或无可用技能则返回 nil、不注册中间件否则通过skill.NewMiddleware(ctx, skill.Config{Backend: fileBackend})创建中间件并挂载到 DeepAgents 的 handlers 中。激活后skill工具会以nameFrontMatter 字段作为参数值按名获取技能——对应tolerantSkillBackend.Get的实现backend/agent/skill_backend.go。7.2 Agent 可用的技能资源DeepAgents 模式下Agent 拥有文件系统和 Shell 工具工具用途ls列出目录内容read_file读取文件write_file写入文件edit_file编辑文件glob文件名模式匹配grep文件内容搜索execute执行 Shell 命令如运行 Python 脚本Agent 可以通过这些工具读取或运行技能内的脚本与参考文档。这些能力来自 go-stock 自实现的沙箱化文件系统 Backend backend/agent/tools/filesystem_backend.go它以rootDir为沙箱根所有路径操作均通过resolve校验防止路径穿越支持 POSIX 与 Windows 两种路径风格并解析软链接后校验是否越界backend/agent/tools/filesystem_backend.goGrepRaw使用 Go 标准库 regexpRE2 语法与 ripgrep 高度兼容实现文件内容搜索backend/agent/tools/filesystem_backend.goGlobInfo使用bmatcuk/doublestar/v4支持**递归匹配backend/agent/tools/filesystem_backend.go。7.3 技能示例技术分析助手SKILL.md--- name: 技术分析助手 description: 提供 K 线形态识别、技术指标解读、买卖点判断的专业分析框架 --- # 技术分析助手 ## 分析流程 1. 调用 GetEastMoneyKLine 获取最近 60 日 K 线数据 2. 调用 GetEastMoneyKLineWithMA 计算 5/10/20/60 日均线 3. 识别 K 线形态锤头线、十字星、吞没形态等 4. 计算 MACD、RSI、KDJ 指标 5. 综合判断买卖信号 ## 输出格式 | 指标 | 数值 | 信号 | |------|------|------| | ... | ... | ... |scripts/calc_indicators.py# 技术指标计算脚本可被 Agent 通过 execute 工具调用 def calc_macd(closes, fast12, slow26, signal9): # MACD 计算 pass该示例中调用的GetEastMoneyKLine、GetEastMoneyKLineWithMA等工具是 go-stock 内置的东方财富 K 线数据接口参见 backend/data/eastmoney_kline_api.go 相关实现Agent 在 DeepAgents 模式下可以像调用普通工具一样获取真实行情数据再结合技能提示词里的分析框架完成计算与判断。八、常见问题FAQQ1技能管理菜单在哪技能管理位于「研究中心」→「技能管理」。Q2导入的技能包为什么显示不出来确认.zip文件中包含SKILL.md检查SKILL.md是否在 zip 根目录或第一级子目录中点击「刷新」按钮重新扫描技能目录查看skills/目录是否被正确创建通常位于应用工作目录下。Q3技能在 React / PlanExecute 模式下为什么不生效技能系统仅在 DeepAgents 模式下启用。在 AI 智能体页面底部的 Agent 模式选择器中切换到 DeepAgents模式即可。Q4如何调试技能没有被 AI 激活的问题检查SKILL.md的description是否清晰描述了技能的适用场景例如「提供 K 线形态识别、技术指标解读」比「技术分析」更有效在提问时显式包含技能相关关键词查看应用日志确认技能中间件是否加载成功搜索 skill 中间件 关键字。注意若存在格式错误的技能包日志会出现skill 中间件: 跳过格式错误的技能文件警告来源 backend/agent/skill_backend.go此时应优先修复该技能包的 frontmatter如name字段被误写为 YAML 列表导致cannot unmarshal !!seq into string。Q5技能中的 Python 脚本如何被 Agent 调用Agent 通过execute工具运行命令例如execute(commandpython skills/my-skill/scripts/analyze.py --code sh600519)DeepAgents 模式下子进程控制台窗口会自动隐藏输出通过流式方式返回给 Agent对应源码 backend/agent/tools/streaming_shell.go 的流式 Shell 实现。Q6技能支持哪些文件类型技能目录可包含任意文件类型。编辑器对以下类型提供语法高亮扩展名编辑器高亮.mdMdEditorMarkdown 实时预览.py/.pywCodeMirror 6Python.yaml/.ymlCodeMirror 6YAML.jsonCodeMirror 6JSON其他CodeMirror 6无高亮保留基础编辑能力Q7技能目录在文件系统中的位置技能目录默认位于应用工作目录下的skills/子目录。可通过应用文件管理器直接访问该目录进行批量管理。从源码看DeepAgents 的文件系统沙箱根deepAgentRootDir()为可执行文件所在目录桌面应用启动时即 go-stock 根目录skills目录即rootDir/skillsbackend/agent/agent.go。Q8能否同时启用多个技能可以。DeepAgents 模式下AI 根据问题内容判断需要哪些技能可同时加载多个技能的提示词到上下文。但建议避免技能之间描述重叠过大以免 AI 难以判断该激活哪个。Q9如何分享自己创建的技能将skills/技能名/目录打包为.zip文件确保包含SKILL.md分享给其他用户他们通过「导入技能包」按钮即可导入。Q10技能目录已存在时导入会怎样如果同名技能目录已存在系统会先删除原目录再覆盖导入。如需保留原内容请先在编辑器中备份。九、补充数据库中另有一套技能模型延伸阅读需要说明的是go-stock 的技能体系包含两条线本文主体讲述的文件系统技能skills/技能名/SKILL.md由 eino skill 中间件驱动以及仓库中另有一套基于数据库的技能模型models.Skillbackend/models/models.go表名skills字段包括名称、分类、系统提示词SystemPrompt、示例对话Examples、触发关键词TriggerKeywords、绑定的 MCP 服务器 IDMCPServerIDs、启用状态与排序值其 CRUD 由 backend/data/skill_api.go 提供并封装为ListSkills、CreateSkill、UpdateSkill、EnableSkill等 Agent 工具backend/agent/tools/mcp_skill_tools.go。从 backend/agent/agent.go 的注释「构建 skill 中间件组合文件系统技能SKILL.md与数据库技能models.Skill」可以推断两者在 DeepAgents 中会被共同纳入技能中间件体系。若你在界面上看到技能有「分类」「触发关键词」「绑定 MCP 服务」等字段即对应这套数据库模型而本文的SKILL.md文件技能则强调「没有trigger_keywords字段、完全靠 AI 自主判断」使用时请注意区分。结语技能系统是 go-stock 在 AI 股票分析场景下的关键基础设施它以SKILL.md为最小单元通过渐进式展示把复杂的领域专业知识、工作流脚本和参考文档以极低的常驻 token 成本注入 DeepAgents 的上下文配合容错后端与沙箱化文件系统既保证了单个坏技能不会拖垮整个 Agent又让 AI 具备读取脚本、执行命令的完整工程能力。掌握技能包的编写、导入与调试方法你就能把「K 线形态识别」「财务分析框架」「资讯研究流程」等经验沉淀为可复用、可分享的技能让 go-stock 的 AI 助手真正贴合自己的分析习惯。赞分享人工智能大模型AI 应用AI AgentRAG金融科技桌面应用MCP Clients【免费下载链接】go-stockAI赋能股票分析AI加持的股票分析/选股工具。股票行情获取AI热点资讯分析AI资金/财务分析涨跌报警推送。支持A股港股美股。支持市场整体/个股情绪分析AI辅助选股等。数据全部保留在本地。支持DeepSeekOpenAI OllamaLMStudioAnythingLLM硅基流动火山方舟阿里云百炼等平台或模型。项目地址https://gitcode.com/gh_mirrors/go/go-stock点击查看免费下载相关推荐终极指南用NetDXF掌握DWG文件处理的艺术在当今数字化设计领域CAD工程师和.NET开发者经常面临一个共同的挑战如何在应用程序中高效处理DWG文件格式。传统的解决方案要么过于复杂要么功能有限让开人工智能AI AgentAgent 框架后端多智能体RAG工具调用Agent 记忆Agent 工作流AI 评测MCP 服务MCP Clients语音IronClaw 技能自进化基于 SKILL.md 细化Refinement机制的技能持续改进实战指南IronClaw 技能自进化基于 SKILL.md 细化Refinement机制的技能持续改进实战指南 IronClaw 的 ironclaw_skill人工智能AI 应用交互助手AI Agentbook-to-skill深度解析Token预算矩阵BOOK_TYPE×DEPTH如何决定章节深度book to skill深度解析Token预算矩阵BOOK_TYPE×DEPTH如何决定章节深度 book to skill 能把 PDF、EPUB、DOCAI 技能上一篇EasyEffects 中的 Crusher 比特粉碎器插件参数详解、预设格式与源码实现剖析下一篇Arduino ESP32 安装指南在 Arduino IDE 中配置开发板包并验证烧录环境创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考