Harvest Automation

Harvest Automation skill 概览

Harvest Automation 能做什么

Harvest Automation 是一个 Claude Code skill，可通过自然语言操作 Harvest，并使用 Rube MCP server 和 Composio Harvest toolkit。借助 Harvest Automation，你可以在不离开终端、不切换到 Harvest UI 的情况下记录工时、查看和更新时间条目、管理项目、客户与任务，并提取账单或报表数据。

这个 Harvest Automation skill 尤其适合已经在 Harvest 中跟踪工作的自由职业者、代理机构、工程团队、顾问和运营人员，用来获得更快、更低摩擦的工作流自动化体验。

最适合的任务和用户

当任务足够具体、并且需要基于真实账户数据执行时，适合使用 Harvest Automation，例如：“把 3.5 小时记录到项目 X 和任务 Y”、“列出本周尚未提交的工时”、“为现有项目创建一个任务”，或“拉取用于发票复核的时间条目”。如果只是模糊的规划任务，且不需要 Harvest 数据或实际操作，它的价值就没那么高。

最匹配的场景是那些重复性高、但又要求准确的行政类工作：清理时间条目、查找项目/任务、准备发票，以及维护客户和项目资料。

重要采用条件

该 repository 只包含一个 SKILL.md；没有辅助脚本、规则文件夹或随附参考文件。关键前提是 MCP 访问权限：该 skill 声明必须使用 rube，并要求你添加位于 https://rube.app/mcp 的 Rube MCP server，然后完成 Harvest 账户认证。

安装前，请确认你的环境支持 Claude Code skills 和 MCP servers，并且你愿意向一个真实的 Harvest workspace 授予工具访问权限。

如何使用 Harvest Automation skill

Harvest Automation 安装与设置路径

使用你的 skill manager 从源 repository 安装该 skill，例如：

npx skills add ComposioHQ/awesome-claude-skills --skill "Harvest Automation"

然后配置 Claude Code 使用 Rube MCP server：

1. 添加 MCP server URL：https://rube.app/mcp
2. 当 Claude 提示需要 Harvest 访问权限时，按认证链接完成授权
3. 在创建或更新记录前，先用只读请求做一次测试

建议先阅读 composio-skills/harvest-automation/SKILL.md。由于这个 skill 没有单独的 README.md、metadata.json、脚本或参考资料，SKILL.md 就是支持的工作流和工具名称的权威来源。

稳定运行所需的输入信息

当你提供真实的 Harvest 标识符和日期细节时，Harvest Automation 的使用效果会明显提升。对于时间条目，该 skill 可能需要：

• project_id
• task_id
• spent_date，格式为 YYYY-MM-DD
• 对于按时长计费的账户，需要 hours
• 对于按开始/结束时间记录的账户，需要 started_time 和 ended_time
• 描述工作的 notes

较弱的提示是：“记录我今天的开发时间。”

更好的提示是：“Use Harvest Automation to log 3.5 hours for 2026-01-15 on project 12345, task 67890, notes: Implemented OAuth callback handling and tests. If the project-task pairing is invalid, stop and tell me before creating anything.”

更安全的自动化工作流

对于创建、更新以及接近开票流程的操作，建议使用两步工作流：

1. 先让 Harvest Automation 列出或检索相关的项目、任务、客户或时间条目。
2. 在要求它创建或更新任何内容之前，确认准确的记录 ID。

这样可以减少因项目名称相似、任务分配过期或日期含糊而导致的错误。对于报表和发票复核，先要求返回筛选后的列表，例如“列出客户 X 从周一到周五的时间条目”，在原始条目确认无误后，再要求生成汇总。

提升输出质量的提示写法

好的提示应同时包含意图、约束和确认规则：

• “List time entries for project 12345 from 2026-01-01 to 2026-01-31; group by task and flag entries missing notes.”
• “Create a Harvest project for client Acme, name Website Retainer Q1, but show me the proposed fields before calling the create tool.”
• “Update time entry 98765 to 2.25 hours and notes Bug triage and hotfix review; do not change the date, project, or task.”

这些提示能帮助 agent 选择正确的 Harvest 工具，而不是根据一个过于宽泛的请求进行猜测。

Harvest Automation skill 常见问题

Harvest Automation 适合做 Workflow Automation 吗？

适合。Harvest Automation for Workflow Automation 在 Harvest 已经是可重复运营流程一部分时最有价值，例如每日记录工时、每周审核工时表、设置项目、维护任务和准备发票。它不能替代你的账单判断，但可以减少手动导航和复制粘贴的工作。

它和普通提示有什么不同？

普通提示可以告诉你如何使用 Harvest。Harvest Automation skill 则可以通过 Rube MCP 连接调用 Harvest 相关工具，前提是你的账户已完成认证，并且相应工具权限可用。因此，它适合执行真实操作，例如列出、创建、检索和更新 Harvest 记录。

对新手友好吗？

如果你已经了解自己的 Harvest workspace 结构，它对新手也算友好。刚开始使用 Harvest 的用户可能会遇到困难，因为 project IDs、task IDs、客户关系和日期格式都很重要。建议从只读的列表请求开始，弄清准确 ID 后，再进行创建或更新操作。

什么时候不应该使用？

当你无法确认目标客户、项目、任务或时间条目时，不要使用该 skill。避免直接发出“fix all my timesheets”这类宽泛命令，除非你先要求它给出拟变更清单。对于敏感的账单变更、发票创建或大批量更新，应要求在执行前确认。

如何改进 Harvest Automation skill

用更好的上下文提升 Harvest Automation 结果

最有用的上下文是操作层面的，而不是冗长描述。请包含准确的日期范围、workspace 中使用的术语、记录 ID、账单意图，以及该请求是只读还是允许写入。如果你不知道某个 ID，先让 skill 查找候选项，而不是强迫它根据名称推断。

示例：“Find active projects matching Acme and list their tasks with IDs. Do not create or update anything yet.”

需要避免的常见失败模式

主要风险是歧义：相似的项目名称、在多个项目中复用的任务名称、像“last Friday”这样不明确的日期，或账户到底是按时长记录还是按开始/结束时间记录。另一个常见问题是，在尚未确认条目的 notes 和任务分配是否准确前，就要求生成可用于开票的汇总。

避免这些问题的方法是：让 skill 展示它计划处理的记录，并使用绝对日期。

根据第一次输出继续迭代

拿到第一次响应后，应在现有工作流上继续细化，而不是重新开始。如果 skill 列出了条目，可以让它筛选缺少 notes 的记录、按项目分组，或准备一张确认表。如果创建请求因为某个任务未分配到项目而失败，先让它列出该项目的有效任务，再重试。

一个好的迭代提示是：“From the entries you just listed, show only records over 8 hours or missing notes, then suggest corrections without applying them.”

给维护者的 repository 改进建议

如果 Harvest Automation skill 能为每类受支持操作提供示例提示，补充只读操作与写入操作的使用指引，并增加一个小型故障排查部分，覆盖 MCP 认证、无效的 project-task pairing 和日期格式问题，它会更完善。对于具有破坏性或账单敏感性的更新，增加一份简短的安全检查清单，也能帮助正在评估该 skill 的团队更容易做出安装决策。