关于 workflow-guide
workflow-guide 是一项技能，用于说明 Cursor 与 Claude Code 的双 Agent 协作方式。它涵盖角色分工、Plans.md 任务状态管理、命令以及 CI/CD 边界，适合采用该流程的团队或个人。
主要功能
- 01说明 Cursor 与 Claude Code 的分工
- 02通过 Plans.md 跟踪任务状态
- 03介绍双方使用的命令
- 04说明 CI 失败后的升级规则
- 05界定 staging 与生产部署职责
适用场景
- 01配置 Cursor 与 Claude Code 的任务交接
- 02跟踪任务从分配到审核的状态
- 03处理反复失败的 CI
- 04明确 staging 和生产部署责任
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/workflow-guide确认已加载。
附带文件examples/typical-workflow.mdreferences/commands.md
详细介绍
Workflow Guide Skill
提供 Cursor ↔ Claude Code 双 Agent 工作流指导的技能。
触发短语
以下短语会触发此技能：
-「告诉我工作流」 -「如何与 Cursor 协作？」 -「告诉我工作流程」 -「接下来该怎么做？」
- "how does the workflow work?"
- "explain 2-agent workflow"
概述
此技能介绍 Cursor（PM）和 Claude Code（Worker）的职责分工与协作方式。
双 Agent 工作流
职责分工
| Agent | 角色 | 职责 |
|---|---|---|
| Cursor | PM（项目经理） | 分配任务、审核、判断是否部署到生产环境 |
| Claude Code | Worker（工作者） | 实现、测试、修复 CI、部署到 staging |
工作流图
┌─────────────────────────────────────────────────────────┐
│ Cursor (PM) │
│ ・タスクを Plans.md に追加 │
│ ・Claude Code に作業を依頼（/handoff-to-claude） │
│ ・完了報告をレビュー │
│ ・本番デプロイの判断 │
└─────────────────────┬───────────────────────────────────┘
│ タスク依頼
▼
┌─────────────────────────────────────────────────────────┐
│ Claude Code (Worker) │
│ ・/work でタスク実行（並列実行対応） │
│ ・実装 → テスト → コミット │
│ ・CI 失敗時は自動修正（3回まで） │
│ ・/handoff-to-cursor で完了報告 │
└─────────────────────┬───────────────────────────────────┘
│ 完了報告
▼
┌─────────────────────────────────────────────────────────┐
│ Cursor (PM) │
│ ・変更内容を確認 │
│ ・staging 動作確認 │
│ ・本番デプロイ実行（承認後） │
└─────────────────────────────────────────────────────────┘
使用 Plans.md 管理任务
标记列表
| 标记 | 含义 | 设置者 |
|---|---|---|
pm:依頼中 | PM 发起请求（兼容：cursor:依頼中） | PM（Cursor/PM Claude） |
cc:TODO | Claude Code 尚未开始 | 任意一方 |
cc:WIP | Claude Code 正在处理 | Claude Code |
cc:完了 | Claude Code 已完成 | Claude Code |
pm:確認済 | PM 已完成确认（兼容：cursor:確認済） | PM（Cursor/PM Claude） |
cursor:依頼中 | （兼容）与 pm:依頼中 含义相同 | Cursor |
cursor:確認済 | （兼容）与 pm:確認済 含义相同 | Cursor |
blocked | 受阻 | 任意一方 |
任务状态转换
pm:依頼中 → cc:WIP → cc:完了 → pm:確認済
主要命令
Claude Code 侧
| 命令 | 用途 |
|---|---|
/harness-init | 项目设置 |
/plan-with-agent | 制定计划、拆分任务 |
/work | 执行任务（支持并行执行） |
/handoff-to-cursor | 报告完成情况（发送给 Cursor PM） |
/sync-status | 确认状态 |
技能（在对话中自动触发）
| 技能 | 触发示例 |
|---|---|
handoff-to-pm | 「向 PM 报告完成情况」 |
handoff-to-impl | 「交给实现人员」 |
Cursor 侧（参考）
| 命令 | 用途 |
|---|---|
/handoff-to-claude | 向 Claude Code 分配任务 |
/review-cc-work | 审核完成报告 |
CI/CD 规则
Claude Code 的职责范围
- ✅ 部署至 staging 为止
- ✅ CI 失败时自动修复（最多 3 次）
- ❌ 禁止部署到生产环境
3 次规则
如果 CI 连续失败 3 次：
- 停止自动修复
- 生成升级报告
- 将判断权交给 Cursor
常见问题
Q：没有 Cursor 时怎么办？
A：即使独自工作，也建议使用 Plans.md 管理任务。 请谨慎手动部署到生产环境。
Q：任务不明确时怎么办？
A：请向 Cursor 请求确认，或使用 /sync-status 梳理当前情况。
Q：CI 多次失败时怎么办？
A：失败 3 次以上时，不要自动修复；请向 Cursor 升级处理。
相关文档
- AGENTS.md - 详细职责分工
- CLAUDE.md - Claude Code 专属设置
- Plans.md - 任务管理文件
评论
支持 Markdown