使用 claude-task-master 的 Hamster Brief 端到端任务执行工作流【免费下载链接】claude-task-masterAn AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-task-master本文基于 claude-task-master 仓库中的 Hamster 集成工作流.cursor/commands/goham.md展开讲解如何在连接了 Hamster brief 的前提下通过 Task Master CLItm在单一 Git 分支上顺序完成全部任务、并在最后统一提交一个 Pull Request 的完整流程。读完本文你将掌握从连接验证、任务浏览、分支初始化、子任务循环实施、质量门禁到 PR 创建与清理的整套可复制实战方案并了解底层命令的实现原理。Hamster 集成背景与适用前提Hamster 是一个以 brief任务简报形式分发任务的平台。当你在 Cursor、Lovable、Windsurf、Roo 等 AI 编码工具中接入 Task Master 后可以通过tm context命令连接某个 Hamster brief将其中的任务列表拉取到本地进行统一管理。本仓库为 Hamster 场景专门维护了一套约束规则见 .claude/hamster.md 与 .cursor/rules/hamster.mdc。其核心约束是仅允许使用有限的一组 CLI 命令tm list、tm show id --json、tm set-status、tm auth refresh、tm context brief url禁止使用 MCP 工具因为 MCP 工具尚未完全跟上 Hamster 集成使用 CLI 命令更可靠单分支、单 PR一个 brief 的所有任务在同一个分支如hamster-brief上完成全部完成后只创建一个 PR且 PR 的目标分支固定为dev而非main。在开始执行工作流之前建议先通读完整规则文件 assets/rules/hamster.mdc其中还包含一份可直接参考的 Mermaid 流程图描绘了连接 brief → 查看任务 → 逐个实现子任务 → 质量门禁 → 完成 → 提交 PR的完整状态流转。Step 1验证连接与认证状态每次会话开始的第一步是确认当前工作区上下文与登录状态# 检查当前上下文和认证状态 tm contexttm context命令由 apps/cli/src/commands/context.command.ts 实现。从源码可以看到该命令支持org选择组织、brief选择简报、clear清除上下文、set直接设置四个子命令并接受一个可选位置参数Brief ID 或 Hamster URL。执行tm context时命令会先调用checkAuthentication校验登录态未登录会提示需要登录 Hamster 账号然后展示当前组织Organization与简报Brief的名称、ID只显示后 8 位、状态及更新时间。如果未连接或认证失败按以下顺序处理获取 brief URL如果用户没有提供先向用户索要连接简报tm context brief url—— 该命令会直接进入selectBriefDirectly流程通过selectBriefFromInput解析 URL 并更新认证上下文见 apps/cli/src/utils/brief-selection.ts刷新令牌如果 JWT 过期或命令异常执行tm auth refresh。最佳实践是在会话一开始就把 brief URL 存好便于后续断线重连时快速恢复上下文。Step 2列出可用任务# 查看来自 brief 的全部任务 tm list浏览任务列表理解需要完成的工作范围并记下任务总数。建议同时结合规则文件中的建议查看多个任务上下文时使用逗号分隔 ID 一次性读取例如tm show 1,1.1,2,2.1 --json比多次调用tm show更省 token。Step 3为 Brief 初始化 Git 分支Hamster 工作流的核心特征之一是一个 brief 对应一个分支、一个 PR因此初始化分支时要注意# 确保在 dev 分支上并拉取最新代码 git checkout dev git pull origin dev # 为整个 brief 创建单一分支例如 hamster-brief-YYYY-MM-DD 或简报专属名称 git checkout -b hamster-brief # 验证分支创建成功 git branch注意该分支将用于 brief 中的所有任务不要为每个任务单独创建分支。这与 .cursor/rules/git_workflow.mdc 中始终面向 dev/main 保护、变更必须通过 PR 合入的原则保持一致只是在分支粒度上从每任务一分支调整为每 brief 一分支。Step 4任务循环对每个任务重复执行在同一个分支上顺序处理所有任务每个任务遵循以下子步骤。4.1 读取任务详情# 获取任务的详细信息 tm show 1 # 如果任务包含子任务逐一查看它们 tm show 1,1.1,1.2,1.3 # 按需调整 ID从源码实现看set-status命令对任务 ID 的解析支持逗号分隔并经过TaskIdSchema校验见 apps/cli/src/commands/set-status.command.ts因此1,1.1,2这类复合 ID 是标准用法。4.2 记录初始上下文在动手写代码之前先把对任务的理解写入任务备注方便后续回溯决策过程# 记录任务理解与初步发现 tm update-task -i 1 --append --promptStarting task implementation. Initial context: - Task requirements: [summarize key requirements] - Dependencies identified: [list any dependencies] - Files that may need modification: [list relevant files] - Approach planned: [brief implementation approach]4.3 将任务标记为进行中# 将任务及第一个子任务若存在标记为进行中 tm set-status -i 1,1.1 -s in-progressset-status支持的位置/选项参数包括-i, --id任务 ID逗号分隔、-s, --status状态值、-f, --formattext/json 输出、--silent、-p, --project。合法状态由源码中的VALID_TASK_STATUSES定义pending、in-progress、done、deferred、cancelled、blocked、review见 apps/cli/src/commands/set-status.command.ts。一次可同时标记多个任务/子任务tm set-status -i 1,1.1,1.2,2 -s in-progress4.4 子任务实施循环对每个子任务1.1、1.2、1.3…重复以下步骤4.4.1 读取子任务详情tm show 1.1 # 替换为当前子任务 ID4.4.2 记录调研与上下文收集# 在实施过程中记录发现 tm update-task -i 1 --append --promptSubtask 1.1 - Context gathered: - Code exploration findings: [what you discovered] - Implementation approach: [how you plan to implement] - Key decisions made: [important choices] - Challenges encountered: [any blockers or issues]4.4.3 实施子任务按照子任务要求编写代码修改相应文件。4.4.4 质量验证质量门禁# 运行 lint pnpm lint # 运行类型检查 pnpm typecheck # 若任一失败修复问题后重新运行直到两者均通过4.4.5 CodeRabbit 代码审查# 生成代码审查等待纯文本结果 coderabbit --prompt-only # 检查输出如有必要处理关键问题4.4.6 记录实施完成# 记录完成内容 tm update-task -i 1 --append --promptSubtask 1.1 - Implementation complete: - Files modified: [list files changed] - Key changes: [summary of implementation] - CodeRabbit feedback addressed: [if any issues were fixed] - Ready for commit4.4.7 提交子任务工作# 暂存更改 git add . # 使用符合 git_workflow.mdc 格式的详细提交信息 git commit -m feat(task-1): Complete subtask 1.1 - [Subtask Title] - Implementation details - Key changes made - Files modified: [list files] - CodeRabbit review completed Subtask 1.1: [Brief description of what was accomplished] Relates to Task 1: [Main task title]提交信息格式遵循 .cursor/rules/git_workflow.mdc 中的标准使用feat(task-X):、fix(task-X):、test(task-X):、docs(task-X):、refactor(task-X):、chore(task-X):等类型前缀正文包含实施细节、关键变更、修改文件列表与关联任务说明杜绝fixed stuff这类模糊提交。4.4.8 将子任务标记为完成tm set-status -i 1.1 -s done4.4.9 进入下一个子任务对下一个子任务1.2、1.3…重复 4.4.1 至 4.4.8。4.5 完成父任务所有子任务完成后4.5.1 最终质量检查# 最终 lint pnpm lint # 最终类型检查 pnpm typecheck # 最终 CodeRabbit 审查 coderabbit --prompt-only # 如有关键问题则处理4.5.2 记录任务完成# 记录最终任务完成信息 tm update-task -i 1 --append --promptTask 1 - Complete: - All subtasks completed: [list all subtasks] - Final verification passed: lint, typecheck, CodeRabbit review - Files changed: [comprehensive list] - Committed to brief branch4.5.3 将父任务标记为完成tm set-status -i 1 -s done注意此时不要 push 或创建 PR继续在同一分支处理下一个任务。4.6 进入下一个任务# 确认剩余任务 tm list # 继续下一个任务例如 Task 2 # 对 Task 2、Task 3 等重复步骤 4.1 至 4.5Step 5完成所有任务持续执行步骤 4.1–4.6直到 brief 中的全部任务完成。所有工作都提交到同一个hamster-brief分支上。关于并行处理.claude/hamster.md 给出了补充建议只有当多个子任务修改的文件互不重叠例如 1.1 改src/api.js、1.2 改src/utils.js且已确认工作边界清晰时才可派生子代理并行执行否则应逐个顺序实施保证增量式推进。Step 6最终验证与 PR 创建所有任务完成后6.1 验证所有任务完成# 确认所有任务已完成 tm list # 应显示所有任务状态为 done6.2 最终综合检查# 最终全面检查 pnpm lint pnpm typecheck coderabbit --prompt-only # 如有关键问题则处理6.3 推送分支# 将 brief 分支推送到远端 git push origin hamster-brief6.4 向 dev 创建 Pull Request# 获取所有任务标题按需调整任务 ID # 创建全面的 PR 描述 gh pr create \ --base dev \ --title Hamster Brief: Complete Implementation \ --body ## Brief Overview Completed all tasks from Hamster brief. ## Tasks Completed - [x] Task 1: [Task 1 title] - Subtasks: 1.1, 1.2, 1.3 - [x] Task 2: [Task 2 title] - Subtasks: 2.1, 2.2 - [x] Task 3: [Task 3 title] - [Continue listing all tasks] ## Implementation Summary - Total tasks: [number] - Total subtasks: [number] - Files modified: [comprehensive list] - All quality checks passed ## Quality Checks - ✅ Linting passed (pnpm lint) - ✅ Type checking passed (pnpm typecheck) - ✅ CodeRabbit review completed for all changes ## Testing - [ ] Manual testing completed - [ ] All checks passing Complete implementation of Hamster brief tasksPR 拆分原则默认优先保持一个 PR若工作范围过大确需拆分应创建彼此递进build on top of previous ones的多个 PR并且拆分前必须先与人类确认见 .claude/hamster.md 的 PR 管理策略。gh pr create的--base dev是强制项始终面向dev分支绝不面向main。Step 7清理# PR 合并后切回 dev 分支 git checkout dev git pull origin dev # 删除本地分支可选 git branch -d hamster-brief重要注意事项汇总只使用以下命令tm list、tm show id、tm set-status、tm update-task、tm auth refresh、tm context brief url不要使用 MCP 工具——与 Hamster 集成不兼容每个 brief 单一分支所有任务在同一个hamster-brief分支上工作每个 brief 单一 PR所有任务完成后只创建一个 PR始终面向 dev 分支——绝不面向 main高频记录频繁使用tm update-task -i id --append记录探索过程中收集的上下文、实施决策、遇到的挑战与完成状态质量门禁不可跳过lint、typecheck、CodeRabbit 审查在任何情况下都不能省提交格式遵循 git_workflow.mdc 的提交信息规范PR 格式创建 PR 时始终使用--base dev。工作流速查1. Verify connection → tm context 2. List tasks → tm list 3. Create single branch → git checkout -b hamster-brief 4. For each task (in same branch): a. Read task → tm show X b. Log context → tm update-task -i X --append c. Mark in-progress → tm set-status -i X,X.Y -s in-progress d. For each subtask: - Read → tm show X.Y - Log context → tm update-task -i X --append - Implement code - Verify → pnpm lint pnpm typecheck - Review → coderabbit --prompt-only - Log completion → tm update-task -i X --append - Commit → git commit (following git_workflow.mdc format) - Mark done → tm set-status -i X.Y -s done e. Final checks → pnpm lint pnpm typecheck coderabbit --prompt-only f. Log completion → tm update-task -i X --append g. Mark task done → tm set-status -i X -s done h. Continue to next task (same branch) 5. After ALL tasks complete: a. Final verification → pnpm lint pnpm typecheck coderabbit --prompt-only b. Push branch → git push origin hamster-brief c. Create PR → gh pr create --base dev参考资料完整 Hamster 集成规则.cursor/rules/hamster.mdc含 Mermaid 流程图与命令白名单CLI 侧同一套规则的镜像.claude/hamster.md、assets/rules/hamster.mdcGit 工作流与提交信息规范.cursor/rules/git_workflow.mdctm context命令实现apps/cli/src/commands/context.command.tstm set-status命令实现状态枚举、ID 校验apps/cli/src/commands/set-status.command.ts上下文选择工具URL/ID 解析apps/cli/src/utils/brief-selection.ts仓库内针对该规则的集成测试tests/integration/profiles/hamster-rules-distribution.test.js【免费下载链接】claude-task-masterAn AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-task-master创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考