Project Methodology — 项目方法论

项目方法论 针对Hermes Agent的完整、经过实战测试的会话生命周期。每个会话都遵循相同的周期：热身（warm up）→ 计划（plan）→ 构建（build）→ 回顾（recap）→ 总结（wrap up）。这个技能将这五个阶段整合到一个工作流中，以确保不会遗忘任何步骤，并且每个会话都能从上一个会话结束的地方继续。

周期：热身（warmup）→ 计划（plan）→ 构建（build）→ 回顾（recap）→ 总结（wrapup）→ （下一个会话）热身（warmup）→ ...

阶段 什么时候做 什么 热身（Warmup） 会话开始 加载项目上下文，检查活跃计划，检查知识图 计划（Plan） 开始非平凡工作之前 草拟一个具有验收标准的功能计划 构建（Build） 计划被接受后 实施计划（实际工作） 回顾（Recap） 总结之前 走过验收标准，草拟会话回顾 总结（Wrapup） 会话结束 验证交接，更新文档，漂移检查

阶段 1：热身（Warmup）- 加载上下文 在会话开始时使用。加载项目内存，最近的回顾，活跃计划和知识图健康状态到一个状态总结中。

• 确认方法论正在使用中 [ -f CLAUDE.md ] || [ -f PROJECT.md ] || echo "警告：没有找到项目内存文件"

[ -d docs/recaps ] && echo "OK：回顾" || echo "信息：还没有回顾" [ -d docs/plans ] && echo "OK：计划" || echo "信息：还没有计划" 如果没有项目内存文件，建议运行 init-project-structure（见参考）来搭建方法论。

• 检查项目知识图（如果安装了）

python3 ~/.hermes/scripts/project-knowledge-index.py doctor 2>/dev/null | head -10 如果健康，记录块计数和项目列表。跨项目知识在会话期间可用。如果没有安装，跳过 - 它是可选的。

• 读取基础文件

按以下顺序读取： 项目内存文件（CLAUDE.md）- 硬性规则，今天的状态，指针索引 本地环境文件（CLAUDE.local.md）- 凭据和 URL。不要自动读取此文件。仅当用户明确要求检查凭据、连接字符串或环境变量时才读取，并且仅在当前回合之后。 永远不要将内容粘贴到聊天输出中。

• 读取最新回顾

# 探测回顾目录 for dir in docs/recaps .hermes/recaps docs/daily-recaps; do [ -d "$dir" ] && ls -t "$dir"/.md 2>/dev/null | head -3 && break done 读取最新回顾的全部内容。读取前 1-2 个回顾的标题（摘要、计划、开放问题）。

• 验证回顾后 Git 活动

LATEST_RECAP=$(ls -t docs/recaps/SESSION-RECAP-.md 2>/dev/null | head -1) if [ -n "$LATEST_RECAP" ]; then RECAP_DATE=$(date -r "$LATEST_RECAP" "+%Y-%m-%d %H:%M") echo "最新回顾：$LATEST_RECAP ($RECAP_DATE)" echo "--- 回顾后提交 ---" git log --since="$RECAP_DATE" --oneline -20 fi 交叉引用提交消息与回顾的“开放问题”和“文档更新延迟”部分。如果提交解决了列出的项目，mute 它们在状态总结中。

• 找到并读取活跃计划

grep -rl '^status: active' docs/plans/.md .hermes/plans/.md 2>/dev/null 读取每个活跃计划的全部内容。记录验收标准进度（已满足/部分满足/未满足）。交叉引用与回顾：如果回顾声称计划已完成，但计划文件仍显示 status：active，标记不一致。计划文件及其未检查的验收标准是真实来源。

• 读取合同文档表格

grep -riE '^##? ' docs/technical-documentation.md docs/functional-specifications.md 2>/dev/null | head -20 不要读取完整文件。只知道什么部分存在。

• 提供状态总结

构建并呈现：

上次会话：{日期} — {一行摘要}

活跃计划：{列表，包括标准进度}

项目知识图：{健康/不可用}

延迟阻塞器：{模式漂移，环境问题等}

开放后续跟进：{从回顾中聚合，减去 Git 解决的问题}

然后问：“你想在哪些方面工作？”

热身陷阱 在会话中间运行重型热身 - 如果已经深入工作中，使用轻量级模式（只静默读取相关文档） 读取每个文件 - 只读取与用户指定任务匹配的文件 粘贴秘密 - 永远不要粘贴 CLAUDE.local.md 中的值 过时的计划状态 - 在任何响应之前枚举计划状态之前，重新读取计划文件（不是缓存内存） 错误的文件发现 - /opt/homebrew/CLAUDE.md 是 Homebrew，而不是项目

阶段 2：计划 - 草拟功能计划 在开始非平凡工作之前使用。创建一个 ISO 日期前缀计划文件 docs/plans/YYYY-MM-DD-.md。 何时使用 任何需要超过 15 分钟的功能或更改 用户说“计划这个”，“为 X 草拟计划”，“在我们构建这个之前” 跳过 拼写错误，单行 bug 修复，依赖项升级，平凡更改 计划结构 每个计划文件都有 YAML 前置内容和以下部分：

---

状态：草稿|活跃|完成|取消 创建：YYYY-MM-DD 更新：YYYY-MM-DD 缩写：功能名称

---

# 计划：功能名称

上下文

为什么存在这个工作。解决什么问题？什么是用户面向或系统面向的差距？包括对相关文档、用户反馈的引用。