What it is

A template repository for building integrations with an AI coding agent. Start a project from the template, fill in a few settings, and the agent arrives already knowing the integration platform, the company's conventions and the limits it must not cross.

It exists because an agent that can deploy is only useful if it provably cannot deploy to the wrong place.

What it does

• Bundles the platform's own agent skill, kept pristine and refreshed by a sync script, next to a separate skill of house rules: topology, known pitfalls and proven component templates.
• Refuses any deploy, undeploy or test execution whose target is not on the allowlist of test environments, even when the target is smuggled in as an inline override.
• Scans every commit for tokens, private keys and populated passwords in component files, and refuses to commit them.
• Gives each developer their own sandbox folder and credentials, so agents cannot trample each other's work.

How it works

1. A developer creates a repository from the template and runs a one-time setup that checks the tools and installs the hooks.
2. They describe the integration to the agent in plain language.
3. The agent loads both skills, verifies its environment, and builds in the developer's sandbox.
4. Before every command the agent runs, a hook inspects it; a deploy outside the allowed environments is stopped with a message the agent can read and act on.
5. Promotion to production stays a human step in the platform's own interface.

Design choices

• Upstream skill untouched, company rules alongside: syncing the vendor's updates never conflicts with local knowledge.
• Guardrails as hooks, not instructions, so they hold even when the model is confident it is right.
• A smoke test after every change to hooks or skills, so the safety net is itself tested.
• Lessons learned go back into the template through pull requests, so every future project benefits.

Stack

这是什么

一个用 AI 编程智能体构建集成的模板仓库。从模板新建项目、填几个设置，智能体一上来就已经了解集成平台、公司规范，以及它不能越过的界线。

它存在的理由：一个能部署的智能体，只有在可以证明它绝不会部署到错误地方时才有用。

它能做什么

• 打包平台官方的智能体技能（保持原样、由同步脚本更新），旁边另放一份公司规范技能：拓扑结构、已知坑点和经过验证的组件模板。
• 任何部署、下线或测试执行，目标不在测试环境白名单上就一律拒绝，哪怕目标是通过行内覆盖偷偷传进来的。
• 每次提交都扫描组件文件里的令牌、私钥和填了值的密码，发现就拒绝提交。
• 每个开发者都有自己的沙箱目录和凭据，智能体之间不会互相踩踏。

如何运作

1. 开发者从模板创建仓库，运行一次性初始化：检查工具、安装钩子。
2. 用自然语言向智能体描述要做的集成。
3. 智能体加载两份技能、校验环境，在开发者的沙箱里构建。
4. 智能体每执行一条命令前，钩子都会先检查；部署到允许范围之外会被拦下，并给出智能体能读懂并据此调整的提示。
5. 晋升到生产环境始终是人在平台界面里手动完成。

设计取舍

• 上游技能不动，公司规则放旁边：同步厂商更新永远不会和本地知识冲突。
• 护栏做成钩子而不是指令，即使模型自信满满也拦得住。
• 钩子或技能每次改动后都跑冒烟测试，安全网本身也要被测试。
• 经验教训通过 PR 回流到模板，以后每个项目都受益。

技术栈

這是什麼

一個以 AI 程式開發代理建置整合的範本儲存庫。從範本新建專案、填幾個設定，代理一上手就已經了解整合平台、公司規範，以及它不能越過的界線。

它存在的理由：一個能部署的代理，只有在可以證明它絕不會部署到錯誤地方時才有用。

它能做什麼

• 打包平台官方的代理技能（保持原樣、由同步腳本更新），旁邊另放一份公司規範技能：拓撲結構、已知陷阱與經過驗證的元件範本。
• 任何部署、下架或測試執行，目標不在測試環境允許清單上就一律拒絕，即使目標是透過行內覆寫偷偷傳進來的。
• 每次提交都掃描元件檔案裡的權杖、私鑰與填了值的密碼，發現就拒絕提交。
• 每位開發者都有自己的沙箱目錄與憑證，代理之間不會互相踩踏。

如何運作

1. 開發者從範本建立儲存庫，執行一次性初始化：檢查工具、安裝掛鉤。
2. 用自然語言向代理描述要做的整合。
3. 代理載入兩份技能、驗證環境，在開發者的沙箱裡建置。
4. 代理每執行一條指令前，掛鉤都會先檢查；部署到允許範圍之外會被攔下，並給出代理能讀懂並據此調整的提示。
5. 晉升到正式環境始終由人在平台介面裡手動完成。

設計取捨

• 上游技能不動，公司規則放旁邊：同步廠商更新永遠不會和本地知識衝突。
• 護欄做成掛鉤而不是指令，即使模型信心滿滿也攔得住。
• 掛鉤或技能每次更動後都跑冒煙測試，安全網本身也要被測試。
• 經驗教訓透過 PR 回流到範本，以後每個專案都受益。

技術堆疊