技能使用指南

team-manager(团队管理器)Skill 是什么?如何下载安装使用?

团队管理器Skill用三阶内存与TF-IDF搜索持久化团队配置,让编码风格、规则与Bug修复经验跨项目自动注入。热内存仅约50 tokens,支持规则按智能体绑定、团队同步与导入导出。本文详解安装验证、使用步骤、竞品对比与典型场景,帮你一次配置处处复用,立即上手提升AI协作效率。

团队管理器Skillteam-manager
9 个章节 约 13 分钟阅读 AI 智能生成

团队管理器Skill:把编码风格与团队规则变成可跨项目携带的“团队记忆”

  • 解决什么痛点:每个新项目都要重新交代编码风格、规则和踩过的坑,AI 每次都要重新“认识你”。团队管理器用持久化团队配置文件把这个过程一次性固化。
  • 核心技术:三阶内存(热/温/冷)+ TF-IDF 搜索,让“常驻上下文”只占约 50 tokens,把 token 成本压到极低。
  • 关键动作:create 扫描旧项目自动沉淀团队 DNA,--team 初始化新项目时自动注入,rule add 随时补充规则。
  • 适用范围:跨项目、跨智能体(如前端智能体单独规则)、跨团队协作的配置复用场景。
  • 上手门槛:以命令行脚本为主,会用 python 命令即可,安装与配置以官方说明为准。

该技能叫什么?如何下载安装 AI 技能提升开发效率?

技能中文名:团队管理器Skill 技能英文名:team-manager 技能ID:12831

团队管理器是一个“持久化团队配置文件”的技能。它把团队的编码风格(官方称为团队 DNA)、开发规则、Bug 修复日志条目等经验沉淀成一份全局存储的团队档案(默认位置 ~/.vibegravity/teams/),并在你使用 --team 参数初始化新项目时,自动注入到项目里。换句话说,它解决的是**“跨项目重复交代偏好”和“AI 智能体每次从零开始”**这两个高频痛点。

一键安装 AI 技能提升开发效率的思路

AI 技能的价值在于“装一次,处处用”。团队管理器的安装与生效路径可以概括为三步:

第一步:确认安装前提

  • 需要本地具备 Python 运行环境,因为技能的核心入口是 .agent/skills/team-manager/scripts/team_manager.py 脚本。
  • 需要一个支持技能(skills)机制的智能体工作区,从文档中出现的 vibegravity init 命令看,它与 vibegravity 的项目初始化流程配套使用。
  • 具体的下载渠道、技能市场入口、是否需要账号或付费,以官方说明为准。

第二步:完成技能安装并初始化团队档案

安装完成后,建议先用一条已有项目做“冷启动”,让技能自动扫描出你的编码风格:

python .agent/skills/team-manager/scripts/team_manager.py create my-team --scan ./old-project

这条命令会扫描 ./old-project 目录,提炼出团队 DNA(一行浓缩的风格描述)与规则,写入全局团队存储。之后再用团队初始化新项目:

vibegravity init antigravity --team my-team

第三步:验证是否生效

验证方式非常直观:初始化完成后,检查项目内是否生成了 .agent/brain/team_dna.txt 与 .agent/brain/team_rules/ 目录。按技能文档约定,智能体在编写任何代码之前应先读取 team_dna.txt;若存在 team_rules/,还会读取与自身角色对应的规则文件(例如 frontend.md)。只要这两个路径出现且内容非空,就说明团队配置已成功注入。


