效率工具

如果你已经第三次教 AI 同样的事情，问题可能不在 AI，而在工作流本身。 一、那些反复出现的「低级错误」 和 AI 助手协作写博客一段时间后，我开始注意到一个规律：同样的 bug 会以不同的面貌反复出现。 第一次是 +++ 残留在 YAML frontmatter 之后，导致 Hugo 解析失败，文章虽然能访问但首页根本看不到它。第二次是配图位置放错——AI 把 ![featured] 放在了二级标题下面，而不是文章开头。第三次是日期设成了未来，Hugo 直接跳过不生成。 每次修复完，我都以为「这次总该记住了」。但下一次，类似的问题又以新的形式出现。 这不是 AI 变笨了。这是流程的脆弱性在反复暴露。 二、7 个反复踩坑的具体场景 1. Frontmatter 格式混乱：YAML 与 TOML 混用 Hugo 支持 YAML (---)、TOML (+++) 和 JSON 三种 frontmatter。但如果一个项目里大部分文章用 YAML，突然插入一篇 TOML，PaperMod 的列表逻辑可能会跳过它——不是报错，就是安静地不显示。 2. +++ 残留：最隐蔽的错误 把 TOML 转成 YAML 时，如果前面的 --- 忘记删掉，或者后面跟着一串 +++，Hugo 不会报错。文章能 build，URL 能访问，但首页和分类列表里永远找不到它。hugo list all 显示正常，但 index.html 的 post-entry 列表里没有。 ...

核心原则：命令式交互 Hermes 是为行动设计的，而非解释或规划。模糊的指令会触发不必要的明确化请求（如"你是想让我部署博客吗？"），而命令式语句则直接触发执行。 低效示例（会被打断）： “如何部署 Hugo 博客到 Vercel？” 高效示例（直接执行）： “部署 Hugo 博客到 Vercel，使用默认配置” 1.1 直击要害 部署：直接说 部署 Hugo 博客，Hermes 会自动调用 npx vercel deploy --prod --yes。 调试：检查 Vercel 构建日志 会触发 npx vercel logs --prod。 修改文件：在 hugo.toml 添加 Umami 配置 会调用 patch 工具。 2 避免的坑 2.1 工具明确性 Hermes 会优先选择最合适的工具执行任务，但有时可能猜错（如误用 web_search 查找本地文件）。在复杂任务中明确指定工具： # ❌ 低效 "给博客加个 RSS" # ✅ 高效 "修改 hugo.toml 启用 RSS，使用 patch 工具" 2.2 文件路径 始终使用绝对路径（如 /root/hugo-blog/hugo.toml），避免相对路径的歧义。Hermes 默认以用户的 home 目录（/root）为起点，但不会假设项目路径。 ...