AgentSkillsCN

team-sync

team-sync

中文原作
SKILL.md

team-sync

多人协作文档同步,确保团队成员间的信息传递。

触发条件

自动触发

  • 会话结束时
  • 完成重要功能后
  • 检测到文档过期(>24h未更新)

手动触发

  • /team:sync
  • /team:handoff

维护的文档

1. 团队状态板 .claude/team/status.md

markdown
# 团队状态板

> 最后更新: {timestamp}

## 当前活跃

| 成员 | 任务 | 分支 | 状态 | 开始时间 |
|------|------|------|------|----------|
| @张三 | #task-001 用户登录 | feature/auth | 进行中 | 2024-01-10 |
| @李四 | #task-003 订单模块 | feature/order | 代码审查 | 2024-01-09 |

## 最近完成

| 成员 | 任务 | 完成时间 | PR |
|------|------|----------|-----|
| @王五 | #task-002 支付集成 | 2024-01-10 | #42 |

## 阻塞事项

| 任务 | 阻塞原因 | 需要 | 负责人 |
|------|----------|------|--------|
| #task-004 | 等待 API 文档 | @后端团队 | @张三 |

2. 交接文档 .claude/team/handoff.md

markdown
# 任务交接记录

## {日期} - {任务名} 交接

### 交接人
- **从**: @张三
- **到**: @李四

### 任务状态
- **完成度**: 70%
- **分支**: feature/auth
- **最后提交**: a1b2c3d

### 已完成
- [x] 数据模型设计
- [x] 登录接口实现
- [x] JWT 生成

### 待完成
- [ ] 刷新 Token 逻辑
- [ ] 登出接口
- [ ] 单元测试

### 注意事项
- `src/auth/token.ts` 中的 SECRET 需要从环境变量读取
- 参考 `docs/auth-flow.md` 了解完整流程

### 相关文件
- `src/auth/*` - 主要代码
- `src/models/user.ts` - 用户模型
- `.claude/sessions/2024-01-10-auth.md` - 开发记录

### 遗留问题
1. Token 过期时间待定,目前是 1 小时
2. 是否需要支持多设备登录?

3. 决策日志 .claude/team/decisions.md

markdown
# 团队决策日志

## 2024-01-10 - JWT vs Session 认证

**参与者**: @张三, @李四, @王五

**背景**: 需要选择用户认证方案

**选项**:
1. JWT Token - 无状态,适合分布式
2. Session - 有状态,需要 Redis

**决定**: JWT Token

**理由**:
- 后续会部署多实例
- 减少 Redis 依赖
- 移动端更友好

**影响**:
- 需要实现 Token 刷新机制
- 登出需要黑名单机制

4. 每日站会 .claude/team/standup/{date}.md

markdown
# 站会记录 - 2024-01-10

## @张三
**昨天**: 完成用户登录接口
**今天**: 实现 Token 刷新
**阻塞**: 无

## @李四
**昨天**: 订单模块数据库设计
**今天**: 订单 CRUD 接口
**阻塞**: 等待支付接口文档

## 讨论事项
- Token 过期时间定为 2 小时
- 下周开始前端联调

执行流程

会话结束时自动执行

  1. 更新状态板

    • 标记任务状态变更
    • 更新完成进度
    • 记录阻塞事项
  2. 生成交接信息

    • 如果任务未完成,生成交接文档
    • 记录当前状态和注意事项
    • 列出相关文件
  3. 同步决策

    • 提取会话中的重要决策
    • 记录到决策日志
    • 标注参与者和影响

确认检查点

code
📋 团队同步检查

即将更新以下文档:
1. team/status.md - 更新任务状态
2. team/handoff.md - 添加交接记录(如需要)
3. sessions/xxx.md - 保存会话记录

是否确认?(y/n/e)
- y: 确认更新
- n: 跳过
- e: 编辑后更新

多人协作最佳实践

开始工作前

code
/team:status          # 查看团队状态
/workflow:understand  # 加载上下文

工作中

code
# 遇到重要决策时
/team:decision "选择 TypeORM 而不是 Prisma"

# 遇到阻塞时
/team:block "等待设计稿"

结束工作时

code
/session:end          # 自动触发 team-sync
# 或手动
/team:handoff @李四   # 指定交接给谁