该技能的主要功能和特点

  • 全局持久化团队档案:团队配置不绑定在单个仓库里,而是存放在全局目录,换项目不用重来。
  • 三阶内存分级加载:这是它最有辨识度的设计。
    • 🔴 热内存(约 50 tokens):团队 DNA 一行 + 顶级规则,始终加载,几乎不占上下文预算。
    • 🟡 温内存(约 200 tokens):完整规则清单 + 日志索引,按需通过 TF-IDF 搜索命中再加载。
    • 🔵 冷内存(0 tokens):归档内容,仅手动加载,平时完全不消耗 token。
  • TF-IDF 检索:规则和日志不是一股脑塞给模型,而是像搜索引擎一样按相关性召回,既省 token 又更精准。
  • 规则可绑定到具体智能体:rule add "使用Tailwind" --agent frontend-dev 可以让规则只在指定角色(如前端智能体)生效,避免全量规则互相干扰。
  • 项目扫描冷启动:create ... --scan 能从既有代码库反向提炼风格,省掉手写规则的功夫。
  • 团队同步与迁移:sync 支持把配置同步到其他团队档案,export / import 支持打包成 team-my-team.zip 迁移或备份。
  • 和普通“提示词模板”比强在哪:普通模板是静态文本、全量注入、换项目就失效;团队管理器是分级加载、可检索、可复用、可同步的结构化档案。

如何使用该技能?

以下按典型工作流给出分步骤指南。

步骤 1:创建一个团队(推荐从旧项目扫描)

python .agent/skills/team-manager/scripts/team_manager.py create my-team --scan ./old-project

输入:团队名 my-team 与被扫描的项目路径。 输出:在全局团队存储中生成 my-team 档案,包含提炼出的团队 DNA 与规则线索。

步骤 2:用该团队初始化新项目

vibegravity init antigravity --team my-team

输出:新项目内注入 .agent/brain/team_dna.txt(紧凑风格描述)与 .agent/brain/team_rules/(按智能体拆分的规则文件)。

步骤 3:持续补充与细化规则

python .agent/skills/team-manager/scripts/team_manager.py rule add "始终用英语编写文档"
python .agent/skills/team-manager/scripts/team_manager.py rule add "使用Tailwind" --agent frontend-dev

第一条是全局规则,第二条只对 frontend-dev 这个智能体生效。建议只把“必须永远遵守”的少数条目升级为顶级规则(进热内存),其余保持温内存按需检索。

步骤 4:在多团队之间同步

python .agent/skills/team-manager/scripts/team_manager.py sync other-team

适合“主团队 + 子团队”或“个人风格 + 公司规范”共存的场景。

步骤 5:导出备份或分发给同事

python .agent/skills/team-manager/scripts/team_manager.py export my-team
python .agent/skills/team-manager/scripts/team_manager.py import team-my-team.zip

导出生成压缩包,同事用 import 导入即可获得一致的团队配置。

步骤 6:让智能体正确读取配置

技能文档对智能体的要求是明确的:若 .agent/brain/team_dna.txt 存在,在编写任何代码前先读取它;若 .agent/brain/team_rules/ 存在,读取与自身角色对应的文件(如 frontend.md)。这一步通常由智能体根据技能说明自动执行,你只需确认文件到位。


同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
团队管理器(team-manager) 跨项目持久化团队配置档案 三阶内存分级加载、TF-IDF 检索、DNA 注入、规则按智能体绑定、同步与导入导出 需 Python 环境与技能工作区,命令行操作 多项目并行、团队规范统一、AI 编码风格一致化 优势:token 占用极低、可检索、可迁移;不足:以命令行为主,需要一点学习成本
项目内规则文件(如 AGENTS.md / 规则目录) 单仓库内的静态约定 手写风格与规则说明 极低,建文件即可 单项目、规则量少的轻量场景 优势:零依赖;不足:换项目失效,无法分级加载与检索,规则多了会撑爆上下文
系统级提示词 / 全局自定义指令 个人偏好的全局设定 一段固定提示词 低 个人开发者的通用习惯 优势:一次设置处处生效;不足:无法分团队、分智能体,缺少日志与检索能力,团队协作难共享
手动复制配置模板 人工搬运 复制粘贴旧项目的配置片段 低但重复劳动大 临时项目、一次性迁移 优势:灵活;不足:易遗漏、难维护、无版本与同步机制

该技能的典型应用场景与实际体验情况

场景一:多项目并行的独立开发者

