team-coordination by alinaqi/claude-bootstrap
npx skills add https://github.com/alinaqi/claude-bootstrap --skill team-coordination加载方式:base.md
目的: 使团队中的多个 Claude Code 会话能够协调工作,避免冲突。管理共享状态、待办事项认领、决策同步和会话感知。
┌─────────────────────────────────────────────────────────────────┐
│ TEAM CLAUDE CODE │
│ ───────────────────────────────────────────────────────────── │
│ Multiple devs, multiple Claude sessions, one codebase. │
│ Coordination > Speed. Communication > Assumptions. │
│ │
│ Before you start: Check who's working on what. │
│ Before you claim: Make sure nobody else has it. │
│ Before you decide: Check if it's already decided. │
│ Before you push: Pull and sync state. │
└─────────────────────────────────────────────────────────────────┘
当项目变为多人协作时,创建此结构:
_project_specs/
├── team/
│ ├── state.md # 当前谁在做什么
│ ├── contributors.md # 团队成员及其专注领域
│ └── handoffs/ # 将工作交接给他人时的记录
│ └── [feature]-handoff.md
├── session/
│ ├── current-state.md # 你的会话状态(个人)
│ ├── decisions.md # 共享 - 架构决策
│ └── code-landmarks.md # 共享 - 重要代码位置
└── todos/
├── active.md # 共享 - 带有认领标注
├── backlog.md # 共享
└── completed.md # 共享
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
_project_specs/team/state.md:
# 团队状态
*最后同步时间:[时间戳]*
## 活跃会话
| 贡献者 | 正在处理 | 开始时间 | 涉及文件 | 状态 |
|-------------|------------|---------|---------------|--------|
| @alice | TODO-042: 添加认证 | 2024-01-15 10:30 | src/auth/* | 🟢 活跃 |
| @bob | TODO-038: 修复结账 | 2024-01-15 09:00 | src/cart/* | 🟡 暂停 |
| - | - | - | - | - |
## 已认领的待办事项
| 待办事项 | 认领人 | 自何时起 | 预计完成时间 |
|------|------------|-------|-----|
| TODO-042 | @alice | 2024-01-15 | 今天 |
| TODO-038 | @bob | 2024-01-14 | 明天 |
## 最近完成(过去48小时)
| 待办事项 | 完成人 | 完成时间 | PR |
|------|--------------|------|-----|
| TODO-037 | @alice | 2024-01-14 | #123 |
## 需关注的冲突
| 区域 | 贡献者 | 备注 |
|------|--------------|-------|
| src/auth/* | @alice, @carol | Carol 需要认证功能来完成 TODO-045,请协调 |
## 公告
- [2024-01-15] @alice: 正在重构认证模块,今日结束前请勿触碰
- [2024-01-14] @bob: 需要新的环境变量:STRIPE_WEBHOOK_SECRET
_project_specs/team/contributors.md:
# 贡献者
## 团队成员
| 代号 | 姓名 | 专注领域 | 时区 | 状态 |
|--------|------|-------------|----------|--------|
| @alice | Alice Smith | 后端,认证 | EST | 活跃 |
| @bob | Bob Jones | 前端,支付 | PST | 活跃 |
| @carol | Carol White | DevOps,基础设施 | GMT | 兼职 |
## 所有权
| 领域 | 主要负责人 | 备份人员 | 备注 |
|------|---------|--------|-------|
| 认证 | @alice | @bob | 所有认证变更都需要 @alice 审核 |
| 支付 | @bob | @alice | Stripe 集成 |
| 基础设施 | @carol | @alice | 部署脚本,CI/CD |
| 数据库 | @alice | @carol | 迁移需要签字确认 |
## 沟通方式
- Slack: #project-name
- PRs: 始终标记领域负责人进行审核
- 紧急情况:在 Slack 上私信
## 工作时间重叠
EST: |████████████████████| PST: | ████████████████████| GMT: |████████████| 6am 12pm 6pm 12am EST
最佳重叠时间:EST 上午9点至中午12点(三人都在)
┌─────────────────────────────────────────────────────────────────┐
│ 开始会话检查清单 │
│ ───────────────────────────────────────────────────────────── │
│ 1. git pull origin main │
│ 2. 阅读 _project_specs/team/state.md │
│ 3. 检查已认领的待办事项 - 不要接手已认领的任务 │
│ 4. 在 active.md 中认领你的待办事项 │
│ 5. 在 state.md 中更新你的会话信息 │
│ 6. 开始工作前推送状态变更 │
│ 7. 开始工作 │
└─────────────────────────────────────────────────────────────────┘
在 active.md 中,添加认领标注:
## [TODO-042] 添加邮箱验证
**状态:** 进行中
**认领人:** @alice (2024-01-15 10:30 EST)
**预计完成时间:** 今天
...
state.mddecisions.mddecisions.md┌─────────────────────────────────────────────────────────────────┐
│ 结束会话检查清单 │
│ ───────────────────────────────────────────────────────────── │
│ 1. 提交你的工作(即使是进行中的) │
│ 2. 更新你的 current-state.md │
│ 3. 更新团队 state.md(状态 → 暂停 或 完成) │
│ 4. 如果要交接给他人:创建交接记录 │
│ 5. 如果放弃任务:取消认领待办事项 │
│ 6. 推送所有内容 │
└─────────────────────────────────────────────────────────────────┘
当将工作交接给其他团队成员时,创建:
_project_specs/team/handoffs/auth-feature-handoff.md:
# 交接:认证功能 (TODO-042)
**来自:** @alice
**交接给:** @bob
**日期:** 2024-01-15
## 状态
完成 70%。核心认证流程已就绪,需要添加:
- [ ] 密码重置流程
- [ ] 邮箱验证
## 已完成部分
- 登录/注销功能正常
- JWT 令牌已实现
- 会话管理已完成
## 剩余部分
1. 密码重置 - 参见 src/auth/reset.ts(已有框架)
2. 邮箱验证 - 需要集成 SendGrid
## 已做出的关键决策
- 使用 JWT 而非会话(参见 decisions.md)
- 令牌 7 天后过期
- 刷新令牌存储在 httpOnly cookies 中
## 注意事项
- `validateToken` 函数在处理过期令牌时有一个奇怪的边界情况
- 不要触碰 `authMiddleware.ts` - 它目前很脆弱
## 起始文件
1. src/auth/reset.ts - 密码重置
2. src/email/verification.ts - 邮箱流程
3. tests/auth.test.ts - 在此处添加测试
## 有问题吗?
如果卡住了,请在 Slack 上找我 @alice
在修改文件前,检查 state.md 了解谁在触碰什么:
## 活跃会话
| 贡献者 | 正在处理 | 开始时间 | 涉及文件 | 状态 |
|-------------|------------|---------|---------------|--------|
| @alice | TODO-042 | ... | src/auth/*, src/middleware/* | 🟢 活跃 |
如果你需要触碰 src/auth/* 而 Alice 正在那里工作:
推送前,始终:
git pull origin main
# 解决任何冲突
git push
始终在 PR 中标记领域负责人:
## PR: 添加密码重置流程
实现 TODO-042
cc: @alice (认证负责人), @bob (审核人)
### 变更
- 添加了密码重置端点
- 添加了邮箱模板
### 测试
- [ ] 单元测试通过
- [ ] 手动测试完成
decisions.md## [2024-01-15] 认证使用 JWT 还是会话 (@alice)
**决策:** 使用 JWT 令牌
**背景:** 需要为 API 和移动应用提供认证
**选项:**
1. 会话 - 更简单,服务器端状态
2. JWT - 无状态,适用于移动端
**选择:** JWT
**理由:** 移动应用需要无状态认证,JWT 跨平台工作
**权衡:** 令牌撤销更困难,需要刷新令牌策略
**批准人:** @bob, @carol
# 查看谁在做什么
cat _project_specs/team/state.md
# 快速检查活跃会话
grep "🟢 Active" _project_specs/team/state.md
_project_specs/todos/active.md_project_specs/team/state.md将团队状态同步检查添加到推送前钩子:
# 在 .git/hooks/pre-push 中(添加到现有内容)
# 检查团队状态是否为最新
echo "🔄 检查团队状态..."
git fetch origin main --quiet
LOCAL_STATE=$(git show HEAD:_project_specs/team/state.md 2>/dev/null | md5)
REMOTE_STATE=$(git show origin/main:_project_specs/team/state.md 2>/dev/null | md5)
if [ "$LOCAL_STATE" != "$REMOTE_STATE" ]; then
echo "⚠️ 远程团队状态已变更!"
echo " 运行:git pull origin main"
echo " 然后检查 _project_specs/team/state.md 获取更新"
# 仅警告,不阻止推送
fi
当用户在团队项目中开始会话时:
检查是否存在 _project_specs/team/state.md
如果存在,读取并报告:
询问他们想做什么
检查是否已被认领
帮助他们认领并更新状态
当项目需要团队协作时:
/check-contributors_project_specs/team/ 结构state.md 和 contributors.md🟢 活跃 - 当前正在工作
🟡 暂停 - 暂时离开,稍后返回
🔴 受阻 - 需要帮助/等待某事
⚪ 离线 - 今天不工作
**认领人:** @代号 (YYYY-MM-DD HH:MM 时区)
## 站会 [日期]
### @alice
- 昨天:完成了 TODO-042 认证流程
- 今天:开始 TODO-045 密码重置
- 阻碍:无
### @bob
- 昨天:修复了结账错误
- 今天:支付 webhook 集成
- 阻碍:需要 @carol 提供 STRIPE_WEBHOOK_SECRET
git pull origin mainteam/state.mdactive.md 中认领待办事项state.mdcurrent-state.mdteam/state.md每周安装次数
91
仓库
GitHub 星标数
530
首次出现
2026年1月20日
安全审计
安装于
opencode78
gemini-cli73
claude-code71
codex69
cursor66
github-copilot61
Load with: base.md
Purpose: Enable multiple Claude Code sessions across a team to coordinate and work together without conflicts. Manages shared state, todo claiming, decision syncing, and session awareness.
┌─────────────────────────────────────────────────────────────────┐
│ TEAM CLAUDE CODE │
│ ───────────────────────────────────────────────────────────── │
│ Multiple devs, multiple Claude sessions, one codebase. │
│ Coordination > Speed. Communication > Assumptions. │
│ │
│ Before you start: Check who's working on what. │
│ Before you claim: Make sure nobody else has it. │
│ Before you decide: Check if it's already decided. │
│ Before you push: Pull and sync state. │
└─────────────────────────────────────────────────────────────────┘
When a project becomes multi-person, create this structure:
_project_specs/
├── team/
│ ├── state.md # Who's working on what right now
│ ├── contributors.md # Team members and their focus areas
│ └── handoffs/ # Notes when passing work to others
│ └── [feature]-handoff.md
├── session/
│ ├── current-state.md # YOUR session state (personal)
│ ├── decisions.md # SHARED - architectural decisions
│ └── code-landmarks.md # SHARED - important code locations
└── todos/
├── active.md # SHARED - with claim annotations
├── backlog.md # SHARED
└── completed.md # SHARED
_project_specs/team/state.md:
# Team State
*Last synced: [timestamp]*
## Active Sessions
| Contributor | Working On | Started | Files Touched | Status |
|-------------|------------|---------|---------------|--------|
| @alice | TODO-042: Add auth | 2024-01-15 10:30 | src/auth/* | 🟢 Active |
| @bob | TODO-038: Fix checkout | 2024-01-15 09:00 | src/cart/* | 🟡 Paused |
| - | - | - | - | - |
## Claimed Todos
| Todo | Claimed By | Since | ETA |
|------|------------|-------|-----|
| TODO-042 | @alice | 2024-01-15 | Today |
| TODO-038 | @bob | 2024-01-14 | Tomorrow |
## Recently Completed (Last 48h)
| Todo | Completed By | When | PR |
|------|--------------|------|-----|
| TODO-037 | @alice | 2024-01-14 | #123 |
## Conflicts to Watch
| Area | Contributors | Notes |
|------|--------------|-------|
| src/auth/* | @alice, @carol | Carol needs auth for TODO-045, coordinate |
## Announcements
- [2024-01-15] @alice: Refactoring auth module, avoid touching until EOD
- [2024-01-14] @bob: New env var required: STRIPE_WEBHOOK_SECRET
_project_specs/team/contributors.md:
# Contributors
## Team Members
| Handle | Name | Focus Areas | Timezone | Status |
|--------|------|-------------|----------|--------|
| @alice | Alice Smith | Backend, Auth | EST | Active |
| @bob | Bob Jones | Frontend, Payments | PST | Active |
| @carol | Carol White | DevOps, Infra | GMT | Part-time |
## Ownership
| Area | Primary | Backup | Notes |
|------|---------|--------|-------|
| Authentication | @alice | @bob | All auth changes need @alice review |
| Payments | @bob | @alice | Stripe integration |
| Infrastructure | @carol | @alice | Deploy scripts, CI/CD |
| Database | @alice | @carol | Migrations need sign-off |
## Communication
- Slack: #project-name
- PRs: Always tag area owner for review
- Urgent: DM on Slack
## Working Hours Overlap
EST: |████████████████████| PST: | ████████████████████| GMT: |████████████| 6am 12pm 6pm 12am EST
Best overlap: 9am-12pm EST (all three)
┌─────────────────────────────────────────────────────────────────┐
│ START SESSION CHECKLIST │
│ ───────────────────────────────────────────────────────────── │
│ 1. git pull origin main │
│ 2. Read _project_specs/team/state.md │
│ 3. Check claimed todos - don't take what's claimed │
│ 4. Claim your todo in active.md │
│ 5. Update state.md with your session │
│ 6. Push state changes before starting work │
│ 7. Start working │
└─────────────────────────────────────────────────────────────────┘
In active.md, add claim annotation:
## [TODO-042] Add email validation
**Status:** in-progress
**Claimed:** @alice (2024-01-15 10:30 EST)
**ETA:** Today
...
state.md if you touch new filesdecisions.md before making architectural choicesdecisions.md immediately┌─────────────────────────────────────────────────────────────────┐
│ END SESSION CHECKLIST │
│ ───────────────────────────────────────────────────────────── │
│ 1. Commit your work (even if WIP) │
│ 2. Update your current-state.md │
│ 3. Update team state.md (status → Paused or Done) │
│ 4. If passing to someone: create handoff note │
│ 5. Unclaim todo if abandoning │
│ 6. Push everything │
└─────────────────────────────────────────────────────────────────┘
When passing work to another team member, create:
_project_specs/team/handoffs/auth-feature-handoff.md:
# Handoff: Auth Feature (TODO-042)
**From:** @alice
**To:** @bob
**Date:** 2024-01-15
## Status
70% complete. Core auth flow works, need to add:
- [ ] Password reset flow
- [ ] Email verification
## What's Done
- Login/logout working
- JWT tokens implemented
- Session management done
## What's Left
1. Password reset - see src/auth/reset.ts (skeleton exists)
2. Email verification - need to integrate SendGrid
## Key Decisions Made
- Using JWT not sessions (see decisions.md)
- Tokens expire in 7 days
- Refresh tokens stored in httpOnly cookies
## Watch Out For
- The `validateToken` function has a weird edge case with expired tokens
- Don't touch `authMiddleware.ts` - it's fragile rn
## Files to Start With
1. src/auth/reset.ts - password reset
2. src/email/verification.ts - email flow
3. tests/auth.test.ts - add tests here
## Questions?
Slack me @alice if stuck
Before modifying a file, check state.md for who's touching what:
## Active Sessions
| Contributor | Working On | Started | Files Touched | Status |
|-------------|------------|---------|---------------|--------|
| @alice | TODO-042 | ... | src/auth/*, src/middleware/* | 🟢 Active |
If you need to touch src/auth/* and Alice is working there:
Before pushing, always:
git pull origin main
# Resolve any conflicts
git push
Always tag area owners in PRs:
## PR: Add password reset flow
Implements TODO-042
cc: @alice (auth owner), @bob (reviewer)
### Changes
- Added password reset endpoint
- Added email templates
### Testing
- [ ] Unit tests pass
- [ ] Manual testing done
decisions.md## [2024-01-15] JWT vs Sessions for Auth (@alice)
**Decision:** Use JWT tokens
**Context:** Need auth for API and mobile app
**Options:**
1. Sessions - simpler, server-side state
2. JWT - stateless, works for mobile
**Choice:** JWT
**Reasoning:** Mobile app needs stateless auth, JWT works across platforms
**Trade-offs:** Token revocation is harder, need refresh token strategy
**Approved by:** @bob, @carol
# See who's working on what
cat _project_specs/team/state.md
# Quick active sessions check
grep "🟢 Active" _project_specs/team/state.md
_project_specs/todos/active.md_project_specs/team/state.mdAdd team state sync check to pre-push:
# In .git/hooks/pre-push (add to existing)
# Check if team state is current
echo "🔄 Checking team state..."
git fetch origin main --quiet
LOCAL_STATE=$(git show HEAD:_project_specs/team/state.md 2>/dev/null | md5)
REMOTE_STATE=$(git show origin/main:_project_specs/team/state.md 2>/dev/null | md5)
if [ "$LOCAL_STATE" != "$REMOTE_STATE" ]; then
echo "⚠️ Team state has changed on remote!"
echo " Run: git pull origin main"
echo " Then check _project_specs/team/state.md for updates"
# Warning only, don't block
fi
When user starts a session in a team project:
Check for _project_specs/team/state.md
If exists, read it and report:
Ask what they want to work on
Check if it's already claimed
Help them claim and update state
When a project needs team coordination:
/check-contributors_project_specs/team/ structurestate.md and contributors.md🟢 Active - Currently working
🟡 Paused - Stepped away, will return
🔴 Blocked - Needs help/waiting on something
⚪ Offline - Not working today
**Claimed:** @handle (YYYY-MM-DD HH:MM TZ)
## Standup [DATE]
### @alice
- Yesterday: Finished TODO-042 auth flow
- Today: Starting TODO-045 password reset
- Blockers: None
### @bob
- Yesterday: Fixed checkout bug
- Today: Payment webhook integration
- Blockers: Need STRIPE_WEBHOOK_SECRET from @carol
git pull origin mainteam/state.mdactive.mdstate.mdcurrent-state.mdteam/state.mdWeekly Installs
91
Repository
GitHub Stars
530
First Seen
Jan 20, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode78
gemini-cli73
claude-code71
codex69
cursor66
github-copilot61
React 组合模式指南:Vercel 组件架构最佳实践,提升代码可维护性
120,000 周安装
Elasticsearch 最佳实践指南:索引设计、分片优化与集群配置
381 周安装
网站爬取与API自动化工具 - Python/JavaScript爬虫脚本开发,支持反爬虫处理
378 周安装
Research Engineer AI助手 - 27.4K星标开源技能,支持Claude/Codex/Gemini等AI开发工具
373 周安装
TypeScript高级类型完全指南:泛型、条件类型、映射类型、实用工具类型详解
383 周安装
Inngest 持久化函数教程:构建容错工作流与 TypeScript 实践指南
379 周安装
Inngest Steps 教程:构建健壮工作流的步骤方法详解与最佳实践
386 周安装