TeamAI标签订阅详解如何精准订阅你需要的团队Skills和Rules【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cliTeamAIteamai-cli口号是 Make Every Team AI Native是一个让每个团队通过 AI 持续变得更聪明的协作层它统一管理团队的 Skills、Rules、Docs、MCP 等资源并分发到每位成员的 AI 工具中。当团队仓库里的技能越积越多时标签订阅Tag Subscription就成了关键能力它让你只同步与自己工作相关的 Skills 和 Rules避免全量同步带来的信息噪音。本文带你从零理解标签订阅的工作原理并给出一套可直接上手的订阅步骤。为什么需要标签订阅全量同步的痛点 想象一下你的团队仓库里已经有 40 个技能——前端同学维护的vue-lint-helper、测试同学写的e2e-scenario-gen、运维同学的k8s-deploy-check……如果你不订阅任何标签执行teamai pull时会把这些全部安装到本地 AI 工具目录如.claude/skills/。技能列表越长AI 选择技能的准确率反而可能下降会话上下文也被无关资源挤占。标签订阅解决的就是这个问题方式同步范围适用场景角色Roles你的角色 namespace 下的全部 skills确定自己主要归属哪个职能标签订阅Tags显式匹配你订阅标签的 skills/rules跨职能按需取用特定资源未打标签资源始终同步全团队通用资源简单说角色回答我属于哪里标签回答我还想要什么。两者叠加最终同步的是二者的并集。标签订阅的工作原理tags.yaml 与订阅列表 标签订阅由两份数据驱动理解这一点就理解了全部行为团队仓库里的tags.yaml—— 管理员维护的资源 → 标签映射表。哪个技能打了哪些标签由它说了算。你本地配置里的subscribedTags—— 你订阅了哪些标签记录在当前 scope 的config.yaml中。过滤逻辑实现在 src/utils/tags.ts 的filterByTags函数中非常直观按优先级排列团队仓库没有tags.yaml→ 全量同步向后兼容你没有订阅任何标签 → 全量同步资源没有打标签→ 始终同步视为团队通用资源资源的标签与你订阅的标签有交集→ 同步其余 → 跳过这意味着标签过滤是只减不增的安全机制它永远不会把团队通用资源挡在门外。核心规则源码见 src/utils/tags.tspull 时的集成点在 src/pull.ts。成员操作3 步完成精准订阅 第一步查看全部标签teamai tags list输出是一张清晰的表格每个标签各关联多少 skills 和 rules以及你是否已订阅Your subscriptions: frontend, testing Tag Skills Rules Subscribed ────────────────────────────────────────────────────── frontend 8 2 ✓ testing 5 1 ✓ gpu-analysis 3 0 legacy 2 0 4 skill(s) have no tags and are always synced.最后一行提示很有价值未打标签的技能数量它们会无条件同步。第二步订阅与取消订阅# 一次订阅多个标签空格分隔 teamai tags subscribe frontend testing # 取消订阅 teamai tags unsubscribe legacy订阅关系会立即写入当前 scope 的配置订阅状态与recall、contribute使用同一套 scope 判定避免订阅了 A 环境、同步的却是 B 环境的错位对应 src/tags.ts 的 scope 解析逻辑。第三步拉取生效teamai pullpull会按标签过滤后同步资源并在日志中告诉你跳过了多少[project] Synced 9 rule(s) (skipped 3 by tags)取消订阅后再执行一次teamai pull被过滤掉的资源副本会被自动清理掉不留垃圾。命令实现见 src/tags.ts。管理员操作给资源打标签 ️标签订阅的前提是资源有标签。管理员使用tags add/tags remove管理tags.yaml# 给技能打标签自动创建/更新 tags.yaml teamai tags add skills hai-deploy hai infra teamai tags add rules common-coding-style coding best-practices # 移除标签 teamai tags remove skills hai-deploy infra # 先用 --dry-run 预览不实际写入 teamai tags add skills hai-deploy hai --dry-run执行后记得commit 并 push 团队仓库或走teamai push的 MR 流程标签才能对全员生效。管理端逻辑见 src/tags.ts。 打标签建议标签命名保持短小如frontend、gpu、e2e按职能/领域/技术栈三个维度规划避免标签爆炸。标签与角色的协作并集而非覆盖 ✂️这是新手最容易困惑的一点。官方文档在 docs/usage-guide.zh-CN.md 中明确说明启用标签订阅后还可以额外同步其他 namespace 中显式匹配标签的 skills但不会包含非活跃 namespace 中未打标签的 skills。用一个具体例子拆解。假设团队仓库结构如下skills/ ├── backend/ │ └── backend-only/ # 你的角色 namespace └── frontend/ ├── beta-tag-wanted/ # 打了标签 wanted ├── beta-tag-other/ # 打了标签 other └── frontend-only/ # 没打标签你设置角色backend并订阅标签wanted。此时teamai pull的结果是资源是否同步原因backend/backend-only✅属于你的角色 namespacefrontend/beta-tag-wanted✅标签匹配你的订阅frontend/beta-tag-other❌非活跃 namespace 且标签不匹配frontend/frontend-only❌非活跃 namespace无标签也就是说标签只解锁显式打了标签的跨角色资源不会让你看到其他团队的全部私有技能——这既保证了按需也保证了隔离。项目级和用户级user scope两种安装方式下行为一致。这个行为有端到端测试保障见 roles-tags-pull.test.ts单测见 tags.test.ts。常见问题 FAQ ❓Q1我什么都不订阅会同步什么全量同步所有 skills 和 rules。标签过滤仅在你至少订阅了一个标签时才生效所以默认体验不变零迁移成本。Q2标签订阅和teamai skill exclude有什么区别两者互补。标签订阅在团队层面收窄资源池团队侧打标签你订阅exclude是个人本地排除usage-guide 说明且排除规则在角色和标签过滤之后生效——即使某技能匹配了你的标签你仍可在本地单独排除它互不影响。Q3订阅了新标签为什么本地看不到新资源执行一次teamai pull即可。订阅本身只修改本地配置不触发同步。如果你用的是支持 Hooks 的 AI 工具Claude Code、Codex、Cursor 等下次启动会话时会自动 pull。Q4团队仓库里没有 tags.yaml 怎么办一切照常没有tags.yaml时teamai tags list会提示尚未配置标签pull执行全量同步。由管理员执行第一次tags add时会自动创建该文件。Q5YAML 写坏了会怎样安全兜底tags.yaml解析失败时CLI 会告警并回退为全量同步见 loadTagsConfig不会让整个 pull 中断。总结让标签成为你的资源遥控器 ️回顾标签订阅的三个核心动作管理员teamai tags add/remove给资源打标签push 团队仓库成员teamai tags list看全貌 →tags subscribe按需订阅 →teamai pull生效验证teamai pull日志中的skipped N by tags就是过滤在起效的证据。配合角色Roles的默认频道标签订阅为你额外开放点播频道两者取并集未打标签的通用资源则永远在线。这套机制让 TeamAI 的资源分发从广播进化为订阅制——每个成员的 AI 工具目录里只剩下真正有用的 Skills 和 Rules。想深入了解完整的团队接入流程可阅读 官方中文使用指南 和 英文指南。【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TeamAI标签订阅详解：如何精准订阅你需要的团队Skills和Rules
TeamAI标签订阅详解如何精准订阅你需要的团队Skills和Rules【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cliTeamAIteamai-cli口号是 Make Every Team AI Native是一个让每个团队通过 AI 持续变得更聪明的协作层它统一管理团队的 Skills、Rules、Docs、MCP 等资源并分发到每位成员的 AI 工具中。当团队仓库里的技能越积越多时标签订阅Tag Subscription就成了关键能力它让你只同步与自己工作相关的 Skills 和 Rules避免全量同步带来的信息噪音。本文带你从零理解标签订阅的工作原理并给出一套可直接上手的订阅步骤。为什么需要标签订阅全量同步的痛点 想象一下你的团队仓库里已经有 40 个技能——前端同学维护的vue-lint-helper、测试同学写的e2e-scenario-gen、运维同学的k8s-deploy-check……如果你不订阅任何标签执行teamai pull时会把这些全部安装到本地 AI 工具目录如.claude/skills/。技能列表越长AI 选择技能的准确率反而可能下降会话上下文也被无关资源挤占。标签订阅解决的就是这个问题方式同步范围适用场景角色Roles你的角色 namespace 下的全部 skills确定自己主要归属哪个职能标签订阅Tags显式匹配你订阅标签的 skills/rules跨职能按需取用特定资源未打标签资源始终同步全团队通用资源简单说角色回答我属于哪里标签回答我还想要什么。两者叠加最终同步的是二者的并集。标签订阅的工作原理tags.yaml 与订阅列表 标签订阅由两份数据驱动理解这一点就理解了全部行为团队仓库里的tags.yaml—— 管理员维护的资源 → 标签映射表。哪个技能打了哪些标签由它说了算。你本地配置里的subscribedTags—— 你订阅了哪些标签记录在当前 scope 的config.yaml中。过滤逻辑实现在 src/utils/tags.ts 的filterByTags函数中非常直观按优先级排列团队仓库没有tags.yaml→ 全量同步向后兼容你没有订阅任何标签 → 全量同步资源没有打标签→ 始终同步视为团队通用资源资源的标签与你订阅的标签有交集→ 同步其余 → 跳过这意味着标签过滤是只减不增的安全机制它永远不会把团队通用资源挡在门外。核心规则源码见 src/utils/tags.tspull 时的集成点在 src/pull.ts。成员操作3 步完成精准订阅 第一步查看全部标签teamai tags list输出是一张清晰的表格每个标签各关联多少 skills 和 rules以及你是否已订阅Your subscriptions: frontend, testing Tag Skills Rules Subscribed ────────────────────────────────────────────────────── frontend 8 2 ✓ testing 5 1 ✓ gpu-analysis 3 0 legacy 2 0 4 skill(s) have no tags and are always synced.最后一行提示很有价值未打标签的技能数量它们会无条件同步。第二步订阅与取消订阅# 一次订阅多个标签空格分隔 teamai tags subscribe frontend testing # 取消订阅 teamai tags unsubscribe legacy订阅关系会立即写入当前 scope 的配置订阅状态与recall、contribute使用同一套 scope 判定避免订阅了 A 环境、同步的却是 B 环境的错位对应 src/tags.ts 的 scope 解析逻辑。第三步拉取生效teamai pullpull会按标签过滤后同步资源并在日志中告诉你跳过了多少[project] Synced 9 rule(s) (skipped 3 by tags)取消订阅后再执行一次teamai pull被过滤掉的资源副本会被自动清理掉不留垃圾。命令实现见 src/tags.ts。管理员操作给资源打标签 ️标签订阅的前提是资源有标签。管理员使用tags add/tags remove管理tags.yaml# 给技能打标签自动创建/更新 tags.yaml teamai tags add skills hai-deploy hai infra teamai tags add rules common-coding-style coding best-practices # 移除标签 teamai tags remove skills hai-deploy infra # 先用 --dry-run 预览不实际写入 teamai tags add skills hai-deploy hai --dry-run执行后记得commit 并 push 团队仓库或走teamai push的 MR 流程标签才能对全员生效。管理端逻辑见 src/tags.ts。 打标签建议标签命名保持短小如frontend、gpu、e2e按职能/领域/技术栈三个维度规划避免标签爆炸。标签与角色的协作并集而非覆盖 ✂️这是新手最容易困惑的一点。官方文档在 docs/usage-guide.zh-CN.md 中明确说明启用标签订阅后还可以额外同步其他 namespace 中显式匹配标签的 skills但不会包含非活跃 namespace 中未打标签的 skills。用一个具体例子拆解。假设团队仓库结构如下skills/ ├── backend/ │ └── backend-only/ # 你的角色 namespace └── frontend/ ├── beta-tag-wanted/ # 打了标签 wanted ├── beta-tag-other/ # 打了标签 other └── frontend-only/ # 没打标签你设置角色backend并订阅标签wanted。此时teamai pull的结果是资源是否同步原因backend/backend-only✅属于你的角色 namespacefrontend/beta-tag-wanted✅标签匹配你的订阅frontend/beta-tag-other❌非活跃 namespace 且标签不匹配frontend/frontend-only❌非活跃 namespace无标签也就是说标签只解锁显式打了标签的跨角色资源不会让你看到其他团队的全部私有技能——这既保证了按需也保证了隔离。项目级和用户级user scope两种安装方式下行为一致。这个行为有端到端测试保障见 roles-tags-pull.test.ts单测见 tags.test.ts。常见问题 FAQ ❓Q1我什么都不订阅会同步什么全量同步所有 skills 和 rules。标签过滤仅在你至少订阅了一个标签时才生效所以默认体验不变零迁移成本。Q2标签订阅和teamai skill exclude有什么区别两者互补。标签订阅在团队层面收窄资源池团队侧打标签你订阅exclude是个人本地排除usage-guide 说明且排除规则在角色和标签过滤之后生效——即使某技能匹配了你的标签你仍可在本地单独排除它互不影响。Q3订阅了新标签为什么本地看不到新资源执行一次teamai pull即可。订阅本身只修改本地配置不触发同步。如果你用的是支持 Hooks 的 AI 工具Claude Code、Codex、Cursor 等下次启动会话时会自动 pull。Q4团队仓库里没有 tags.yaml 怎么办一切照常没有tags.yaml时teamai tags list会提示尚未配置标签pull执行全量同步。由管理员执行第一次tags add时会自动创建该文件。Q5YAML 写坏了会怎样安全兜底tags.yaml解析失败时CLI 会告警并回退为全量同步见 loadTagsConfig不会让整个 pull 中断。总结让标签成为你的资源遥控器 ️回顾标签订阅的三个核心动作管理员teamai tags add/remove给资源打标签push 团队仓库成员teamai tags list看全貌 →tags subscribe按需订阅 →teamai pull生效验证teamai pull日志中的skipped N by tags就是过滤在起效的证据。配合角色Roles的默认频道标签订阅为你额外开放点播频道两者取并集未打标签的通用资源则永远在线。这套机制让 TeamAI 的资源分发从广播进化为订阅制——每个成员的 AI 工具目录里只剩下真正有用的 Skills 和 Rules。想深入了解完整的团队接入流程可阅读 官方中文使用指南 和 英文指南。【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考