跳转到主要内容

核心场景

场景 1: 自动生成和更新文档

真实案例: 安全团队使用 AI 组合多个文档创建 runbook 和故障排除指南。

在 Happycapy 中的做法

请求全面的文档创建:
帮我创建"新员工入职指南":

输入文档:
- 公司政策文档 (policy.pdf)
- 技术栈概览 (tech_stack.md)
- FAQ (faq.docx)
- 团队联系人 (contacts.xlsx)

输出要求:
- Markdown 格式,带清晰的章节结构
- 提取关键信息并去除冗余
- 添加目录和快速索引
- 在每节末尾添加"延伸阅读"链接
- 最后生成 PDF 版本

Happycapy 会做什么

读取文档

读取所有输入文档

提取与组织

提取和组织信息

结构化内容

生成结构化文档

多种格式

输出 Markdown 和 PDF 版本

场景 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 工作量

下一步