【免费下载链接】agnes-harnessAgnes Harness: A pluggable agent harness for Forward Deployed Engineering (FDE). Built for trust. Made for the real world.项目地址https://gitcode.com/gh_mirrors/ag/agnes-harness点击查看免费下载Agnes Harness简称 AGH是一个面向 Forward Deployed EngineeringFDE的可插拔 Agent 框架它的 Skills 系统可以把项目约定、检查步骤、常用方法沉淀为可复用的技能文件让 Agent 在每次任务中自动按团队的标准来干活。这篇 Agnes Harness Skills 完整指南带你从零创建一个 Skill理解它的来源优先级、信任审核与启用流程并学会在 Web 和命令行中管理这些技能资产。 为什么需要 Skills让 Agent 记住团队打法用过大模型 Agent 的人都遇到过同样的问题每个会话都要重新交代一遍我们代码怎么审查、文档怎么组织、提交前跑哪些检查。Skills 就是解决这个痛点的机制——把一次性的口头交代变成磁盘上可复用、可审核、可版本管理的技能文件。在 AGH 里一个 Skill 本质上是一份带元信息的 Markdown 说明SKILL.mdname技能名Agent 靠它被点名调用description一句话描述适用场景Agent 靠它判断这个任务该不该用我正文具体的操作步骤、边界约束例如只提建议不写文件需要特别理解的一点Skill 提供的是任务说明与知识不等于执行权限。AGH 会先发现候选、审核版本、解析同名胜出项再向会话暴露可用内容——不能只因为磁盘上存在文件就认为模型已经读取了它。这套发现 → 信任 → 启用 → 就绪的生命周期是 AGH Skills 与普通提示词模板最大的区别。 快速上手创建第一个工作区 SkillSkill 不需要写在 AGH 源码库里而是放在你自己的项目里。在目标项目创建.agh/skills/review-notes/SKILL.md内容形如--- name: review-notes description: 只读整理项目说明中的不一致之处 --- 先读取 README 与相关说明列出互相冲突的描述和对应文件。 只提出修改建议不写文件不安装依赖。frontmatter 的解析与校验规则名称最长 128 字符、描述最长 1024 字符、静态 YAML 检查在 frontmatter.ts 中实现。创建之后在 Web 端为该项目创建会话进入设置 → Skills管理刷新对应工作区核对来源和内容修订revision再点击启用。Web 会先完成版本审核不再单独显示信任动作开关跟随你的启用请求——请求过启用它就保持打开即使 Skill 没能加载起来失败原因也会显示在同一行。用命令行同样可以查看和管理底层状态node packages/cli/dist/local/agnes.mjs resources list --kind skill node packages/cli/dist/local/agnes.mjs skills refresh --root-key workspace-agnes --workspace-id WORKSPACE_ID node packages/cli/dist/local/agnes.mjs skills trust SKILL_RESOURCE_ID REVISION trusted node packages/cli/dist/local/agnes.mjs resources enable SKILL_RESOURCE_ID --expected-revision REVISION确认trusttrusted、desiredenabled、actualready以及winner都符合预期后在会话里明确说使用 review-notes 整理项目说明即可触发。当会话中明确提名且唯一匹配一个可用 Skill 时Host 有预加载路径见 skill-preload.ts模糊的描述则不是确定性的激活语法此时 Agent 会依据技能目录自行匹配并调用skill_read工具读取。️ Skills 从哪来7 个来源与优先级规则AGH 会从多个磁盘位置发现 Skill默认优先级如下数字越大越优先定义在 discover.ts 的FIVE_SKILL_ROOTS来源默认优先级说明工作区.agh/skills500当前项目专属最优先Cordis 运行时贡献450受信插件动态注册AGH_HOME/skills400AGH 用户级技能库用户~/.agents/skills300跨工具共享可能影响其他应用用户~/.claude/skills200兼容 Claude 生态用户~/.codex/skills100兼容 Codex 生态包贡献50随插件分发的技能几个关键行为值得注意同名解析名字按去除首尾空白、忽略大小写分组非删除候选按优先级降序排列同分再按sourceId排序胜出者称为winner。不会自动降级高优先级项未信任、被拒绝或停用时不会仅因不可用就自动选择低优先级项——这是刻意设计避免你以为在用的技能悄悄换了个版本。多工作区隔离每个会话按自己的工作区读取不用 worker 启动目录替代WORKSPACE_ID是 64 位十六进制标识不要把路径或别的会话 ID 填进去。修改要重新审核磁盘内容改变后需要重新核对 revision 与信任刷新失败留下的 stale 内容不能当作本次扫描成功。⚖️ 同名技能冲突如何调整优先级当工作区技能500和用户技能400同名时想让低优先级的一方胜出可以在 Web 的设置 → Skills中打开 Skill 详情查看来源、当前 winner、被覆盖候选和有效优先级然后在同名覆盖优先级输入 50–500 的整数并保存。比如要把AGH_HOME/skills的用户候选顶掉工作区候选可以把工作区项降到 350。注意两点它只改变该 resourceId 在当前 profile 中的持久覆盖不改文件内容也不会启用 Skill保存成功后还要重新查看 winner 与 actual若新 winner 尚未启用需审核后再启用。需要恢复默认时通过 Node 客户端传入priority: nullclient.skills.prioritySet。这些管理动作需要 admin authority 与resources.skills.write权限合同定义见 resource-control.ts持久控制与删除标记在 skills.ts。 用 Skill Helper 批量导入GitHub 仓库、ZIP、本地目录手写之外AGH 随版本附带了官方的agnes/skill-helper插件在 Web 的插件管理页可以看到它默认安装并启用Skill Helper 提供四个工具skill_helper_import/skill_helper_creator/skill_helper_create/skill_helper_install支持导入本地 Skill 目录离线即可导入 GitHub 公共仓库或子目录需要网络走受限的公共网络策略导入本地 ZIP 文件或 HTTPS 原始 Markdown 清单从模型输出生成新的 Skill 文件可附官方 skill-creator 编写指引它的安全边界同样值得了解不覆盖已有不同内容的技能、不支持私有仓库登录、不执行第三方脚本、归档包超过 2 MiB 限制时需改走本地 ZIP 导入。详细说明见 skill-helper/README.md。️ 进阶让插件在运行时贡献 Skill如果你在做插件开发受信插件可以声明inject: [skills]在apply阶段注册运行时技能ctx.skills.register({ name: review-notes, description: 只读整理说明冲突, body: 读取相关说明列出矛盾与证据不修改文件。, })register()返回 disposer注册随调用方 fiber 清理动态集合用registerProvider数据变化后调用control.invalidate()。与磁盘技能不同运行时贡献不进入 trust/desired 管理流程其信任来自受信代码本身。更多插件开发内容见 插件开发文档。 日常维护与安全须知最后几个实操要点能帮你避免大部分运维坑停用 vs 删除需要暂时停用时选停用。永久删除会删除选中的 Skill 目录及其中全部文件不是移入回收站且删除操作受理后不支持取消、重启也不是撤销。用户目录是共享的~/.claude/skills等目录可能被其他应用共用删除前先想清楚影响面。操作要留痕保存 operation ID 并等待状态succeeded再核对结果API 返回 receipt 仅表示受理。失败不要盲重试报告SKILL_REMOVAL_PENDING时条目已被阻止重新启用排除文件占用等原因后再显式重试。扫描限额每个来源根最多 128 个条目、单文件 256 KiB、根目录总量 2 MiB超限的候选会被跳过并记录原因而不是让整个扫描失败。Skills 的运行时行为——技能目录catalog如何注入提示词、skill_read与skill_read_file工具的分页读取——在 runtime.ts 中实现候选注册与同名胜出解析在 resource-control-runtime/src/skills.ts。 延伸资料官方 Skills 指南docs/guide/skills.zh-CN.mdSkill 发现逻辑源码packages/base/extensions/skills/src/discover.ts技能预加载packages/host/src/resources/skill-preload.ts插件开发总览docs/develop/plugins.zh-CN.md包管理生命周期安装/信任/更新/回滚docs/guide/packages.zh-CN.md把团队的检查清单、代码规范、排障手册写成 Skill 放进.agh/skills/从下一个会话开始你的 Agent 就会带着团队的肌肉记忆开工——这正是 Agnes Harness Skills 的核心价值方法论不再依赖口口相传而是变成可复用、可审核、随项目分发的技能资产。赞分享【免费下载链接】agnes-harnessAgnes Harness: A pluggable agent harness for Forward Deployed Engineering (FDE). Built for trust. Made for the real world.项目地址https://gitcode.com/gh_mirrors/ag/agnes-harness点击查看免费下载相关推荐cangjie-skill完全指南如何把书和长视频里的方法论变成Agent真正能调用的AI Skillscangjie skill完全指南如何把书和长视频里的方法论变成Agent真正能调用的AI Skills cangjie skill 是一个开源的内容蒸馏AI 技能ai-agent-skills 团队共享完全指南把技能库变成 Git 仓库一行命令分享给同事ai agent skills 团队共享完全指南把技能库变成 Git 仓库一行命令分享给同事 ai agent skills 是一款面向 AI codingAI 技能开发工具人工智能openJiuwen Swarm Skills把一次成功协作沉淀成可复用团队能力openJiuwen Swarm Skills把一次成功协作沉淀成可复用团队能力 导读 Agent Skills 解决的是一个 Agent 如何完成一类任务人工智能大模型AI Agent工具调用工作流编排提示工程上一篇深入解析Apple Darwin-XNU内核启动序列下一篇EnTT实体组件系统实战注册表、实体与组件操作创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/23 4:07:37 · 阅读 1.2k Agnes Harness Skills完全指南：把团队的方法论变成Agent可复用的技能
【免费下载链接】agnes-harnessAgnes Harness: A pluggable agent harness for Forward Deployed Engineering (FDE). Built for trust. Made for the real world.项目地址https://gitcode.com/gh_mirrors/ag/agnes-harness点击查看免费下载Agnes Harness简称 AGH是一个面向 Forward Deployed EngineeringFDE的可插拔 Agent 框架它的 Skills 系统可以把项目约定、检查步骤、常用方法沉淀为可复用的技能文件让 Agent 在每次任务中自动按团队的标准来干活。这篇 Agnes Harness Skills 完整指南带你从零创建一个 Skill理解它的来源优先级、信任审核与启用流程并学会在 Web 和命令行中管理这些技能资产。 为什么需要 Skills让 Agent 记住团队打法用过大模型 Agent 的人都遇到过同样的问题每个会话都要重新交代一遍我们代码怎么审查、文档怎么组织、提交前跑哪些检查。Skills 就是解决这个痛点的机制——把一次性的口头交代变成磁盘上可复用、可审核、可版本管理的技能文件。在 AGH 里一个 Skill 本质上是一份带元信息的 Markdown 说明SKILL.mdname技能名Agent 靠它被点名调用description一句话描述适用场景Agent 靠它判断这个任务该不该用我正文具体的操作步骤、边界约束例如只提建议不写文件需要特别理解的一点Skill 提供的是任务说明与知识不等于执行权限。AGH 会先发现候选、审核版本、解析同名胜出项再向会话暴露可用内容——不能只因为磁盘上存在文件就认为模型已经读取了它。这套发现 → 信任 → 启用 → 就绪的生命周期是 AGH Skills 与普通提示词模板最大的区别。 快速上手创建第一个工作区 SkillSkill 不需要写在 AGH 源码库里而是放在你自己的项目里。在目标项目创建.agh/skills/review-notes/SKILL.md内容形如--- name: review-notes description: 只读整理项目说明中的不一致之处 --- 先读取 README 与相关说明列出互相冲突的描述和对应文件。 只提出修改建议不写文件不安装依赖。frontmatter 的解析与校验规则名称最长 128 字符、描述最长 1024 字符、静态 YAML 检查在 frontmatter.ts 中实现。创建之后在 Web 端为该项目创建会话进入设置 → Skills管理刷新对应工作区核对来源和内容修订revision再点击启用。Web 会先完成版本审核不再单独显示信任动作开关跟随你的启用请求——请求过启用它就保持打开即使 Skill 没能加载起来失败原因也会显示在同一行。用命令行同样可以查看和管理底层状态node packages/cli/dist/local/agnes.mjs resources list --kind skill node packages/cli/dist/local/agnes.mjs skills refresh --root-key workspace-agnes --workspace-id WORKSPACE_ID node packages/cli/dist/local/agnes.mjs skills trust SKILL_RESOURCE_ID REVISION trusted node packages/cli/dist/local/agnes.mjs resources enable SKILL_RESOURCE_ID --expected-revision REVISION确认trusttrusted、desiredenabled、actualready以及winner都符合预期后在会话里明确说使用 review-notes 整理项目说明即可触发。当会话中明确提名且唯一匹配一个可用 Skill 时Host 有预加载路径见 skill-preload.ts模糊的描述则不是确定性的激活语法此时 Agent 会依据技能目录自行匹配并调用skill_read工具读取。️ Skills 从哪来7 个来源与优先级规则AGH 会从多个磁盘位置发现 Skill默认优先级如下数字越大越优先定义在 discover.ts 的FIVE_SKILL_ROOTS来源默认优先级说明工作区.agh/skills500当前项目专属最优先Cordis 运行时贡献450受信插件动态注册AGH_HOME/skills400AGH 用户级技能库用户~/.agents/skills300跨工具共享可能影响其他应用用户~/.claude/skills200兼容 Claude 生态用户~/.codex/skills100兼容 Codex 生态包贡献50随插件分发的技能几个关键行为值得注意同名解析名字按去除首尾空白、忽略大小写分组非删除候选按优先级降序排列同分再按sourceId排序胜出者称为winner。不会自动降级高优先级项未信任、被拒绝或停用时不会仅因不可用就自动选择低优先级项——这是刻意设计避免你以为在用的技能悄悄换了个版本。多工作区隔离每个会话按自己的工作区读取不用 worker 启动目录替代WORKSPACE_ID是 64 位十六进制标识不要把路径或别的会话 ID 填进去。修改要重新审核磁盘内容改变后需要重新核对 revision 与信任刷新失败留下的 stale 内容不能当作本次扫描成功。⚖️ 同名技能冲突如何调整优先级当工作区技能500和用户技能400同名时想让低优先级的一方胜出可以在 Web 的设置 → Skills中打开 Skill 详情查看来源、当前 winner、被覆盖候选和有效优先级然后在同名覆盖优先级输入 50–500 的整数并保存。比如要把AGH_HOME/skills的用户候选顶掉工作区候选可以把工作区项降到 350。注意两点它只改变该 resourceId 在当前 profile 中的持久覆盖不改文件内容也不会启用 Skill保存成功后还要重新查看 winner 与 actual若新 winner 尚未启用需审核后再启用。需要恢复默认时通过 Node 客户端传入priority: nullclient.skills.prioritySet。这些管理动作需要 admin authority 与resources.skills.write权限合同定义见 resource-control.ts持久控制与删除标记在 skills.ts。 用 Skill Helper 批量导入GitHub 仓库、ZIP、本地目录手写之外AGH 随版本附带了官方的agnes/skill-helper插件在 Web 的插件管理页可以看到它默认安装并启用Skill Helper 提供四个工具skill_helper_import/skill_helper_creator/skill_helper_create/skill_helper_install支持导入本地 Skill 目录离线即可导入 GitHub 公共仓库或子目录需要网络走受限的公共网络策略导入本地 ZIP 文件或 HTTPS 原始 Markdown 清单从模型输出生成新的 Skill 文件可附官方 skill-creator 编写指引它的安全边界同样值得了解不覆盖已有不同内容的技能、不支持私有仓库登录、不执行第三方脚本、归档包超过 2 MiB 限制时需改走本地 ZIP 导入。详细说明见 skill-helper/README.md。️ 进阶让插件在运行时贡献 Skill如果你在做插件开发受信插件可以声明inject: [skills]在apply阶段注册运行时技能ctx.skills.register({ name: review-notes, description: 只读整理说明冲突, body: 读取相关说明列出矛盾与证据不修改文件。, })register()返回 disposer注册随调用方 fiber 清理动态集合用registerProvider数据变化后调用control.invalidate()。与磁盘技能不同运行时贡献不进入 trust/desired 管理流程其信任来自受信代码本身。更多插件开发内容见 插件开发文档。 日常维护与安全须知最后几个实操要点能帮你避免大部分运维坑停用 vs 删除需要暂时停用时选停用。永久删除会删除选中的 Skill 目录及其中全部文件不是移入回收站且删除操作受理后不支持取消、重启也不是撤销。用户目录是共享的~/.claude/skills等目录可能被其他应用共用删除前先想清楚影响面。操作要留痕保存 operation ID 并等待状态succeeded再核对结果API 返回 receipt 仅表示受理。失败不要盲重试报告SKILL_REMOVAL_PENDING时条目已被阻止重新启用排除文件占用等原因后再显式重试。扫描限额每个来源根最多 128 个条目、单文件 256 KiB、根目录总量 2 MiB超限的候选会被跳过并记录原因而不是让整个扫描失败。Skills 的运行时行为——技能目录catalog如何注入提示词、skill_read与skill_read_file工具的分页读取——在 runtime.ts 中实现候选注册与同名胜出解析在 resource-control-runtime/src/skills.ts。 延伸资料官方 Skills 指南docs/guide/skills.zh-CN.mdSkill 发现逻辑源码packages/base/extensions/skills/src/discover.ts技能预加载packages/host/src/resources/skill-preload.ts插件开发总览docs/develop/plugins.zh-CN.md包管理生命周期安装/信任/更新/回滚docs/guide/packages.zh-CN.md把团队的检查清单、代码规范、排障手册写成 Skill 放进.agh/skills/从下一个会话开始你的 Agent 就会带着团队的肌肉记忆开工——这正是 Agnes Harness Skills 的核心价值方法论不再依赖口口相传而是变成可复用、可审核、随项目分发的技能资产。赞分享【免费下载链接】agnes-harnessAgnes Harness: A pluggable agent harness for Forward Deployed Engineering (FDE). Built for trust. Made for the real world.项目地址https://gitcode.com/gh_mirrors/ag/agnes-harness点击查看免费下载相关推荐cangjie-skill完全指南如何把书和长视频里的方法论变成Agent真正能调用的AI Skillscangjie skill完全指南如何把书和长视频里的方法论变成Agent真正能调用的AI Skills cangjie skill 是一个开源的内容蒸馏AI 技能ai-agent-skills 团队共享完全指南把技能库变成 Git 仓库一行命令分享给同事ai agent skills 团队共享完全指南把技能库变成 Git 仓库一行命令分享给同事 ai agent skills 是一款面向 AI codingAI 技能开发工具人工智能openJiuwen Swarm Skills把一次成功协作沉淀成可复用团队能力openJiuwen Swarm Skills把一次成功协作沉淀成可复用团队能力 导读 Agent Skills 解决的是一个 Agent 如何完成一类任务人工智能大模型AI Agent工具调用工作流编排提示工程上一篇深入解析Apple Darwin-XNU内核启动序列下一篇EnTT实体组件系统实战注册表、实体与组件操作创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考