角色:同时维护三四个仓库的独立开发者。 痛点:每个新仓库都要重新跟 AI 解释“我用什么风格、禁止什么写法”。 使用方式:先用最成熟的老项目 create --scan 生成团队档案,之后每个新项目 --team 初始化。 实际体验:首次配置有一次扫描成本,之后新建项目的“磨合期”基本消失;热内存约 50 tokens 的设计让风格约束几乎不占预算,长对话也不容易被挤掉。

场景二:需要统一规范的小型研发团队

角色:3-8 人团队的技术负责人。 痛点:成员各自的 AI 助手风格不一,代码评审反复糾正同类问题。 使用方式:负责人维护主团队档案,用 export 打包发给成员 import,实现规范同源。 实际体验:分发链路很短,一个压缩包即可对齐;注意规则要定期收敛,避免“什么都要管”导致规则膨胀。

场景三:前后端分工的智能体协作

角色:同时使用前端与后端智能体的开发者。 痛点:前端要 Tailwind、后端要严格分层,规则混在一起会互相打架。 使用方式:rule add "使用Tailwind" --agent frontend-dev 把规则绑定到指定智能体。 实际体验:规则定向生效后,不同角色的输出明显更“守规矩”;建议在规则描述里写清楚适用范围,便于温内存检索时命中。

场景四:Bug 修复知识的长期沉淀

角色:长期维护老系统的开发者。 痛点:同类 Bug 反复踩,经验散落在聊天记录里。 使用方式:把修复要点作为日志条目沉淀进团队档案,冷内存归档、温内存按需检索。 实际体验:检索按相关性召回,比翻聊天记录高效得多;需要注意文档与日志要写得“可被检索”,关键词清晰才会有好命中率。


该技能能为用户带来的价值

  • 上下文成本大幅下降:热内存仅约 50 tokens 常驻、温内存约 200 tokens 按需加载、冷内存 0 消耗。对比“把全部规则塞进提示词”的做法,同样的约束力只花零头的预算。
  • 告别重复交代:团队 DNA 一次沉淀、跨项目自动注入,新项目从“第一次对话”就进入正确风格。
  • 规范可分发、可复用:export / import 让团队规范变成可传输的资产,sync 让多套配置保持协同。
  • 知识资产化:编码风格、规则、Bug 修复经验从“口头传承”变成结构化档案,人员流动不丢经验。
  • 降低协作门槛:新成员导入团队包即可获得与老成员一致的 AI 协作体验,减少评审返工。
  • 长期价值:用得越久,团队档案越厚,检索命中越准,形成正反馈的效率复利。

常见问题 FAQ

Q1:怎么安装团队管理器Skill?安装后怎么确认生效? A:按官方技能安装方式把技能放入工作区(下载入口与是否收费以官方说明为准),确保本地有 Python 环境。生效验证很简单:执行初始化后检查项目内是否出现 .agent/brain/team_dna.txt 与 .agent/brain/team_rules/,有内容即表示注入成功。

Q2:这个技能收费吗? A:技能详情中未涉及定价信息,是否免费、是否有付费档位请以官方说明为准。技能本身依赖本地 Python 环境与全局存储目录,不额外要求外部服务。

Q3:适合谁用?个人开发者有必要用吗? A:最适合多项目并行、需要统一 AI 编码风格的开发者与小团队。个人开发者同样受益——只要你有两个以上项目,create --scan 加 --team 初始化就能省下大量重复沟通;只维护单一小项目、规则极少的场景,用普通规则文件也够。

Q4:和直接写 AGENTS.md 这类项目规则文件比,怎么选? A:单项目、规则少、不换仓库,用项目内规则文件更轻。一旦涉及多项目复用、需要分团队或分智能体、规则数量多到会占用大量上下文,就该用团队管理器——它能分级加载并检索,避免上下文被规则撑满。

Q5:三阶内存怎么用才合理?规则是不是越多越好? A:不是。热内存只放“永远必须遵守”的 DNA 与顶级规则(约 50 tokens),温内存放完整规则与日志索引供 TF-IDF 按需召回,冷内存放归档内容。规则越多,热内存越容易膨胀、检索噪声也越大,建议定期收敛,把低频规则下沉到温/冷层。