# Internal Comms

> |

- **Type:** Skill
- **Install:** `agentstack add skill-hhhh124hhhh-skillmate-internal-comms`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hhhh124hhhh](https://agentstack.voostack.com/s/hhhh124hhhh)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [hhhh124hhhh](https://github.com/hhhh124hhhh)
- **Source:** https://github.com/hhhh124hhhh/SkillMate/tree/main/resources/skills/internal-comms

## Install

```sh
agentstack add skill-hhhh124hhhh-skillmate-internal-comms
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 内部通信工具

## 概述

按照公司喜欢的格式编写内部通信内容。

**支持类型**：
- 3P 更新（进展、计划、问题）
- 公司简报
- FAQ 回答
- 状态报告
- 领导更新
- 项目更新
- 事故报告

## 何时使用

**使用此技能**编写：
- 团队状态更新
- 周报/月报
- 项目进展报告
- 问题解答
- 领导层汇报
- 公司内部新闻
- 事故报告

## 3P 更新（进展、计划、问题）

### 格式

```markdown
# 团队名称 - 周报

**日期**：YYYY-MM-DD
**报告人**：姓名

## 进展 (Progress)
- ✅ 完成的项目/任务 1
- ✅ 完成的项目/任务 2
- 🚧 进行中的工作 3（完成度 70%）

## 计划 (Plans)
- 📋 下周计划 1
- 📋 下周计划 2
- 🎯 季度目标进展

## 问题 (Problems)
- ⚠️ 阻塞问题 1（需要支持）
- ⚠️ 风险/挑战 2
- 💡 建议/请求

## 下一步
- [ ] 行动项 1
- [ ] 行动项 2
```

### 示例

```markdown
# 工程平台团队 - 周报

**日期**：2025-01-20
**报告人**：张三

## 进展 (Progress)
- ✅ 完成用户认证系统重构（减少延迟 40%）
- ✅ 部署 CI/CD 管道改进（构建时间减少 25%）
- 🚧 微服务迁移进行中（完成度 60%，3/5 服务已迁移）

## 计划 (Plans)
- 📋 完成剩余 2 个服务的迁移
- 📋 开始性能优化阶段
- 🎯 Q1 目标：所有核心服务迁移完成

## 问题 (Problems)
- ⚠️ 数据库连接池偶尔耗尽（需要 DBA 支持）
- ⚠️ 旧 API 文档不完整，影响迁移进度
- 💡 建议：增加自动化测试覆盖

## 下一步
- [ ] 与 DBA 团队会议（周二 10:00）
- [ ] 完成服务 4 迁移测试
- [ ] 更新 API 文档
```

## 公司简报

### 格式

```markdown
# 公司简报 - 期号

**日期**：YYYY-MM-DD

## 本期亮点
- 要闻 1
- 要闻 2

## 部门动态
- 部门 1：更新内容
- 部门 2：更新内容

## 员工风采
- 员工成就/活动

## 重要日期
- 日期 1：事件
- 日期 2：事件

## 联系方式
如有疑问，联系 [姓名]（邮箱）
```

## FAQ 回答

### 格式

```markdown
# FAQ：[主题]

**更新日期**：YYYY-MM-DD

## 常见问题

### Q: 问题 1？
**A**: 详细回答...

### Q: 问题 2？
**A**: 详细回答...

## 相关资源
- 链接 1
- 链接 2
```

## 状态报告

### 格式

```markdown
# 项目状态报告：[项目名称]

**报告日期**：YYYY-MM-DD
**项目经理**：姓名

## 执行摘要
[1-2 句话总结项目当前状态]

## 整体状态
🟢 正常 / 🟡 有风险 / 🔴 严重问题

## 本周进展
### 里程碑
- ✅ 里程碑 1 完成
- 🚧 里程碑 2 进行中

### 指标
| 指标 | 目标 | 当前 | 状态 |
|------|------|------|------|
| 完成度 | 100% | 75% | 🟡 |
| 预算 | $50K | $42K | 🟢 |

## 风险和问题
### 风险
1. **风险描述**
   - 影响：高/中/低
   - 缓解措施：...

### 问题
1. **问题描述**
   - 状态：开放/进行中/已解决
   - 负责人：姓名

## 下周计划
- [ ] 任务 1
- [ ] 任务 2

## 决策请求
- 决策 1（需要审批）
- 决策 2（需要输入）
```

## 领导更新

### 格式

```markdown
# 领导层更新 - [月度]

**日期**：YYYY-MM-DD
**接收人**：领导团队

## 战略目标进展
### 目标 1：[名称]
- 当前状态：🟢/🟡/🔴
- 本月进展：...
- 预期完成：YYYY-MM-DD

## 关键指标
| 指标 | 本月 | 上月 | 变化 |
|------|------|------|------|
| 收入 | $X | $Y | +Z% |

## 重要成就
- 成就 1
- 成就 2

## 需要支持
- 支持 1
- 支持 2
```

## 项目更新

### 格式

```markdown
# 项目更新：[项目名称]

**更新日期**：YYYY-MM-DD
**阶段**：[当前阶段]

## 自上次更新以来的进展
- 完成的任务
- 达成的里程碑

## 当前工作
- 正在进行的任务
- 下一步行动

## 阻塞和依赖
- 阻塞问题
- 等待的依赖

## 时间表更新
- 开始日期：...
- 完成日期：...
- 里程碑调整：...

## 风险
- 新风险
- 风险状态更新
```

## 事故报告

### 格式

```markdown
# 事故报告：[简短描述]

**事故 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：周报更新

```markdown
# 工程团队 - 第 3 周更新

本周完成了 API 重构，开始下一阶段的性能优化。
遇到一些数据库问题，需要 DBA 支持。

详见：
- 进展：3 个主要任务完成
- 问题：1 个阻塞问题
- 下周：2 个计划任务
```

### 场景 2：项目里程碑

```markdown
# 里程碑更新：Phase 1 完成

🟢 状态：完成

我们很高兴地宣布，项目 Phase 1 已完成！
核心功能全部就绪，测试覆盖率达标。

下一步：Phase 2 准备工作
```

### 场景 3：问题升级

```markdown
# ⚠️ 问题升级：生产环境性能

🔴 严重性：P1

影响：
- 用户响应时间增加 300%
- 错误率上升至 5%

已采取的行动：
- 回滚最近部署
- 启用缓存

需要：
- 架构团队审查
- 性能分析支持
```

## 关键原则

- **清晰明确**：使用具体语言和数字
- **结构化**：标题、项目符号、表格
- **可操作**：明确的下一步和责任人
- **诚实透明**：如实报告问题和风险
- **简洁专业**：尊重读者时间
- **频繁更新**：定期沟通进展

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hhhh124hhhh](https://github.com/hhhh124hhhh)
- **Source:** [hhhh124hhhh/SkillMate](https://github.com/hhhh124hhhh/SkillMate)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hhhh124hhhh-skillmate-internal-comms
- Seller: https://agentstack.voostack.com/s/hhhh124hhhh
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.