团队角色迭代升级Skill：一句话让多智能体团队按任务需求自动“加人升级”
- 一键完成“给团队加角色”：自动读取现有的
team_roles.md（角色定义）与README.md（成员表），按任务需求新增或调整角色，版本号自动 +0.1。 - 安全优先的修改流程：强制“本地修订 → 展示变更预览 → 用户明确确认 → 才上传覆盖”，从机制上杜绝静默覆盖资料库。
- 依据驱动，不凭想象编造：新角色职责必须可操作、有来源（诊断结论、待补充项、业务现状等），避免造出“看起来很美但没法用”的虚拟岗位。
- 四处联动一次改全：新增角色同时更新架构图、协作流程图、成员表与“我能帮你做什么”，不留半成品文档。
- 双通道上传 + 降级预案：支持网盘（tdrive）与乐享资料库通道，上传接口异常时给出可执行的降级方案。
1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？
技能名片
| 项目 | 内容 |
|---|---|
| 中文名 | 团队角色迭代升级Skill |
| 英文名 | team-role-iteration |
| 技能ID | 14393 |
| 技能类型 | 可被用户直接调用（user-invocable: true）的文档迭代类技能 |
| 核心对象 | team_roles.md、README.md |
它到底解决什么问题？
只要你在维护一支“多智能体团队”或“AI 专家系统”，就一定会遇到这类麻烦：业务变了，团队要加一个角色，于是你要手工改四个地方——角色定义章节、架构图、协作流程图、成员表；改完还要记得把版本号从 v1.1 手动改成 v1.2；改完再手动上传覆盖资料库，一不小心就把别人刚改的内容盖掉了。
这个技能把整条链路收敛成一句话需求：你只需要说“团队要加个招投标合规角色”，剩下的读取现状、按需起草角色职责、递增版本、联动更新文档、生成预览、确认后上传，全部由技能按固定流程执行。
一键安装的思路与步骤
安装前提：
- 拥有可用的 AI 技能运行环境与账号（具体平台入口以官方说明为准）。
- 已授权技能所需的基础工具能力：文件读写与检索（Read / Write / Edit / Glob / Grep）、命令执行（Bash）、需求澄清提问（AskUserQuestion）。
- 如果希望技能自动把修订结果回写资料库，还需要提前完成资料库连接授权：网盘（tdrive）的文件上传/下载/目录列举能力，或乐享资料库的连接器（具体授权方式以官方说明为准）。
- 目标团队目录中已存在
team_roles.md与README.md这两个文件——它们是技能迭代的基础。
安装步骤（通用路径）：
- 打开你所用平台的技能市场或技能管理页（入口以官方说明为准）。
- 通过技能ID 14393 或英文名 team-role-iteration 检索该技能。
- 点击安装/启用，并按照提示确认它申请的工具权限范围（只读工具、编辑工具、资料库上传工具等）。
- 完成资料库（网盘或乐享）的连接授权。
如何验证是否生效：
- 在会话中直接说出触发语句，例如“帮我给团队加一个知识库运营角色”“按任务需求升级一下团队配置”“团队需要加人”。
- 若技能正常工作，它会先读取资料库中的现有文档并汇报当前版本号与角色清单，而不是直接开始改文件；随后给出需求澄清问题或修订预览。
- 若没有任何反应，说明技能未被正确启用，或当前会话未加载该技能，可回到技能管理页确认启用状态（以官方说明为准）。
2. 该技能的主要功能和特点
- 现状读取与盘点：自动从资料库拉取
team_roles.md与README.md，记录当前版本号、现有角色清单、架构图与协作流程，避免“盲改”。 - 任务需求解析：把“我们要接招投标项目了”这类业务语言，翻译成具体的能力缺口（如招投标合规、技术深度、知识库运营），再落到角色定义上。
- 需求澄清机制：当需求模糊时，主动追问范围、角色命名规则、是否包含真实人力等关键信息，而不是自行猜测。
- 双文件联动修订：在
team_roles.md中新增角色章节并更新架构图、协作流程图、沟通规范；在README.md中同步成员表、工作方式图与“我能帮你做什么”。 - 版本号自动递增：每次迭代固定 +0.1（v1.1 → v1.2），并标注变更说明，让团队配置具备可追溯的版本历史。
- 强制预览确认：改动只在本地完成，先输出变更摘要（新增了哪个角色、版本号变成多少、架构与流程改了什么），用户明确确认后才进入上传环节。
- 覆盖式上传与降级路径：确认后按“申请上传 → 直传文件 → 完成保存”的流程覆盖原文件；若上传接口异常，可降级为上传到乐享对应位置，或把修订好的文件交给用户手动覆盖。
- 经验沉淀：把本次遇到的耗时点与工具坑位写入自身经验记录（例如签名链接有效期、字段校验注意事项），下次迭代更快。
和普通做法比强在哪？ 普通做法是“打开文档 → 手改 → 上传”，靠人的记性保证一致性；这个技能把“一致性”和“不可静默覆盖”写成了流程约束——版本号不会忘、架构图不会漏、资料库不会被悄悄改掉。
3. 如何使用该技能？
分步使用指南
第 1 步：用自然语言下达需求 直接描述业务变化与目标，不必写技术指令。示例输入：
“我们团队现在偏内容运营，下个季度要接招投标类项目，帮我加一个招投标合规角色，版本升一级。”
第 2 步：等待技能读取现状
技能会从资料库读取 team_roles.md 与 README.md，并回报当前版本号、已有角色清单、架构与协作流程概况。这一步你会看到类似“当前版本 v1.2，现有 5 个角色”的信息。
第 3 步：回答澄清问题（如有） 如果需求不够明确，技能会向你提问，例如：新角色是否需要对接真实人力？角色命名希望用“XX专员”还是“XX负责人”？能力边界是否需要覆盖投标文件评审？此时补充信息越具体，产出的角色定义越可用。
第 4 步：查看变更预览（关键环节） 技能在本地完成修订后，会给出变更摘要，通常包括：
- 新增/调整了哪些角色章节，各自职责与协作接口；
- 版本号从多少变为多少，变更说明写的是什么；
- 架构图、协作流程图、成员表、“我能帮你做什么”分别发生了哪些变化。
第 5 步：确认或要求返工 满意就回复“确认上传”；不满意可以直接说“这个角色职责太宽，收窄到投标文件合规审查”，技能会重新修订并再次给出预览。
第 6 步：确认后自动覆盖上传 技能按覆盖策略把两个文件写回资料库团队目录，并回报上传结果。若上传通道报错，它会提示改用乐享通道或手动覆盖本地已修订文件——此时不要反复重试，按提示走降级路径即可。
输出示例（预览摘要形态）：
变更摘要：新增角色「招投标合规专员」，职责覆盖招标文件解读、投标响应清单核对、合规风险提示；版本号 v1.2 → v1.3；架构图新增该角色至“业务支撑层”；协作流程新增“投标前合规复核”节点；README 成员表新增 1 行，“我能帮你做什么”新增“投标合规自检”条目。
注意事项：
- 真实人力（各分类内容的实际负责人）仍需你另行指派，技能只负责“能力定义”，不负责“招人”。
- 资料库修改务必走“本地预览 → 确认 → 上传”三步，这是该技能的硬性安全规范，不要要求它跳过预览直接覆盖。
4. 同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| 团队角色迭代升级Skill（team-role-iteration） | 面向多智能体团队的“角色配置迭代器” | 读取现状、按需新增角色、版本 +0.1、架构/流程/成员表联动更新、预览确认后覆盖上传 | 需安装技能并授权文件与资料库工具；按技能ID检索启用即可 | 团队加角色、按任务升级团队能力、长期维护团队配置文档 | 优势：流程化、防静默覆盖、双文件联动；不足：依赖资料库结构规范，上传通道异常时需降级处理 |
| 手动编辑 Markdown 文档 | 最朴素的做法 | 人工改 team_roles.md、README.md，手工上传 |
门槛最低，无需任何工具 | 一次性小改动、文档结构极简的团队 | 优势：完全可控、零成本；不足：版本号易忘、架构图与成员表易漏改、多人协作易互相覆盖 |
| 通用 AI 对话助手直接改文档 | 用聊天方式让大模型生成角色描述 | 生成角色职责文本、改写章节 | 门槛低，粘贴文档即可 | 只需要一段角色描述文案时 | 优势：灵活、即时；不足：缺少“读取—预览—确认—回写”闭环，容易整篇重写破坏原有结构，也不了解你的资料库版本号 |
| 多智能体框架自带的角色配置文件 | 面向开发者的编排层配置 | 在代码或配置文件中定义 Agent 角色、工具、协作拓扑 | 需要开发能力与框架知识 | 工程化多智能体系统 | 优势：与运行时代码强绑定、可编程；不足：偏工程视角，面向业务方的团队文档（如成员表、协作流程）不在此列，业务同学难自助修改 |
选型建议： 如果你的团队配置是“业务可读的 Markdown 文档 + 资料库托管”，且需要长期版本治理，选本技能；如果只是临时写一段角色描述，通用对话助手更快；如果团队角色直接跑在代码框架里，则应走框架配置路线。
5. 该技能的典型应用场景与实际体验情况
场景一：内容团队承接招投标业务，需要补合规能力
角色与痛点： 团队负责人发现现有角色全是内容策划与运营，投标文件没人把关，但又不确定该设什么岗位、怎么和现有角色协作。 使用方式： 一句话说明业务变化，技能读取现有配置后新增“招投标合规”方向角色，并在协作流程里补上“投标前合规复核”节点。 实际体验： 上手几乎零学习成本，需求说得越具体，产出越贴合；预览摘要让人一眼看清“到底改了什么”，比翻两份长文档核对省事得多。注意点：新角色职责边界要自己把关，太宽会变成“什么都能干但都不精”。
场景二：AI 专家系统能力升级，按任务增配角色
角色与痛点： 运营同学在维护一套多智能体专家系统，业务线新增了知识库运营诉求，但角色定义文档散落在多处，改一处忘一处。 使用方式： 提出“按任务需求升级能力、增配知识库运营角色”，技能同步更新角色章节、架构图、成员表与“我能帮你做什么”。 实际体验： 联动更新是这个技能最实用的地方——过去最容易漏的就是成员表与“我能帮你做什么”，现在一次改全。版本号 +0.1 也让“哪次迭代加了什么”有迹可循。
场景三：团队配置文档的长期版本治理
角色与痛点： 团队配置几个月内迭代了多轮，版本号混乱，没人说得清 v1.4 和 v1.5 的差别。 使用方式： 每轮迭代都通过技能执行，变更说明随版本号一同写入。 实际体验： 版本历史可读性明显提升。需要注意的是，改动前务必确认当前资料库版本是最新的，避免基于旧版起草。
场景四：多人协作下的资料库安全修改
角色与痛点： 资料库是团队共享的，最怕 AI 直接覆盖把别人的改动冲掉。 使用方式： 依赖技能内置的“本地改好 → 展示预览 → 用户确认 → 才上传覆盖”流程。 实际体验： 确认环节确实会多花一分钟，但换来的是可回退的安全感。注意事项：若上传接口报校验类错误，不要反复重试，直接按提示改用乐享通道或手动覆盖本地文件；另外资料库的临时下载链接通常有有效期限制，隔太久需重新获取。
6. 该技能能为用户带来的价值
- 效率提升：把“读两份文档 → 起草角色 → 改架构图 → 改流程图 → 改成员表 → 改版本号 → 上传”的串行手工流程，压缩成一句需求和一次确认，单次迭代从“半小时级”降到“分钟级”。
- 一致性保障：四处联动更新 + 版本号强制 +0.1，从机制上消除“改了角色忘了成员表”“版本号还停在上个季度”这类长期文档债。
- 风险可控：预览确认环节是硬性规范，资料库不会被静默覆盖，多人协作场景下的误伤概率大幅下降。
- 门槛降低：业务同学不需要懂 Markdown 结构、不需要了解资料库上传接口，用业务语言描述需求即可完成团队配置升级。
- 长期资产价值：每次迭代都留下带变更说明的版本记录，团队能力演进过程可追溯、可复盘，团队配置文档从“一次性文档”变成“可运营的资产”。
7. 常见问题 FAQ
Q1：这个技能怎么安装？需要准备什么？
在技能市场或技能管理页通过技能ID 14393 或英文名 team-role-iteration 检索并启用，然后完成文件工具与资料库（网盘/乐享）连接的授权（具体入口与授权方式以官方说明为准）。使用前请确认目标团队目录中已有 team_roles.md 与 README.md。安装后在会话里说“给团队加一个角色”即可验证是否生效。
Q2：它会直接把我的资料库文件覆盖掉吗？ 不会静默覆盖。技能的核心原则是“本地改好 → 展示变更预览 → 用户明确确认 → 才上传覆盖”。只要你不确认，改动就停留在本地预览阶段。
Q3：收费吗？ 技能本身是否收费取决于你所在平台的计费规则（以官方说明为准）。需要留意的是，使用过程中可能消耗平台的计算资源，也可能涉及资料库存储服务本身的配额。
Q4：适合谁用？ 适合维护多智能体团队、AI 专家系统或任何“以 Markdown 文档定义团队角色”的团队；尤其适合业务负责人、AI 应用运营者、需要长期治理团队配置文档的协作团队。它只解决“能力定义”，真实人力仍需你另行指派。
Q5：和直接用 AI 对话助手改文档有什么区别？ 通用对话助手能帮你写一段角色描述，但不知道你的资料库版本号，也不保证架构图、协作流程、成员表同步更新，更不会强制“预览再上传”。本技能的价值在于把这件事变成有版本、有联动、有确认环节的标准流程。
Q6：上传时报错怎么办？ 若上传接口出现字段校验类异常，不要反复重试，按技能提示走降级路径：改用乐享通道上传内容，或把本地已修订好的文件交给用户手动覆盖，并在说明中写清降级原因。