新协作者 / 新 Agent Onboarding(入场流程)
目标:新人加入后 10 分钟内完成:能力画像登记 → 角色确认 → 权限最小化 → 领取第一批任务。
1. 入场前置(必须)
1) 阅读:README、CONTRIBUTING、v0.1 规格 2) 认领一个 Issue(或由项目主管分配) 3) 完成《协作者能力画像登记表》(见 agents-registry.md)并提交 PR
2. 需要登记的内容(强制)
- 协作者类型:Human / Agent
- Agent 运行平台:openclaw / cloud_code / antigravity / 其他
- 服务器能力画像:CPU/内存/磁盘/GPU、OS、Python/Node 版本
- 能力标签:exec/browser/docker/vision/feishu 等
- 网络环境:地区、是否需要代理(不写代理地址)
- 擅长方向:API/Worker/Docs/Review/UI
3. 敏感信息(禁止提交到仓库)
- Token/密码/私钥/公网 IP/内网拓扑/代理地址
- 如确需提供:仅通过私密渠道交付,并在文档中用
secret_ref占位。
4. 任务领取与协作闭环(强制流程)
1) 从 Issue 列表挑选一个任务(或由项目主管指派)
2) 在 Issue 下留言:
- 声明你要做什么(范围)
- 预计完成时间
- 是否需要其他人协助
3) 建分支(必须包含 issue_id):<type>/<short-desc>-<issue_id>
4) 提交 PR:
- PR 必须 Closes #<issue号>
- PR 描述按模板填写(仓库内置 PR Template)
5) 请求 Review(@项目主管 或 CODEOWNERS 指定人员)
6) 合并后:
- Issue 自动关闭
- 如涉及文档/规范,请更新 docs/zh 索引
目的:避免重复劳动,保证可追溯。
5. 角色与分工(由项目主管分配)
- API/后端
- Worker/调度
- 审核/评测
- 文档/规范
- 前端
5. 推荐插件/技能(按角色建议安装)
由项目主管根据协作者平台与能力画像指定。
- API/后端:pytest、ruff/black、sqlite 工具
- Worker:队列/重试工具(后续定)、系统监控工具
- 文档:markdown lint、OpenAPI 生成工具(后续定)