treg skill install 安装共享技能：SKILL.md 配方+密钥+工具三位一体完整指南-平芜编程栈

treg skill install 安装共享技能：SKILL.md 配方+密钥+工具三位一体完整指南

【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg

treg skill install一条命令，把团队共享的技能"三位一体"拉进你的 AI 编程智能体——技能配方 SKILL.md 落到本地、API 密钥留在服务端、工具即插即用。treg 是面向 AI Agent 的工具注册中心（3600+ 端点、97 家供应商），本文将带你从零理解并上手这个共享技能体系，无需在本地管理任何凭证。

什么是"三位一体"技能？

在 treg 里，一个完整的技能（skill / bundle）由三部分组成，注册时原子性地打包在一起：

组件	作用	存放在哪里
📜配方（SKILL.md）	告诉 AI 智能体"怎么用这个工具"的操作手册	你的智能体技能目录（本地）
🔑密钥（secrets）	API Key / OAuth Token 等凭证	仅存服务端，只写不可读
🔧工具（tools）	上游 API 的 base_url + 凭证绑定	团队组织内共享

关键设计：密钥永远不会下发到你机器。队友把凭证和技能注册进团队后，你的智能体只需拿到"配方"文件，调用时由 treg 代理在服务端注入密钥并忠实转发请求。这就是 SKILL.md 配方、密钥、工具"三位一体"的含义——本地只有一份无敏感的说明书，能力却完整可用。

快速上手：5 步装好 treg 技能

先装好 CLI 并登录（只需一次，详见 src/treg/web/skill.md）：

curl -fsSL https://treg.to/install.sh | sh # 1. 安装 CLI treg login # 2. 浏览器登录（GitHub/Google/邮箱验证码） treg mcp install # 3. 把 treg 工具注册进当前智能体

然后安装共享技能：

treg skill ls # 查看团队注册了哪些技能 treg skill install seo-blog-writer # 安装指定技能 treg skill install --all # 一键安装团队全部技能

install会把配方写入.agents/skills/<name>/SKILL.md和.claude/skills/<name>/SKILL.md，智能体重启后即可自动发现并使用它。

常用安装参数一览

参数	效果
`--all`	安装当前团队的全部技能（重名自动去重）
`--agent cursor`	只装给某一个智能体（名称见`treg agents ls`）
`--all-agents`	扇出到所有已知智能体的技能目录
`--global`	写入智能体的全局目录而非当前项目
`--dir <路径>`	指定一个明确的目标目录（跳过自动扇出）
`--force`	覆盖本地已存在的 SKILL.md

⚠️保护你的手工修改：如果本地已有同名 SKILL.md，默认保留你的版本并提示差异；确认要换成团队版时才加--force。带工具的技能安装后还会提示对应工具名，直接treg call <工具名> <路径>即可调用。

队友如何上传"三位一体"技能给你

分享侧的完整流程（创作与分发详见 docs/context/interface/skill.md）：

写一个带 frontmatter 的SKILL.md（name+description，智能体靠它发现技能）；
treg skill init --dir ./posthog—— 自动生成treg.json草稿（猜 base_url、找密钥）；
treg skill add --dir ./posthog——配方 + 密钥 + 工具一次注册；
多凭证的复杂技能可用treg skill scaffold生成清单，补全绑定后treg skill push <清单>。

两条安全铁律：

🔒密钥只写（write-only）：API 永不返回已存储的值，对你、对任何人都一样；
🚫不要孤立存放密钥：存了没人绑定的 key 就是死重量——用secret add时同一步绑定到工具。

装完之后怎么用

treg tool ls # 团队已注册的工具清单 treg skill ls # 团队技能清单 treg health --run # 检查全部凭证状态（ok | invalid | unknown） treg call posthog api/projects/@current # <工具名>+上游路径，凭证自动注入

安装技能后，你的智能体按 SKILL.md 里的步骤工作：查工具 → 读参数与价格 → 发起调用。每次调用的花费通过X-Treg-Cost-Micro响应头结算，treg balance可查余额与最近扣费。工具与调用审计记录可在 docs/context/interface/cli.md 中了解 CLI 完整能力。