team-update

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Team Update

团队更新

Post project updates to team chat, read and triage feedback, and plan next steps. Adapts to whatever communication and project tools are available.

向团队聊天发布项目更新、读取并分类处理反馈，同时规划下一步工作。可适配任何可用的沟通和项目管理工具。

The Playbook Pattern

操作手册（Playbook）模式

This skill uses a playbook file at

.claude/team-update-playbook.md

in the project root.

First run: Discover available tools, ask the user for preferences, execute, save a playbook
Subsequent runs: Read the playbook, skip discovery, execute directly
User edits playbook: Changes take effect immediately (channel, style, triage rules)

The playbook is plain markdown the user can edit. It captures tool configuration, channel preferences, message style, triage rules, and last-run metadata.

本Skill会在项目根目录的

.claude/team-update-playbook.md

路径下使用一份**操作手册（playbook）**文件。

首次运行：发现可用工具，询问用户偏好，执行操作，保存操作手册
后续运行：读取操作手册，跳过发现环节，直接执行
用户编辑操作手册：修改会立即生效（包括频道、风格、分类规则）

操作手册是用户可编辑的纯Markdown文件，记录了工具配置、频道偏好、消息风格、分类规则以及上次运行的元数据。

Phase 0: Playbook Check

阶段0：操作手册检查

Check if

.claude/team-update-playbook.md

exists in the project root.

If it exists: Read it. All tool configuration, channel info, message style, and triage rules are in there. Jump to Phase 1 with known config.

If it does not exist: Run Phase 0b (Discovery) first.

检查项目根目录下是否存在

.claude/team-update-playbook.md

文件。

若存在：读取该文件。所有工具配置、频道信息、消息风格和分类规则均已包含在内。携带已知配置直接跳转至阶段1。

若不存在：先运行阶段0b（发现环节）。

Phase 0b: Discovery (First Run Only)

阶段0b：发现环节（仅首次运行）

Detect available capabilities by checking what MCP tools are connected and what local tools exist.

Read references/discovery-patterns.md for detection patterns.

通过检查已连接的MCP工具和本地工具，检测可用功能。

请阅读 references/discovery-patterns.md 了解检测模式。

Capability Detection

功能检测

Check for each capability category:

Capability	How to detect	Fallback if missing
Chat	MCP tools matching `chat` , `slack` , `discord` , `teams`	Output formatted text for manual posting
Git	`git rev-parse --is-inside-work-tree`	Skip commit summaries
Issues	MCP tools matching `github` , `linear` , `jira` , `brain_issues`	Skip or output text list
Tasks	MCP tools matching `tasks` , `todos` , `asana` , `brain_tasks`	Skip or output text list
Knowledge store	MCP tools matching `vault` , `remember` , `brain_knowledge`	Store last-run in playbook only

针对每个功能类别进行检查：

功能	检测方式	缺失时的备选方案
聊天	匹配 `chat` 、 `slack` 、 `discord` 、 `teams` 的MCP工具	输出格式化文本供手动发布
Git	执行 `git rev-parse --is-inside-work-tree` 命令	跳过提交摘要
问题追踪	匹配 `github` 、 `linear` 、 `jira` 、 `brain_issues` 的MCP工具	跳过或输出文本列表
任务管理	匹配 `tasks` 、 `todos` 、 `asana` 、 `brain_tasks` 的MCP工具	跳过或输出文本列表
知识存储	匹配 `vault` 、 `remember` 、 `brain_knowledge` 的MCP工具	仅在操作手册中记录上次运行信息

User Preferences (Ask)

用户偏好确认（询问）

After discovery, ask the user to confirm:

Channel: Which chat space/channel to post updates to? (List discovered options)
Identity: Post as yourself or a bot identity? (e.g. Anthro Morphic)
Repo scope: Which repo(s) to track? (Default: current repo)
Message style: Brief standup, detailed changelog, or conversational update?
Team context: Any team members to be aware of? (Names, roles)
Triage rules: Any custom rules for handling feedback? (Or use defaults)

完成发现后，向用户确认以下内容：

频道：要将更新发布到哪个聊天空间/频道？（列出发现的可选选项）
身份：以你自己的身份还是机器人身份发布？（例如：Anthro Morphic）
仓库范围：要跟踪哪些仓库？（默认：当前仓库）
消息风格：简洁的站会风格、详细的变更日志，还是对话式更新？
团队上下文：是否需要关注特定团队成员？（姓名、角色）
分类规则：处理反馈是否需要自定义规则？（或使用默认规则）

Save Playbook

保存操作手册

After discovery + user preferences, save the playbook to

.claude/team-update-playbook.md

Read references/playbook-format.md for the full template. Fill in all sections with discovered tools and user preferences. If a capability was not found, note it as "Not available" in the playbook.

Ensure

.claude/

is in

.gitignore

