mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-06-06 09:30:42 +08:00
feat: skills i18n 改造(schemaVersion 1.1,零向后兼容) (#1)
* feat: skills i18n 改造 — schemaVersion 1.1,零向后兼容
把 21 个 skills + 1 个 agent + manifest/categories 全量迁移到 schemaVersion 1.1
的 i18n 结构,配套 CI AI 翻译流水线(GitHub Models)与本地工具链。
## 关键变更
### 数据结构(破坏性,schemaVersion 1.0 → 1.1)
- SKILL.md: 顶层 name 改为 ASCII slug(== 目录名,符合 agentskills.io 规范);
中文显示名/short_desc/description 全部迁入 metadata.i18n.<locale>
- agents/<id>/agent.json: shortDesc/fullDesc/tags/persona.{role,traits} 迁入
i18n.<locale>;changelog[].changes 改为 { <locale>: string[] } 对象
- categories.json: 每个分类的 label/description 迁入 i18n.<locale>,顶层只剩
color/icon
- manifest.json: 加 supportedLocales / defaultLocale;顶层 description 迁入
i18n.<locale>
### Body 文件结构
- 根 SKILL.md = frontmatter + default_locale (en-US) body
- SKILL.<locale>.md = 各 locale 的 markdown body(首行 <!-- locale: xx --> 自校验)
### 工具链(scripts/i18n/)
- glossary.json: zh→en 术语表 + do_not_translate 白名单
- schema/skill-frontmatter.schema.json: i18n frontmatter JSON Schema
- validate-i18n.py: 8 条校验规则(name 合规 / locale 完整性 / hash 一致性等)
- translate.py: GitHub Models / Anthropic 双 backend,sha256 增量翻译
- migrate.py: 一次性迁移脚本(旧格式 → i18n 结构)
### CI(.github/workflows/)
- i18n-validate.yml: PR 触发跑 validate + translate --check
- i18n-translate.yml: PR 触发用 GitHub Models(默认 openai/gpt-5-mini)翻译缺失
locale,自动追加 commit;可切到 ANTHROPIC_API_KEY 走 Claude
### 文档
- docs/I18N.md: 作者贡献指南(schema 说明 / 提交流程 / 常见问题)
- README.md: 加多语言段落
## 验证
- uv run scripts/i18n/validate-i18n.py: OK,49 文件 0 错误
- uv run scripts/i18n/translate.py --check: 0 stale locale
- 21 skills 标题数 zh-CN == en-US 严格对齐(最大 66=66)
- skills-ref 规范校验:全部通过(顶层 name ASCII slug + description 单字段)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* fix(i18n): 修复 PR #1 review 反馈的 6 项问题
- schema: translated_by 正则放宽为 ^(human|ai:[A-Za-z0-9._:/-]+)$,接受
'ai:github:openai/gpt-5-mini' 这类 backend:model 形式(CI 翻译输出格式)
- README + docs/I18N.md: 修正"CI 用 Claude API"误导描述,正确说明默认是
GitHub Models(openai/gpt-5-mini)+ GITHUB_TOKEN,可选切到 Anthropic
- skills/minimax-tts/SKILL.md & SKILL.zh-CN.md: 删除多余的 ``` 闭合,避免
Markdown 后续渲染错乱
- skills/docx/SKILL.md: 翻译时丢失的 • Unicode escape 示例已恢复,
与 zh-CN 版本对齐
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
137
skills/manage-teams/SKILL.zh-CN.md
Normal file
137
skills/manage-teams/SKILL.zh-CN.md
Normal file
@@ -0,0 +1,137 @@
|
||||
<!-- locale: zh-CN -->
|
||||
|
||||
# manage-teams 技能
|
||||
|
||||
## L0:一句话摘要
|
||||
|
||||
创建和管理 Agent 团队,组织多 Agent 围绕共同任务协作。
|
||||
|
||||
## L1:概述与使用场景
|
||||
|
||||
### 能力描述
|
||||
|
||||
manage-teams 是一个**流程型技能(Procedural Skill)**,赋予 DesireCore 创建和管理 Agent 团队的能力。团队是多个 Agent 围绕共同任务协作的组织单元,每个团队有一个组长(supervisor)负责接收需求、拆解任务、分派给成员、汇总结果。
|
||||
|
||||
### 使用场景
|
||||
|
||||
- 需要多个 Agent 围绕同一任务持续协作(如项目组)
|
||||
- 需要建立组织架构(部门/团队层级)
|
||||
- 需要组长统一调度、拆解和分派任务
|
||||
- 简单一次性委派不够,需要共享上下文的长期协作
|
||||
|
||||
### 核心价值
|
||||
|
||||
- **组织化协作**:从单点委派升级为团队协作模式
|
||||
- **灵活管理**:支持临时团队和持久团队两种模式
|
||||
- **动态调整**:运行时可添加/移除成员、更换组长
|
||||
|
||||
## L2:详细规范
|
||||
|
||||
## 核心概念
|
||||
|
||||
### 团队 vs 单点委派
|
||||
|
||||
| 场景 | 推荐方式 | 理由 |
|
||||
|------|---------|------|
|
||||
| 一次性简单问题 | `Delegate(target, mode='sync')` | 无需组织开销 |
|
||||
| 需要一个专家处理 | `Delegate(target, mode='sync/async')` | 一对一足够 |
|
||||
| 需要多专家各出意见 | `Delegate(targets, mode='fan-out')` | 并行分派无需创建团队 |
|
||||
| 持续协作 + 共享上下文 | **创建团队** | 团队提供共享 workdir 和组织架构 |
|
||||
| 组织架构管理 | **创建嵌套团队** | 部门/团队层级关系 |
|
||||
|
||||
### 团队类型
|
||||
|
||||
- **临时团队(ephemeral)**:任务驱动,完成后可解散。适合项目制协作。
|
||||
- **持久团队(persistent)**:长期存在,适合部门/团队。临时团队可升级为持久团队。
|
||||
|
||||
### 组长唯一性约束
|
||||
|
||||
**一个 Agent 只能担任一个团队的组长(TL)。** 这是组织架构的硬性约束:
|
||||
|
||||
- 创建团队时,如果调用者已是其他团队的组长,应先卸任原团队组长(`set_supervisor` 指定接替者)再创建新团队
|
||||
- 不要将已担任组长的 Agent 设为另一个团队的组长
|
||||
- 一个 Agent 可以同时是某团队的组长和另一个团队的普通成员,但不能同时担任两个团队的组长
|
||||
|
||||
### 组长职责
|
||||
|
||||
1. 接收用户需求,分析任务复杂度
|
||||
2. 拆解子任务,决定需要哪些成员参与
|
||||
3. 使用 `Delegate` 工具分派任务(单点或 fan-out)
|
||||
4. 汇总各成员结果,给出综合回答
|
||||
5. 根据需要动态调整成员(添加/移除)
|
||||
|
||||
## 操作指南
|
||||
|
||||
### 创建团队
|
||||
|
||||
```
|
||||
ManageTeam({
|
||||
action: 'create',
|
||||
name: '房产评估项目组',
|
||||
members: ['legal-advisor', 'finance-advisor', 'real-estate'],
|
||||
task: '综合评估目标房产'
|
||||
})
|
||||
```
|
||||
|
||||
组长默认为调用者(你自己)。创建后你就是这个团队的 supervisor。
|
||||
|
||||
### 向团队成员分派任务
|
||||
|
||||
**单点委派**(一个成员处理):
|
||||
```
|
||||
Delegate({
|
||||
target: 'legal-advisor',
|
||||
task: '检查该房产的产权状况和法律风险',
|
||||
mode: 'sync'
|
||||
})
|
||||
```
|
||||
|
||||
**扇出委派**(多个成员并行):
|
||||
```
|
||||
Delegate({
|
||||
targets: ['legal-advisor', 'finance-advisor', 'real-estate'],
|
||||
task: '从各自专业角度评估这套房产',
|
||||
mode: 'fan-out',
|
||||
strategy: 'parallel'
|
||||
})
|
||||
```
|
||||
|
||||
### 管理成员
|
||||
|
||||
```
|
||||
// 添加成员
|
||||
ManageTeam({ action: 'add_member', teamId: '...', agentId: 'new-agent' })
|
||||
|
||||
// 批量添加成员
|
||||
ManageTeam({ action: 'add_members', teamId: '...', members: ['agent-a', 'agent-b'] })
|
||||
|
||||
// 移除成员
|
||||
ManageTeam({ action: 'remove_member', teamId: '...', agentId: 'old-agent' })
|
||||
|
||||
// 批量移除成员
|
||||
ManageTeam({ action: 'remove_members', teamId: '...', members: ['agent-a', 'agent-b'] })
|
||||
|
||||
// 更换组长
|
||||
ManageTeam({ action: 'set_supervisor', teamId: '...', agentId: 'new-leader' })
|
||||
```
|
||||
|
||||
### 团队生命周期
|
||||
|
||||
```
|
||||
// 任务完成,解散临时团队
|
||||
ManageTeam({ action: 'disband', teamId: '...' })
|
||||
|
||||
// 或升级为持久团队(长期使用)
|
||||
ManageTeam({ action: 'promote', teamId: '...' })
|
||||
```
|
||||
|
||||
## 最佳实践
|
||||
|
||||
1. **先评估再创建团队**:简单任务直接 Delegate,不要过度组织
|
||||
2. **成员精简**:只拉入真正需要的专家,避免信息过载
|
||||
3. **优先团队内成员**:在团队中优先委派给团队内成员。如需团队外专家的一次性意见,可临时 Delegate 咨询而无需加入团队;若反复需要,则用 add_member 正式拉入
|
||||
4. **明确任务描述**:分派时给出清晰的任务描述和背景信息
|
||||
5. **及时汇总**:收到成员结果后及时汇总,不要让用户等待
|
||||
6. **动态调整**:发现缺少某领域专家时,用 add_member 补充
|
||||
7. **用完即散**:临时团队任务完成后及时解散,保持组织整洁
|
||||
8. **组长唯一**:一个 Agent 只担任一个团队的组长,避免职责分散导致管理混乱
|
||||
Reference in New Issue
Block a user