Evilom
3.7 KiB
3.7 KiB
Gh8cw3QnJiplq1k2lmFcajidnHl
Source: https://dianchukeji.feishu.cn/wiki/Gh8cw3QnJiplq1k2lmFcajidnHl
一.工作内容概述
- 开始账号数据框架搭建，完善体力系统相关功能
- 工作流优化探索，尝试引入Codex审查步骤；结合Obsidian进行相关文档、开发日志整理。
二.工作流优化探索相关
尝试使用 Codex 插件进行功能审查
背景与痛点
目前中大型功能由 Agent Team 协作完成后直接提交，缺少独立的外部审查环节，即使原流程中已经有审查验证步骤，还是会有BUG遗漏。
今日实践
在ClaudeCode里安装了Codex插件，在体力系统代码完成后，执行了 /codex:review。Codex 作为"外部 reviewer"，从第三方视角审查了工作树 diff，审查范围覆盖全部变更文件。
效果评估
- **效果&成本收益：**审查耗时约 3-5 分钟，成功发现4个有效问题。
- **后续考虑：**将这一步骤作为复杂功能（涉及多文件改动）的固定收尾步骤
待优化点
- **触发方式：**目前 Codex review 是手动触发（/codex:review），后续可考虑写入rules，在AgentTeam交付后自动提醒是否要启动Codex review
Obsidian 文档与开发日志体系
背景与痛点
项目文档和开发日志之前分散在三个地方：
- CLAUDE.md：项目总体说明，更新频率低
- memory 文件：对话上下文中的记忆片段，跨 session 易丢失
- 对话上下文：即时讨论，压缩后不可回溯 这种分散导致：
- 跨 session 复盘困难，需要翻阅多段对话才能还原完整上下文
- 技术决策缺少归档，后续重复讨论同样问题
- 待办事项散落在各处，容易遗漏
今日实践
Obsidian Vault 与项目仓库联动
- 将 Obsidian-Vault/ 目录纳入项目仓库，实现文档与代码版本同步
- 开发日志按日期归档，命名格式 YYYY-MM-DD.md，便于按时间线回溯 开发日志自动维护规则
- 触发时机：每次 session 结束、上下文压缩时写入开发日志
- 格式规范：
- 今日日志完整记录了体力系统的全部改动（5 个文件的具体修改点）和 Codex review 结果（4 个问题及修复状态） 上下文压缩后的日志补写机制
- 问题发现：
- 上下文压缩由系统自动触发，恢复对话后ClaudeCode没有把"恢复信号"和"日志写入"正确关联，错误地将其当成了"继续同一个 session"，没有识别出这是一个需要执行日志写入的边界点。从而导致遗漏了一次日志写入，手动要求后进行补写。
- 修复措施：
- 立即补写 2026-04-30.md 的开发日志
- 在 memory 中建立了反馈规则：每次压缩上下文后，先检查当天日志是否完整，缺失则立即补写。
效果评估
- **可执行性：**开发日志变为实际可执行、可回溯的产出，方便进行复盘。
- **结构清晰：**跨 session 时，记忆（memory，快速上下文）+ 日志（Obsidian，结构化归档）+ 代码（git，具体实现）三层体系形成互补结构
待优化点
- **自动化程度：**开发日志目前需要手动整理后写入，后续可以探索让 Agent 在关键节点自动追加（如每完成一个文件修改时自动写入 ## 文件改动 小节）
- **日志拆分：**当日志内容过长，可以考虑对其进行进一步拆分，方便定位不同模块的信息。
- **模板化：**为不同类型的 session 定义模板（开发 session / review session / 规划 session等），减少生成时间成本
