skill-lib/docs/团队管理标准.md

sgClaw 团队管理标准（V1.1）

适用范围：P1a、P1b、P2、P3、P4 五角色并行开发。 管理原则：清单驱动、里程碑验收、接口先行、变更可追溯。

1. 全员统一工作清单

1.1 每日清单（Daily）

• 站会前更新：昨日产出、今日计划、阻塞项（各不超过 3 条）
• 当日最少 1 次提交，提交信息带角色前缀（如 P2: ...）
• 若存在接口变更，必须同步公告并更新文档
• 下班前完成最小可运行验证（本地或联调环境）

1.2 里程碑清单（DoD）

• 代码通过本角色测试（单测/集成）
• 产出物齐全（代码、配置、文档、示例）
• 日志可定位（必须包含 seq、action、error.code）
• 通过上下游联调验收并留存证据

2. 五角色职责清单

P1a（核心通信，Rust）

• Pipe 协议实现：JSON Line、seq 递增、消息上限 1MB
• BrowserPipeTool + MAC/HMAC 校验落地
• command/response 关联能力按 seq 保证可追踪
• 提供协议级成功/失败样例

P1b（业务支持，Rust）

• Skill 加载、签名校验、沙箱执行
• 记忆分层（L0/L1/L2）可读写可检索
• AgentRuntime 与 P1a 工具链路打通
• Critic 与熔断策略生效

P2（浏览器对接，Chromium C++）

• SgClawProcessHost 生命周期（start/stop/crash）
• PipeListener 收发与 Schema 校验
• MAC 白名单检查与 CommandRouter 映射一致
• 错误码标准化回传（PIPE_*/MAC_*/CMD_*）

P3（业务技能，JS）

• Skill 元数据、参数 Schema、签名文件齐备
• 每个 skill 提供最小可运行示例
• 关键场景具备降级与异常处理
• 与 P1b 联调加载、执行、回滚路径

P4（前端与发布，Vue/DevOps）

• 控制面板支持启停、状态、日志展示
• human-in-the-loop 确认链路闭环
• 打包脚本一键产物（deb/exe）
• 发布与回滚文档完整

3. 个人任务卡模板（分配即执行）

负责人：
角色：P1a / P1b / P2 / P3 / P4

本周必须交付：
1)
2)
3)

联调对象：
阻塞项：

验收证据（必填）：
- 提交记录：
- 测试结果：
- 日志/截图：

4. 接口标准与变更管理

• 浏览器联调标准统一使用：docs/浏览器对接标准.md。
• 任何接口字段变更必须提交 RFC（影响面、兼容策略、回滚方案）。
• 合并门槛：P1a + P2 + 管理者三方评审通过。
• 文档更新顺序：先改接口文档，再改实现代码，最后改测试与演示资料。