核心场景
场景 1: 自动生成和更新文档
真实案例: 安全团队使用 AI 组合多个文档创建 runbook 和故障排除指南。
在 Happycapy 中的做法
请求全面的文档创建:
帮我创建"新员工入职指南":
输入文档:
- 公司政策文档 (policy.pdf)
- 技术栈概览 (tech_stack.md)
- FAQ (faq.docx)
- 团队联系人 (contacts.xlsx)
输出要求:
- Markdown 格式,带清晰的章节结构
- 提取关键信息并去除冗余
- 添加目录和快速索引
- 在每节末尾添加"延伸阅读"链接
- 最后生成 PDF 版本
Happycapy 会做什么
场景 2: 会议纪要和行动事项管理
在 Happycapy 中的做法
将会议记录转换为可操作的文档:
这是今天产品会议的记录:
[粘贴记录]
请:
1. 总结关键讨论点
2. 提取所有行动事项并标记负责人和截止日期
3. 识别未解决的问题
4. 生成结构化的会议纪要
5. 创建任务跟踪表(CSV 格式),可以
导入 Asana/Jira
Happycapy 会做什么
- 分析会议内容
- 提取关键信息
- 生成易于阅读的纪要
- 创建可操作的待办事项列表
团队协作建议
1. 分享成功的工作流
建立知识共享文化:
团队成员向彼此展示他们如何使用 Happycapy 完成任务
从队友的示例中学习使用 Happycapy 的新方法
创建团队的最佳实践和有效提示库
2. 创建团队知识库
系统化团队知识:
将常用提示保存在团队文档中,或将其优化为技能。新人可以直接安装和使用。持续优化和迭代。
示例知识库结构:
team-knowledge-base/
├── prompts/
│ ├── code-review-checklist.md
│ ├── bug-report-template.md
│ └── feature-spec-template.md
├── skills/
│ ├── team-report-generator/
│ └── sprint-summary/
└── guides/
├── onboarding-guide.md
└── common-workflows.md
3. 会话结束时更新文档
维护活文档:
使用 Happycapy 完成[任务]后:
1. 总结我们完成的工作
2. 记录使用的工作流
3. 注意任何挑战以及我们如何解决
4. 用学到的东西更新团队文档
5. 为下次提出任何改进建议
这确保团队知识随着每个项目增长。
真实案例
示例 1: 项目交接文档
创建全面的项目交接文档:
项目: [项目名称]
背景: [简要描述]
包含来自以下的文档:
- 架构决策 (architecture.md)
- API 文档 (swagger.yaml)
- 数据库架构 (schema.sql)
- 部署指南 (deploy-notes.md)
- 已知问题 (issues.md)
生成:
1. 执行摘要(面向利益相关者)
2. 技术概览(面向工程师)
3. 快速入门指南(面向新团队成员)
4. 故障排除指南(常见问题 + 解决方案)
5. 未来路线图(计划改进)
格式: Markdown + PDF
语气: 清晰、简洁,假设读者聪明但不熟悉项目
示例 2: Sprint 回顾文档
处理我们的 sprint 回顾笔记:
[粘贴原始笔记或上传文档]
创建:
1. 进展顺利的总结
2. 面临的挑战总结
3. 带负责人和截止日期的行动事项
4. 指标对比(计划 vs 实际)
5. 关键学习
6. 下一个 sprint 的延续事项
格式为:
- Markdown 文档供团队参考
- 演示幻灯片供利益相关者更新
- 项目管理工具的行动事项 CSV
示例 3: 知识库文章
从这个支持线程创建知识库文章:
[粘贴支持对话]
文章应包括:
1. 问题陈述(问题是什么?)
2. 根本原因(为什么会发生?)
3. 解决方案(分步说明)
4. 预防(如何在将来避免)
5. 相关问题(类似问题的链接)
格式:
- 清晰的标题
- 技术说明的代码块
- 截图参考(描述应显示什么)
- 对搜索友好的关键词
受众: 技术支持团队和高级用户
示例 4: 团队 Wiki 更新
我们的团队 wiki 已过时。帮我更新:
当前 wiki: [提供链接或粘贴内容]
最近的变化:
- 新团队成员: [列表]
- 弃用的工具: [列表]
- 新流程: [描述]
- 更新的联系信息: [提供]
请:
1. 识别过时的部分
2. 为每个部分建议更新
3. 重新组织以便更好导航
4. 添加缺失的信息
5. 删除冗余内容
6. 确保格式一致
输出 Markdown 格式的更新 wiki 内容。
示例 5: 跨团队对齐文档
为跨团队项目创建对齐文档:
涉及的团队:
- 工程: [关注领域]
- 设计: [关注领域]
- 产品: [关注领域]
- 营销: [关注领域]
项目: [描述]
文档应包括:
1. 共同目标和成功指标
2. 每个团队的职责
3. 团队之间的依赖关系
4. 沟通协议
5. 时间表和里程碑
6. 决策流程
7. 风险评估
格式: 所有团队都可以参考的协作文档
语气: 清晰、中立,关注对齐而非责备
高级协作工作流
版本控制文档
帮我设置带版本控制的文档工作流:
要求:
1. 基于 Markdown 的文档
2. Git 版本控制
3. 自动生成目录
4. 链接验证
5. 变更日志生成
设置:
- 目录结构
- 验证的预提交钩子
- 用于自动检查的 GitHub Actions
- 团队贡献指南
提供设置说明和模板。
自动化状态报告
生成每周团队状态报告:
数据源:
- GitHub: 合并的 PR、关闭的问题
- Jira: 完成的工单、进行中的工单
- 团队日历: 关键会议和决定
报告格式:
1. 执行摘要
- 关键成就
- 显著障碍
- 下周优先事项
2. 详细指标
- 速度(完成的故事点)
- Bug 解决率
- PR 审查周转时间
3. 团队亮点
- 个人贡献
- 学习和发展
4. 即将到来
- 下一个 sprint 目标
- 关键日期和截止日期
自动化这个每周五下午 4 点运行。(Pro/Max 套餐)
入职自动化
为新工程师创建自动化入职工作流:
第 1 天任务:
- 账户设置指南(分步)
- 开发环境设置
- 首次提交教程
- 团队介绍
第 1 周任务:
- 代码库架构概览
- 常见工作流文档
- 入门任务(好的首次问题)
第 2-4 周任务:
- 渐进复杂度任务
- 导师配对时间表
- 检查点
生成:
1. 新员工清单
2. 自动邮件序列(起草内容)
3. 在关键点发送的 Slack 消息
4. 经理检查指南
使其全面但不令人不知所措。
决策文档
记录这个架构决策:
背景: [描述情况]
考虑的选项: [列出选项]
决定: [我们选择了什么]
理由: [为什么选择它]
格式为架构决策记录(ADR):
- 标题: [简洁描述]
- 状态: [提议/接受/弃用]
- 背景: [背景和约束]
- 决定: [我们决定了什么]
- 后果: [积极和消极结果]
- 替代方案: [我们没选择什么及原因]
添加到我们在 docs/decisions/ 的 ADR 集合
跨职能规划
促进跨职能规划会议:
目标: 规划第二季度产品发布
参与者:
- 工程: [团队规模和关注]
- 设计: [团队规模和关注]
- 产品: [优先级]
- 营销: [优先级]
帮我:
1. 创建规划会议议程
2. 为每个职能生成讨论提示
3. 创建依赖关系映射模板
4. 时间线可视化(甘特图数据)
5. 资源分配规划
6. 风险识别框架
7. 成功指标定义
输出:
- 参与者预读文档
- 会议促进指南
- 捕获决策的模板
- 会后总结格式
协作最佳实践
建立团队约定
沟通渠道
何时使用 Slack vs 邮件 vs 文档
创建可重用模板
为[文档类型]创建可重用模板:
标准部分:
- [列出必需部分]
可选部分:
- [列出可选部分]
包括:
- Markdown 模板文件
- 使用说明
- 示例填写版本
- 完整性清单
保存在团队模板仓库中。
实施审查周期
设置文档审查工作流:
1. 作者创建草稿
2. 同行审查(技术准确性)
3. 编辑审查(清晰度、语法)
4. 利益相关者审查(对齐)
5. 最终批准
创建:
- 每个阶段的审查清单
- 反馈模板
- 批准流程
- 版本跟踪系统
与我们现有的工具集成: [列出工具]
知识捕获
解决困难问题后,立即记录:我们刚刚解决了[问题]。帮我记录:
1. 问题是什么?
2. 我们如何诊断?
3. 解决方案是什么?
4. 将来如何预防?
5. 我们学到了什么?
添加到[类别]下的团队知识库。
衡量协作成功
跟踪这些指标来衡量改进:
| 指标 | Happycapy 之前 | Happycapy 之后 | 改进 |
|---|
| 新团队成员入职时间 | 2-3 周 | 3-5 天 | 快 70% |
| 会议纪要周转 | 2-3 天 | 当天 | 快 75% |
| 文档更新频率 | 每月 | 每周 | 4 倍频繁 |
| 知识库文章 | 零星 | 系统化 | 持续增长 |
| 跨团队对齐时间 | 多天往返 | 单个文档 | 快 80% |
有效团队协作的技巧
定期同步点
安排定期文档更新:
- 每天: 更新任务状态
- 每周: Sprint 总结、团队更新
- 每月: 回顾、指标审查
- 每季度: 战略规划、路线图更新
异步沟通
将这个 Slack 讨论转换为决策文档:
[粘贴 Slack 对话]
提取:
1. 正在讨论的问题
2. 提出的解决方案
3. 提出的担忧
4. 最终决定
5. 行动事项
格式为可以稍后引用的持久文档,
这样人们不需要在 Slack 历史中挖掘。
透明文档
使信息可访问:
- 使用一致的命名
- 创建清晰的文件夹结构
- 添加对搜索友好的标签
- 链接相关文档
- 让文档靠近代码
持续改进
审查我们团队的文档实践:
当前状态:
- 我们使用的工具: [列表]
- 痛点: [列表]
- 进展顺利的: [列表]
建议改进:
1. 流程优化
2. 工具集成
3. 模板更新
4. 培训需求
按以下方式优先级排序: 影响 vs 工作量
下一步