关于这个目录
这是一个纯静态的页面,把团队在用的 AI agent 集中展示出来:谁负责什么、绑定了哪些工具和渠道、怎么把它叫起来。目的很朴素 —— 少问「我们有没有能自动写周报的 agent」,直接来这儿看。
它不存任何数据。没有后端、没有数据库、没有在线提交表单。这个站是仓库里的一组文件,内容改了、重新部署,页面就变了。
怎么新增或修改一个 agent
- 编辑
public/data/agents.json,在agents数组里加一条或改现有的一条。 - 本地跑
pnpm dev,打开http://localhost:9000看效果。 - commit 并 push 到远端仓库。
- 在 TeamClu 应用列表里点「部署」,改动就上线了。
页面上的筛选、搜索、详情页都是从这一个 JSON 文件渲染出来的,不用改 HTML。
字段说明
| 字段 | 必填 | 说明 |
|---|---|---|
| id | 是 | 唯一标识,只用小写字母、数字和连字符。详情页地址是 /agent.html?id=你的id |
| name | 是 | 显示名称,短一点,两到六个字最好 |
| emoji | 否 | 卡片左上角的图标,一个 emoji 就够 |
| role | 是 | 所属角色,页面上按它做筛选。同类 agent 建议用同一个值 |
| tagline | 是 | 一句话说明它帮你做什么,卡片上显示 |
| tags | 否 | 字符串数组,卡片上最多显示前四个,搜索也会匹配 |
| owner | 否 | 负责人,出问题找谁 |
| updated | 否 | 最后更新时间,建议 YYYY-MM-DD |
| status | 否 | stable / beta / paused,对应稳定 / 试用 / 暂停 |
| summary | 否 | 两三句介绍它是什么、适合把什么交给它 |
| capabilities | 否 | 字符串数组,具体能做的事,写成动词开头的短句 |
| usage | 否 | 字符串数组,按顺序的使用步骤 |
| prompt | 否 | 一段可直接复制的起始 prompt,详情页有一键复制按钮 |
| tools / skills / channels | 否 | 三个字符串数组,分别对应工具与权限、绑定的技能、可用渠道 |
一条完整的记录长这样
{
"id": "daily-report",
"name": "日报助手",
"emoji": "📝",
"role": "效率",
"tagline": "每天 9 点自动把昨天的进展汇总成一段话。",
"tags": ["日报", "定时任务"],
"owner": "matt",
"updated": "2026-09-14",
"status": "beta",
"summary": "读取仓库提交和看板变更,汇总成给团队看的日报。",
"capabilities": ["汇总昨日变更", "标出卡住的事项", "按固定模板输出"],
"usage": ["确认要统计的仓库和看板", "设置推送时间与目标群", "第一周人工校对口径"],
"tools": ["Git", "看板 API"],
"skills": [],
"channels": ["企业微信"],
"prompt": "汇总昨天的进展,按「完成 / 进行中 / 卡住」三段输出,不超过 200 字。"
}
边界
- 要在线提交或点赞这类功能,得换成有数据库的「数据操作」类应用 —— 静态站做不到。
- 页面内容进浏览器后由 JS 渲染,源码里除了
data/agents.json没有别的数据源。 - 访问控制由平台在请求入口执行,不在这个页面的代码里。需要登录墙请在 TeamClu 控制面配置。