(the playbook contains space IDs and preferences that shouldn't be committed).

完成发现环节和用户偏好确认后，将操作手册保存至

.claude/team-update-playbook.md

。

请阅读 references/playbook-format.md 查看完整模板。填入所有已发现的工具和用户偏好信息。若某功能未找到，在操作手册中标记为“不可用”。

确保

.claude/

已添加至

.gitignore

（操作手册包含不应提交的空间ID和偏好设置）。

Phase 1: Gather Context

阶段1：收集上下文信息

Collect information from all available sources. Use the playbook's "Data Sources" section to know which tools to call.

从所有可用来源收集信息。根据操作手册的“数据源”部分确定要调用的工具。

1a. Determine Time Window

1a. 确定时间窗口

Check the playbook's "Last Run" section for the last update timestamp. If no previous run, ask the user how far back to go (default: 24 hours).

检查操作手册的“上次运行”部分获取上次更新的时间戳。若为首次运行，询问用户需要回溯的时间范围（默认：24小时）。

1b. Collect Data

1b. 收集数据

Gather from each available source:

Source	What to collect	Tool
Git commits	`git log --oneline --since=<last-update>`	Bash
Chat messages	Messages in the configured channel since last update	Chat MCP tool from playbook
Open issues/PRs	Recently updated or newly created items	Issue tracker from playbook
Active tasks	In-progress or recently completed tasks	Task tracker from playbook

从每个可用来源收集信息：

来源	收集内容	工具
Git提交	`git log --oneline --since=<last-update>`	Bash
聊天消息	上次更新后配置频道中的消息	操作手册中指定的聊天MCP工具
未解决的问题/PR	最近更新或新建的条目	操作手册中指定的问题追踪工具
活跃任务	进行中或最近完成的任务	操作手册中指定的任务管理工具

1c. Summarise for Drafting

1c. 整理用于草稿撰写

Group commits by theme (not individual hashes). Note any issues closed, PRs merged, or tasks completed. Flag any team messages that need response.

按主题对提交进行分组（而非单个哈希值）。记录已关闭的问题、已合并的PR或已完成的任务。标记需要回复的团队消息。

Phase 2: Draft and Post Update

阶段2：撰写并发布更新

2a. Compose Message

2a. 撰写消息

Read references/message-composition.md for message patterns.

Follow the playbook's "Message Style" section. General principles:

Lead with what shipped or changed, not process
Group related commits into themes
Mention specific people only when relevant
Keep it scannable (short paragraphs, bullet points)

请阅读 references/message-composition.md 了解消息模式。

遵循操作手册的“消息风格”部分。通用原则：

优先展示已交付或已变更的内容，而非流程
将相关提交按主题分组
仅在相关时提及特定人员
保持内容易读（短段落、项目符号）

2b. Preview and Approval

2b. 预览与确认

Show the draft to the user. Include:

The composed message
Which channel it will be posted to
Whether it's a new message or thread reply

APPROVAL REQUIRED: Never post to external channels without explicit user approval.

向用户展示草稿，包含：

撰写好的消息
将要发布的频道
是新消息还是线程回复

需要确认：未经用户明确批准，不得向外部频道发布内容。

2c. Post

2c. 发布

Post the approved message using the chat tool from the playbook. If no chat tool is available, output the formatted message for the user to post manually.

使用操作手册中的聊天工具发布已确认的消息。若没有可用的聊天工具，输出格式化消息供用户手动发布。

2d. Update Playbook

2d. 更新操作手册

After posting, update the "Last Run" section of the playbook with:

Current timestamp
Thread key (if applicable)
Brief summary of what was posted

发布完成后，更新操作手册的“上次运行”部分，包含：

当前时间戳
线程密钥（如适用）
已发布内容的简要摘要

Phase 3: Read and Triage Feedback

阶段3：读取并分类处理反馈

3a. Read Responses

3a. 读取回复

Read messages from the configured channel since the update was posted. Look for:

Direct replies to the update
New messages in the channel that reference the project
Reactions or acknowledgements

读取更新发布后配置频道中的消息，重点关注：

对更新的直接回复
频道中提及项目的新消息
反应或确认

3b. Classify Feedback

3b. 分类反馈

Read references/feedback-triage.md for classification patterns.

Use the playbook's "Triage Rules" section. Default classification:

Type	Action
Bug report	Create issue (label: bug)
Feature request	Create issue (label: enhancement)
Question	Draft reply for user approval
Blocker	Flag immediately, suggest resolution
Acknowledgement	Note, no action needed
Off-topic	Ignore

请阅读 references/feedback-triage.md 了解分类模式。

遵循操作手册的“分类规则”部分。默认分类：

类型	操作
漏洞报告	创建问题（标签：bug）
功能请求	创建问题（标签：enhancement）
疑问	撰写回复草稿供用户确认
阻塞问题	立即标记，建议解决方案
确认	记录，无需操作
无关内容	忽略

3c. Present and Act

3c. 呈现并执行

Present a summary of feedback with proposed actions:

undefined

向用户展示反馈摘要及建议操作：

undefined

Feedback Summary

反馈摘要

Daniel: "Can we add dark mode?" -> Create issue (enhancement)
Rabin: "Auth is broken on staging" -> Create issue (bug, priority)
Karen: "Looks good!" -> No action

Proceed with these actions?


**APPROVAL REQUIRED**: Never create issues, post replies, or take external actions without explicit user approval.

---

Daniel: "我们能添加深色模式吗？" -> 创建问题（enhancement）
Rabin: " staging环境的认证功能已损坏" -> 创建问题（bug，高优先级）
Karen: "看起来不错！" -> 无需操作

是否执行这些操作？


**需要确认**：未经用户明确批准，不得创建问题、发布回复或执行任何外部操作。

---

Phase 4: Plan Next Steps

阶段4：规划下一步工作

4a. Prioritise

4a. 优先级排序

From all gathered context (commits, issues, tasks, feedback), identify:

Blockers: Things preventing progress
High-priority: Bugs, urgent requests, deadlines
Next up: Planned work, feature requests
Backlog: Nice-to-haves, low-priority items

从所有收集到的上下文信息（提交、问题、任务、反馈）中识别：

阻塞问题：阻碍进度的事项
高优先级：漏洞、紧急请求、截止日期
下一步计划：已规划的工作、功能请求
待办清单：锦上添花的功能、低优先级事项

4b. Present (Not Posted)

4b. 呈现（不发布）

Show the prioritised list to the user. This is for the user's planning only -- do NOT post it to any channel.

undefined

向用户展示优先级排序后的列表。此内容仅用于用户规划——请勿发布到任何频道。

undefined

Suggested Priorities

建议优先级

[BLOCKER] Fix auth on staging (from Rabin's feedback)
[HIGH] Complete API endpoint for user profiles (current sprint)
[NEXT] Dark mode support (from Daniel's request)
[BACKLOG] Refactor database queries

---

[阻塞问题] 修复staging环境的认证功能（来自Rabin的反馈）
[高优先级] 完成用户资料的API端点（当前迭代）
[下一步] 深色模式支持（来自Daniel的请求）
[待办清单] 重构数据库查询

---

Autonomy Rules

自主操作规则

Action	Level
Read/create playbook	Just do it
Discover tools (first run)	Just do it, confirm preferences with user
Gather context (git, chat, issues)	Just do it
Draft update message	Just do it, show preview
Post to external channel	Approval required
Create issues/tasks	Approval required
Post replies to team	Approval required
Update playbook "Last Run"	Just do it
Present plan/priorities	Just do it

操作	权限级别
读取/创建操作手册	直接执行
发现工具（首次运行）	直接执行，需向用户确认偏好
收集上下文信息（Git、聊天、问题）	直接执行
撰写更新消息草稿	直接执行，需展示预览
向外部频道发布内容	需要确认
创建问题/任务	需要确认
向团队发布回复	需要确认
更新操作手册的“上次运行”部分	直接执行
呈现计划/优先级	直接执行

Graceful Degradation

优雅降级

The skill works at any level of tool availability:

Available tools	Experience
Git only	Summarise commits, output text for manual posting
Git + Chat	Full post/read cycle, manual issue creation
Git + Chat + Issues	Full cycle with automated issue creation
Git + Chat + Issues + Tasks + Knowledge	Full cycle with persistent tracking

无论工具可用程度如何，本Skill均可正常工作：

可用工具	使用体验
仅Git	汇总提交记录，输出文本供手动发布
Git + 聊天工具	完整的发布/读取流程，手动创建问题
Git + 聊天工具 + 问题追踪工具	完整流程，支持自动创建问题
Git + 聊天工具 + 问题追踪工具 + 任务管理工具 + 知识存储	完整流程，支持持续跟踪

Operating Modes

运行模式

The skill responds to different trigger phrases:

Trigger	Behaviour
"team update" / "post update"	Full cycle: gather, draft, post, read feedback
"check team chat" / "what did the team say"	Phase 3 only: read and triage feedback
"standup" / "sync with team"	Phase 1 + 2: gather and post, skip feedback
"project update"	Phase 1 + 2 + 4: gather, post, plan (skip feedback triage)
"feedback loop"	Phase 3 + 4: read feedback and plan

本Skill可响应不同的触发指令：

触发指令	行为
"team update" / "post update"	完整流程：收集、撰写、发布、读取反馈
"check team chat" / "what did the team say"	仅阶段3：读取并分类处理反馈
"standup" / "sync with team"	阶段1 + 2：收集并发布，跳过反馈环节
"project update"	阶段1 + 2 + 4：收集、发布、规划（跳过反馈分类）
"feedback loop"	阶段3 + 4：读取反馈并规划

Reference Files

参考文件

When	Read
First run — saving playbook	references/playbook-format.md
First run — detecting tools	references/discovery-patterns.md
Composing update messages	references/message-composition.md
Classifying team feedback	references/feedback-triage.md

场景	读取文件
首次运行 — 保存操作手册	references/playbook-format.md
首次运行 — 检测工具	references/discovery-patterns.md
撰写更新消息	references/message-composition.md
分类团队反馈	references/feedback-triage.md