Daily Workflow Skill (中文版)
管理工作会话,自动化项目文档追踪,支持 AI 间项目交接。
首次使用配置
当技能首次被触发时,检查配置文件 .workbuddy/daily-workflow-config.json 是否存在。
如果配置文件不存在,执行以下初始化流程:
-
询问用户自定义暗语
- 询问用户希望使用什么暗语来触发三个工作流节点
- 提供默认建议:
- 开工暗语:开工啦
- 吃饭暗语:吃饭啦
- 收工暗语:收工啦
- 允许用户自定义每个暗语
- 支持中英文混合
-
创建配置文件
- 在项目根目录的
.workbuddy/文件夹中创建daily-workflow-config.json - 文件格式:
{ "startPhrase": "开工啦", "lunchPhrase": "吃饭啦", "endPhrase": "收工啦", "language": "zh-CN", "firstRun": false } - 在项目根目录的
-
确认配置
- 向用户展示配置结果
- 说明可以随时修改配置文件或重新运行配置
如果配置文件已存在,直接读取配置并使用用户设定的暗语。
技能触发时机
根据配置文件中的暗语触发技能,默认触发词:
- "开工啦" - 开始工作日
- "吃饭啦" - 工作中途检查点(午休前)
- "收工啦" - 结束工作日
这些短语标志著有意图的工作会话边界,应该捕获和恢复项目状态。
核心工作流
Phase 1: 开工 ("开工啦")
当用户表示开始工作时,执行以下流程:
-
确保 Docs 目录存在
- 检查工作区根目录是否存在
Docs/目录 - 如果不存在,创建
Docs/
- 检查工作区根目录是否存在
-
检查并创建所需文件
- 验证
Docs/中是否存在以下五个文件:PROJECT_TARGET.md- 项目目标和目的PROJECT_STATUS.md- 当前项目状态COMPLETED_JOBS.md- 已完成的工作项目PENDING_JOBS.md- 待处理/未完成的工作项目NEXT_STEPS.md- 计划的下一步
- 创建任何缺失的文件,使用适当的模板标头
- 验证
-
读取所有文档
- 读取
Docs/中的所有五个文件 - 提取关键信息:
- 当前项目目标
- 最新项目状态
- 最近完成的工作
- 待处理任务和支持问题
- 计划的下一步
- 读取
-
展示工作会话简报
- 总结当前项目状态
- 强调自上次会话以来完成的工作
- 识别待处理任务
- 建议当前会话的优先工作
- 询问用户确认或调整计划
Phase 1.5: 吃饭啦(工作中途检查点)
当用户说"吃饭啦"(或自定义暗语)时,执行以下流程:
目的: 在午休或长时间中断前,更新项目状态,确保回来后能快速恢复工作。
-
更新项目状态
- 更新
Docs/PROJECT_STATUS.md,记录:- 当前完成百分比
- 正在进行的任务
- 当前焦点领域
- 任何项目方向的变化
- 更新
-
更新已完成工作
- 将上午完成的工作项目追加到
Docs/COMPLETED_JOBS.md - 使用格式:
## [YYYY-MM-DD 上午]\n- [已完成项目1]\n- [已完成项目2] - 包含足够细节,让另一个 AI 能理解做了什么
- 将上午完成的工作项目追加到
-
更新待处理工作
- 更新
Docs/PENDING_JOBS.md,记录:- 已开始但未完成的任务
- 遇到的阻碍
- 推迟到下午的任务
- 从待处理列表中移除已完成项目
- 更新
-
更新下一步计划
- 写入清晰的、可操作的下一步到
Docs/NEXT_STEPS.md - 包含:
- 下午回来后要处理的具体任务
- 优先顺序
- 任何先决条件或依赖关系
- 立即恢复工作所需的上下文
- 写入清晰的、可操作的下一步到
-
展示中途检查摘要
- 总结上午完成的工作
- 列出更新的文档文件
- 确认下午的下一步已清楚记录
- 确保回来工作时能快速恢复状态
Phase 2: 收工 ("收工啦")
当用户表示结束工作时,执行以下流程:
-
更新已完成工作
- 将今天完成的工作项目追加到
Docs/COMPLETED_JOBS.md - 使用格式:
## [YYYY-MM-DD]\n- [已完成项目1]\n- [已完成项目2] - 包含足够细节,让另一个 AI 能理解做了什么
- 将今天完成的工作项目追加到
-
更新待处理工作
- 更新
Docs/PENDING_JOBS.md,包含:- 已开始但未完成的任务
- 遇到的阻碍
- 推迟到下次会话的任务
- 从待处理列表中移除已完成项目
- 更新
-
更新项目状态
- 更新
Docs/PROJECT_STATUS.md,包含:- 当前完成百分比
- 达到的关键里程碑
- 当前焦点领域
- 任何项目方向的变化
- 更新
-
更新项目目标(如需要)
- 仅在以下情况修改
Docs/PROJECT_TARGET.md:- 项目目标已变更
- 发现新需求
- 需要调整范围
- 否则,保持不变
- 仅在以下情况修改
-
更新下一步
- 写入清晰的、可操作的下一步到
Docs/NEXT_STEPS.md - 包含:
- 下次会话要处理的具体任务
- 优先顺序
- 任何先决条件或依赖关系
- 立即恢复工作所需的上下文
- 写入清晰的、可操作的下一步到
-
展示会话摘要
- 总结完成的工作
- 列出更新的文档文件
- 确认下一步已清楚记录
- 确保为下一个 AI 准备好交接状态
文件模板
创建缺失文件时,使用以下模板:
PROJECT_TARGET.md
# 项目目标
## 项目概述
[描述项目的主要目标]
## 关键目标
- [目标1]
- [目标2]
## 成功标准
- [标准1]
- [标准2]
## 最后更新
[YYYY-MM-DD]
PROJECT_STATUS.md
# 项目状态
## 当前状态
[当前状态的简要描述]
## 完成度
[XX]% 完成
## 当前焦点
[现在正在做什么]
## 最近里程碑
- [YYYY-MM-DD] [里程碑描述]
## 最后更新
[YYYY-MM-DD]
COMPLETED_JOBS.md
# 已完成工作
## [YYYY-MM-DD]
- [已完成任务1]
- [已完成任务2]
## [YYYY-MM-DD 上午]
- [上午完成的任务1]
## [YYYY-MM-DD]
- [已完成任务1]
PENDING_JOBS.md
# 待处理工作
## 高优先级
- [ ] [任务1]
- [ ] [任务2]
## 中优先级
- [ ] [任务3]
## 低优先级
- [ ] [任务4]
## 阻碍
- [阻碍描述(如有)]
NEXT_STEPS.md
# 下一步
## 立即行动(下次会话)
1. [行动1 - 附上下文]
2. [行动2 - 附上下文]
## 即将到来的任务
- [任务1]
- [任务2]
## 给下一个 AI 的笔记
[重要上下文、做出的决定、需要记住的事情]
AI 到 AI 交接原则
写入所有文档时,假设下一个读者将是一个不同的 AI 实例,它需要:
- 理解正在构建什么以及为什么
- 无需询问基本问题即可恢复工作
- 继续相同的编码风格和约定
- 尊重已做出的决定
关键实践:
- 详细写入,而非简写
- 解释"为什么"而不仅仅是"是什么"
- 在相关时包含代码片段或文件引用
- 记录任何变通方法、技巧或技术债务
- 记录用户偏好和决定
工作流图表
用户说"开工啦"
↓
检查 Docs/ 是否存在 → 如缺失则创建
↓
检查 5 个文件是否存在 → 创建缺失的模板
↓
读取所有 5 个文件
↓
展示工作会话简报
↓
用户与 AI 协助工作
↓
用户说"吃饭啦"(午休检查点)
↓
更新 PROJECT_STATUS.md
↓
更新 COMPLETED_JOBS.md
↓
更新 PENDING_JOBS.md
↓
更新 NEXT_STEPS.md
↓
展示中途检查摘要
↓
用户午休后返回继续工作
↓
用户说"收工啦"
↓
更新 COMPLETED_JOBS.md
↓
更新 PENDING_JOBS.md
↓
更新 PROJECT_STATUS.md
↓
更新 PROJECT_TARGET.md(如需要)
↓
更新 NEXT_STEPS.md
↓
展示会话摘要
↓
项目状态已保存,供下一个 AI 使用
重要注意事项
- 引用
Docs/目录时始终使用绝对路径 - 追加到
COMPLETED_JOBS.md(绝不覆盖先前的条目) - 每次会话覆盖
NEXT_STEPS.md(它是为紧接的下一个会话准备的) - 在
PROJECT_STATUS.md和COMPLETED_JOBS.md中保留历史信息 - 如有疑问,写入更多上下文,而非更少
- 首次使用时会询问用户自定义暗语,后续使用已保存的配置
- 配置文件位置:
.workbuddy/daily-workflow-config.json