| name | internal-comms |
| description | 内部通信工具 - 帮助编写各类内部通信内容，使用公司喜欢的格式。
支持状态报告、领导更新、简报、项目更新等。当用户需要：写内部邮件、状态报告、团队更新时触发此技能。
|
内部通信工具
概述
按照公司喜欢的格式编写内部通信内容。
支持类型：
- 3P 更新（进展、计划、问题）
- 公司简报
- FAQ 回答
- 状态报告
- 领导更新
- 项目更新
- 事故报告
何时使用
使用此技能编写：
- 团队状态更新
- 周报/月报
- 项目进展报告
- 问题解答
- 领导层汇报
- 公司内部新闻
- 事故报告
3P 更新（进展、计划、问题）
格式
# 团队名称 - 周报
**日期**：YYYY-MM-DD
**报告人**：姓名
## 进展 (Progress)
- ✅ 完成的项目/任务 1
- ✅ 完成的项目/任务 2
- 🚧 进行中的工作 3（完成度 70%）
## 计划 (Plans)
- 📋 下周计划 1
- 📋 下周计划 2
- 🎯 季度目标进展
## 问题 (Problems)
- ⚠️ 阻塞问题 1（需要支持）
- ⚠️ 风险/挑战 2
- 💡 建议/请求
## 下一步
- [ ] 行动项 1
- [ ] 行动项 2
示例
# 工程平台团队 - 周报
**日期**：2025-01-20
**报告人**：张三
## 进展 (Progress)
- ✅ 完成用户认证系统重构（减少延迟 40%）
- ✅ 部署 CI/CD 管道改进（构建时间减少 25%）
- 🚧 微服务迁移进行中（完成度 60%，3/5 服务已迁移）
## 计划 (Plans)
- 📋 完成剩余 2 个服务的迁移
- 📋 开始性能优化阶段
- 🎯 Q1 目标：所有核心服务迁移完成
## 问题 (Problems)
- ⚠️ 数据库连接池偶尔耗尽（需要 DBA 支持）
- ⚠️ 旧 API 文档不完整，影响迁移进度
- 💡 建议：增加自动化测试覆盖
## 下一步
- [ ] 与 DBA 团队会议（周二 10:00）
- [ ] 完成服务 4 迁移测试
- [ ] 更新 API 文档
公司简报
格式
# 公司简报 - 期号
**日期**：YYYY-MM-DD
## 本期亮点
- 要闻 1
- 要闻 2
## 部门动态
- 部门 1：更新内容
- 部门 2：更新内容
## 员工风采
- 员工成就/活动
## 重要日期
- 日期 1：事件
- 日期 2：事件
## 联系方式
如有疑问，联系 [姓名]（邮箱）
FAQ 回答
格式
# FAQ：[主题]
**更新日期**：YYYY-MM-DD
## 常见问题
### Q: 问题 1？
**A**: 详细回答...
### Q: 问题 2？
**A**: 详细回答...
## 相关资源
- 链接 1
- 链接 2
状态报告
格式
# 项目状态报告：[项目名称]
**报告日期**：YYYY-MM-DD
**项目经理**：姓名
## 执行摘要
[1-2 句话总结项目当前状态]
## 整体状态
🟢 正常 / 🟡 有风险 / 🔴 严重问题
## 本周进展
### 里程碑
- ✅ 里程碑 1 完成
- 🚧 里程碑 2 进行中
### 指标
| 指标 | 目标 | 当前 | 状态 |
|------|------|------|------|
| 完成度 | 100% | 75% | 🟡 |
| 预算 | $50K | $42K | 🟢 |
## 风险和问题
### 风险
1. **风险描述**
- 影响：高/中/低
- 缓解措施：...
### 问题
1. **问题描述**
- 状态：开放/进行中/已解决
- 负责人：姓名
## 下周计划
- [ ] 任务 1
- [ ] 任务 2
## 决策请求
- 决策 1（需要审批）
- 决策 2（需要输入）
领导更新
格式
# 领导层更新 - [月度]
**日期**：YYYY-MM-DD
**接收人**：领导团队
## 战略目标进展
### 目标 1：[名称]
- 当前状态：🟢/🟡/🔴
- 本月进展：...
- 预期完成：YYYY-MM-DD
## 关键指标
| 指标 | 本月 | 上月 | 变化 |
|------|------|------|------|
| 收入 | $X | $Y | +Z% |
## 重要成就
- 成就 1
- 成就 2
## 需要支持
- 支持 1
- 支持 2
项目更新
格式
# 项目更新：[项目名称]
**更新日期**：YYYY-MM-DD
**阶段**：[当前阶段]
## 自上次更新以来的进展
- 完成的任务
- 达成的里程碑
## 当前工作
- 正在进行的任务
- 下一步行动
## 阻塞和依赖
- 阻塞问题
- 等待的依赖
## 时间表更新
- 开始日期：...
- 完成日期：...
- 里程碑调整：...
## 风险
- 新风险
- 风险状态更新
事故报告
格式
# 事故报告：[简短描述]
**事故 ID**：INC-XXX
**日期**：YYYY-MM-DD HH:MM
**严重性**：P1/P2/P3/P4
## 执行摘要
[1-2 段话总结事故]
## 时间线
| 时间 | 事件 |
|------|------|
| HH:MM | 事故发生 |
| HH:MM | 检测到 |
| HH:MM | 开始响应 |
| HH:MM | 解决 |
## 影响
- **用户影响**：[描述]
- **服务中断**：[持续时间]
- **数据丢失**：是/否
## 根本原因
[事故原因分析]
## 即时行动
- 采取的行动 1
- 采取的行动 2
## 长期预防
- 预防措施 1
- 预防措施 2
## 经验教训
- 学到的教训
- 改进建议
最佳实践
1. 清晰简洁
好的：
✅ 完成用户认证系统（延迟降低 40%）
不好的：
❌ 我们一直在做用户认证系统的工作，
现在基本完成了，性能应该好了一些
2. 使用状态指示器
- ✅ 完成
- 🚧 进行中
- 📋 计划中
- ⚠️ 问题/风险
- 🎯 目标
- 🟢 正常
- 🟡 有风险
- 🔴 严重问题
3. 可操作的更新
好的：
⚠️ 数据库连接池耗尽
需要：DBA 团队审查配置
行动：安排周二会议
不好的：
❌ 数据库有点问题，我们正在看
4. 量化和具体
好的：
✅ 性能提升：延迟降低 40%（500ms → 300ms）
✅ 覆盖率：测试覆盖从 60% 提升到 85%
不好的：
❌ 性能好多了
❌ 测试增加了
写作技巧
标题和摘要
- 使用清晰、描述性的标题
- 执行摘要限制在 2-3 句话
- 将最重要的信息放在前面
结构
- 使用标题分隔部分
- 使用项目符号列出清单
- 使用表格展示数据
- 使用加粗强调关键点
语气
- 专业但不过于正式
- 直接明确，避免模糊
- 客观陈述事实
- 建设性提出问题
时间和日期
- 使用 ISO 格式（YYYY-MM-DD）
- 明确时间范围（本周、下周）
- 标注截止日期
常见场景
场景 1：周报更新
# 工程团队 - 第 3 周更新
本周完成了 API 重构，开始下一阶段的性能优化。
遇到一些数据库问题，需要 DBA 支持。
详见：
- 进展：3 个主要任务完成
- 问题：1 个阻塞问题
- 下周：2 个计划任务
场景 2：项目里程碑
# 里程碑更新：Phase 1 完成
🟢 状态：完成
我们很高兴地宣布，项目 Phase 1 已完成！
核心功能全部就绪，测试覆盖率达标。
下一步：Phase 2 准备工作
场景 3：问题升级
# ⚠️ 问题升级：生产环境性能
🔴 严重性：P1
影响：
- 用户响应时间增加 300%
- 错误率上升至 5%
已采取的行动：
- 回滚最近部署
- 启用缓存
需要：
- 架构团队审查
- 性能分析支持
关键原则
- 清晰明确：使用具体语言和数字
- 结构化：标题、项目符号、表格
- 可操作：明确的下一步和责任人
- 诚实透明：如实报告问题和风险
- 简洁专业：尊重读者时间
- 频繁更新：定期沟通进展
