如何用 treg skill init 脚手架创建自己的技能包新手完整指南【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg 是面向 AI Agent 的工具注册表OpenRouter for agent tools。想把自己调好的 API 能力做成团队共享的技能包用treg skill init脚手架扫描你的技能目录它会自动发现凭证、猜测上游地址生成注册合同文件treg.json再执行一条treg skill add就能把整个技能包注册给团队——密钥全程保存在服务端保险库队友用得上、但看不到。 技能包是什么三个部分组成在 treg 里一个技能包skill bundle 三样东西的原子组合组成是什么放在哪配方recipe教 Agent 怎么用的说明书Markdown 格式SKILL.md密钥secrets调用 API 所需的凭证文件.secret/或.secrets/目录工具tool上游 base_url 凭证注入方式由treg.json描述注册一次后全团队跑的是同一个技能包、同一套密钥谁都不用再复制 key 或重写脚本。treg skill init的作用就是你只管放好文件夹它帮你把后两样扫描出来写进一份 treg.json 合同文件。 三步创建自己的技能包第 1 步搭好技能包目录结构约定大于配置treg 只认这个结构./posthog/ ├── SKILL.md # 配方frontmatter 里写 name 和 descriptionAgent 靠它发现技能 └── .secret/ └── key # 凭证文件纯文本 API key或 JSON token 文件SKILL.md里要包含上游 API 地址如https://us.posthog.cominit 靠它猜base_url。可参考项目内置技能 skills/treg/SKILL.md 的写法。第 2 步一条命令生成注册合同treg skill init --dir ./posthog这一条命令背后generate_contract 做了四件事自动发现密钥扫描.secret//.secrets/下的所有凭证文件并智能判断类型——含refresh_token的 JSON 识别为oauthtreg 会在过期前自动刷新、其他 JSON 为secret_file、纯文本为env猜测上游地址从SKILL.md和*.py里提取 API host 作为base_url自动跳过 docs/developer 等文档站域名。若目录名匹配官方目录如google-ads目录里的地址优先生成不冲突的绑定主凭证绑定到Authorization: Bearer {secret}多个凭证时其余凭证按文件名各自生成独立请求头developer_token→developer-token头不会互相打架写入treg.json包含name、base_url、secrets、bindings等字段并打印一份还需人工确认的清单。生成的合同大致长这样{ name: posthog, base_url: https://us.posthog.com, secrets: [{ file: .secret/key, name: posthog, kind: env }], bindings: [{ secret: posthog, injector: env, location: header, name: Authorization, format: Bearer {secret} }], examples: [] } 安全设计treg.json只记录凭证文件名从不写入密钥值——密钥是 write-only注册后任何接口包括你自己都取不回明文。第 3 步按清单补齐_fill提示init 的输出会诚实地告诉你哪些是启发式猜测需要人工核对wrote ./posthog/treg.json auto: base_urlhttps://us.posthog.com | secrets[posthog] review / fill: - base_url — heuristic guess, verify (may need a version path e.g. /v1) - health — optional: add {path: ...} to enable health checks then register it in your active org: treg skill add --dir ./posthog常见两类提示照做即可base_url — NOT FOUND in SKILL.md/*.py→ 在treg.json里手填上游地址secrets — none found→ 把凭证文件放进.secret/后重新 init。 treg skill add一键注册到团队确认无误后treg skill add --dir ./posthogcmd_skill_add 会重新读取treg.json把磁盘上的密钥文件一并组装成注册请求原子地完成配方 密钥 工具三件套的注册——要么全成功要么全失败不会出现密钥存了但工具没建好的半截状态。成功后会打印技能包详情页链接并在 tools-registry 仪表盘的注册对话框 对应的后端数据结构中落库注册完成后treg skill ls # 查看已注册的技能包 treg call posthog api/... # 直接调用密钥由服务端注入 treg health --run # 主动校验每个凭证是否有效仪表盘侧看密钥只出现在名称 类型列表里值永不显示⚙️ 进阶其他创建与共享方式场景命令说明让 Agent 帮你补全清单treg skill scaffold ./my-skill输出 manifest 草稿base_url 留FILL待补适合交给编码 Agent 完善手动提交 manifesttreg skill push gads.json编辑好的 JSON 直接原子注册批量注册整个技能目录treg upload skills --dir ~/.claude/skills --all缺treg.json的文件夹会自动走 init 逻辑批量生成队友安装技能包treg skill install posthog拉取配方写入对方的 skills 目录API 调用走代理密钥留在保险库多凭证工具比如 OAuth developer-token 双头注入在仪表盘长这样init 的自动绑定正是为它准备的️ 新手常见坑与排查no treg.json in ... — run treg skill init firstadd 之前必须先 init或手写一份合法treg.jsontreg.json has no base_url猜测失败时留的是空串手填后重跑即可一个.secret/里多个同类凭证报 ambiguous加--file参数指定或拆成独立技能包OAuth 的client_secret.json被跳过是故意的它是造 token的应用配置不是请求凭证init 不会存也不会绑定它4xx 报错别换供应商重试多半是参数问题修参数才是解法。✅ 总结treg skill init把把 API 能力变成团队共享技能包这件繁琐的事压缩成放好SKILL.md和凭证 → init 生成treg.json→ 补清单 → add 注册。实现细节见 cmd_skill_init 源码 与 convert.py更多用法可阅读 CLI 接口文档、技能系统设计文档 和 快速上手指南。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考