尧图网页设计 
如何编写自定义 Skill扩展 PenguinHarness Agent 能力的完整指南【免费下载链接】penguin-harness Unified and Stable RSI Platform项目地址: https://gitcode.com/gh_mirrors/pe/penguin-harnessPenguinHarnessPenguinHarness 是一个本地优先的多智能体应用开发平台通过Skill技能机制让 Agent 按需学习新能力。一个 Skill 就是一个文件夹加一份SKILL.md指令文件——无需写代码用 Markdown 就能给 Agent 教会一套新的工作流、规范或工具用法。本文带你从零开始理解 Skill 的渐进加载原理、手写一个自定义 Skill、安装到 Agent并让它在 Benchmark 闭环中持续自我优化。Skill 是什么按需加载的指令包Skill 是一组可复用的指令Agent 只在任务真正需要时才去读取完整内容。它的设计核心是「先索引后正文」系统提示词中只注入每个 Skill 的名称和一行描述通过{{SKILL_METADATA}}占位符展开当 Agent 判断任务用得上某个 Skill 时才用read_file读取完整的SKILL.md正文这样几十个 Skill 也只占用很少的上下文 Token。这种机制与「钩子包」不同钩子是在 Agent 循环固定节点运行脚本而 Skill 是 Agent 自主阅读的说明书。两者都可以打包进一个「插件」官方说明见 skills.zh.md。三步手写一个自定义 Skill自定义 Skill 的存放位置在 Agent 的状态目录agent_state/skills/name/下整个流程只有三步创建目录agent_state/skills/name/。目录名就是 Skill 名称只能包含字母、数字、下划线和连字符匹配^[A-Za-z0-9_-]$。编写SKILL.md先写 frontmatter 元信息再写正文指令。补充引用文件正文里链接到的参考资料如reference/目录一并放入Agent 会按需跟进读取。最小可用的SKILL.md长这样--- name: my-skill description: One-line English description injected into the system prompt. --- # My Skill 具体的操作步骤、边界条件和验收标准……要点提醒frontmatter 的description用英文单行写因为它会被直接注入系统提示词——写清楚「什么时候该用这个 Skill」Agent 才能准确触发目录名是权威名称会覆盖 frontmatter 里的name字段没有SKILL.md的目录不算 Skill由于每次读取都直接访问磁盘文件你可以就地修改已安装的 Skill下次组装系统提示词即生效无需任何构建步骤。插件视角一个更完整的 Skill 结构如果你希望把 Skill 发布给更多用户需要将其组织成插件。插件目录结构如下官方仓库内置了二十多个插件全部位于plugins/目录下plugins/plugin/ ├── plugin.json # 插件清单描述、版本、分类、钩子声明 ├── icon.svg # 插件图标已安装的 Skill 会继承它 ├── skills/name/SKILL.md # 零个或多个 Skill └── hooks/*.mjs # 可选钩子脚本包plugins/README.md 给出了完整的插件库说明。以 plugins/agent-development/ 为例该插件包含penguin-sdk、unified-llm-api等四个 Skill其 SKILL.md 就是很好的写法范本frontmatter 描述写清了触发条件正文分节给出前置检查、配置步骤和交付标准。写 Skill 正文的实用建议明确触发边界何时用、何时不用例如「用户只调用 Skill 但未给任务时先询问再执行」给出可执行的步骤命令、路径、参数避免空泛描述定义验收标准什么算完成、完成时如何汇报引用而非堆砌长篇资料放进reference/子目录按需读取保持正文精炼。安装与在对话中调用 SkillSkill 有三种上线路径方式操作适用场景插件市场安装侧边栏「插件市场」→ 插件卡片 →管理安装→ 选 Agent 安装官方内置插件Zip 上传导入Agent 设置页「技能」标签 →导入技能→ 选择 zip第三方 Skill 包≤14 MB≤200 个文件对话导入填入网页、仓库或本地路径来源Agent 先审查再安装从其他生态移植 Skill安装后在消息输入框点击技能菜单或输入/ 名称即可指定使用某个 SkillAgent 会完整读取并遵循其指令。让 Skill 持续进化自我优化闭环自定义 Skill 写完不是终点。PenguinHarness 原生支持 Agent重写自己的SKILL.md形成评估—优化闭环结合 Benchmark 给 Agent 打分见 self-improvement.zh.md根据实测结果修改SKILL.md把version更新为当天日期加下一个序号格式YYYY.MM.DD.N每轮修改前自动留快照每个请求都能在 Trace 视图追溯。装上continual-learning插件后一个运行超过 30 轮的长任务结束时后台子 Agent 还会自动把有长期价值的发现沉淀进相关SKILL.md——Agent 会边干活边给自己「记笔记」。常见问题QSkill 和系统提示词有什么区别系统提示词常驻上下文Skill 默认只注入一行描述正文按需读取因此可以安装几十个 Skill 而几乎不增加成本。Q修改 Skill 需要重启吗不需要。文件就是唯一事实来源每次读取直接访问磁盘就地修改即时生效。Q导入的 Skill 安全吗通过对话导入时Agent 会先完整读取并审查来源再安装通过 zip 导入则请只导入你信任的包。小结Skill 目录 SKILL.mdfrontmatter 描述 Markdown 正文目录名匹配^[A-Za-z0-9_-]$描述用英文单行写清触发条件插件市场安装、zip 导入、对话导入三条路径文件即事实来源可就地修改、可自我进化、可打包发布。现在打开你的 Agent创建第一个SKILL.md吧——用 Markdown 教 Agent 一项新能力比写代码快得多。【免费下载链接】penguin-harness Unified and Stable RSI Platform项目地址: https://gitcode.com/gh_mirrors/pe/penguin-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何编写自定义 Skill：扩展 PenguinHarness Agent 能力的完整指南
如何编写自定义 Skill扩展 PenguinHarness Agent 能力的完整指南【免费下载链接】penguin-harness Unified and Stable RSI Platform项目地址: https://gitcode.com/gh_mirrors/pe/penguin-harnessPenguinHarnessPenguinHarness 是一个本地优先的多智能体应用开发平台通过Skill技能机制让 Agent 按需学习新能力。一个 Skill 就是一个文件夹加一份SKILL.md指令文件——无需写代码用 Markdown 就能给 Agent 教会一套新的工作流、规范或工具用法。本文带你从零开始理解 Skill 的渐进加载原理、手写一个自定义 Skill、安装到 Agent并让它在 Benchmark 闭环中持续自我优化。Skill 是什么按需加载的指令包Skill 是一组可复用的指令Agent 只在任务真正需要时才去读取完整内容。它的设计核心是「先索引后正文」系统提示词中只注入每个 Skill 的名称和一行描述通过{{SKILL_METADATA}}占位符展开当 Agent 判断任务用得上某个 Skill 时才用read_file读取完整的SKILL.md正文这样几十个 Skill 也只占用很少的上下文 Token。这种机制与「钩子包」不同钩子是在 Agent 循环固定节点运行脚本而 Skill 是 Agent 自主阅读的说明书。两者都可以打包进一个「插件」官方说明见 skills.zh.md。三步手写一个自定义 Skill自定义 Skill 的存放位置在 Agent 的状态目录agent_state/skills/name/下整个流程只有三步创建目录agent_state/skills/name/。目录名就是 Skill 名称只能包含字母、数字、下划线和连字符匹配^[A-Za-z0-9_-]$。编写SKILL.md先写 frontmatter 元信息再写正文指令。补充引用文件正文里链接到的参考资料如reference/目录一并放入Agent 会按需跟进读取。最小可用的SKILL.md长这样--- name: my-skill description: One-line English description injected into the system prompt. --- # My Skill 具体的操作步骤、边界条件和验收标准……要点提醒frontmatter 的description用英文单行写因为它会被直接注入系统提示词——写清楚「什么时候该用这个 Skill」Agent 才能准确触发目录名是权威名称会覆盖 frontmatter 里的name字段没有SKILL.md的目录不算 Skill由于每次读取都直接访问磁盘文件你可以就地修改已安装的 Skill下次组装系统提示词即生效无需任何构建步骤。插件视角一个更完整的 Skill 结构如果你希望把 Skill 发布给更多用户需要将其组织成插件。插件目录结构如下官方仓库内置了二十多个插件全部位于plugins/目录下plugins/plugin/ ├── plugin.json # 插件清单描述、版本、分类、钩子声明 ├── icon.svg # 插件图标已安装的 Skill 会继承它 ├── skills/name/SKILL.md # 零个或多个 Skill └── hooks/*.mjs # 可选钩子脚本包plugins/README.md 给出了完整的插件库说明。以 plugins/agent-development/ 为例该插件包含penguin-sdk、unified-llm-api等四个 Skill其 SKILL.md 就是很好的写法范本frontmatter 描述写清了触发条件正文分节给出前置检查、配置步骤和交付标准。写 Skill 正文的实用建议明确触发边界何时用、何时不用例如「用户只调用 Skill 但未给任务时先询问再执行」给出可执行的步骤命令、路径、参数避免空泛描述定义验收标准什么算完成、完成时如何汇报引用而非堆砌长篇资料放进reference/子目录按需读取保持正文精炼。安装与在对话中调用 SkillSkill 有三种上线路径方式操作适用场景插件市场安装侧边栏「插件市场」→ 插件卡片 →管理安装→ 选 Agent 安装官方内置插件Zip 上传导入Agent 设置页「技能」标签 →导入技能→ 选择 zip第三方 Skill 包≤14 MB≤200 个文件对话导入填入网页、仓库或本地路径来源Agent 先审查再安装从其他生态移植 Skill安装后在消息输入框点击技能菜单或输入/ 名称即可指定使用某个 SkillAgent 会完整读取并遵循其指令。让 Skill 持续进化自我优化闭环自定义 Skill 写完不是终点。PenguinHarness 原生支持 Agent重写自己的SKILL.md形成评估—优化闭环结合 Benchmark 给 Agent 打分见 self-improvement.zh.md根据实测结果修改SKILL.md把version更新为当天日期加下一个序号格式YYYY.MM.DD.N每轮修改前自动留快照每个请求都能在 Trace 视图追溯。装上continual-learning插件后一个运行超过 30 轮的长任务结束时后台子 Agent 还会自动把有长期价值的发现沉淀进相关SKILL.md——Agent 会边干活边给自己「记笔记」。常见问题QSkill 和系统提示词有什么区别系统提示词常驻上下文Skill 默认只注入一行描述正文按需读取因此可以安装几十个 Skill 而几乎不增加成本。Q修改 Skill 需要重启吗不需要。文件就是唯一事实来源每次读取直接访问磁盘就地修改即时生效。Q导入的 Skill 安全吗通过对话导入时Agent 会先完整读取并审查来源再安装通过 zip 导入则请只导入你信任的包。小结Skill 目录 SKILL.mdfrontmatter 描述 Markdown 正文目录名匹配^[A-Za-z0-9_-]$描述用英文单行写清触发条件插件市场安装、zip 导入、对话导入三条路径文件即事实来源可就地修改、可自我进化、可打包发布。现在打开你的 Agent创建第一个SKILL.md吧——用 Markdown 教 Agent 一项新能力比写代码快得多。【免费下载链接】penguin-harness Unified and Stable RSI Platform项目地址: https://gitcode.com/gh_mirrors/pe/penguin-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考