name: workflow-guide description: “提供 Cursor ↔ Claude Code 双代理工作流程的指导。当用户提到ワークフローについて、Cursorとの連携、作業の流れ、2-agent workflow、collaboration 时使用。不要用于：実装作業、ワークフロー設定、ハンドオフ実行。” allowed-tools: [“Read”] user-invocable: false metadata: skillport: category: core tags: [workflow, guide, cursor, collaboration] alwaysApply: false

工作流程指南技能

提供 Cursor ↔ Claude Code 双代理工作流程的指导。

触发短语

此技能由以下短语触发：

「ワークフローについて教えて」
「Cursor との連携方法は？」
「作業の流れを教えて」
「どうやって進めればいい？」
“how does the workflow work?”
“explain 2-agent workflow”

概述

此技能说明 Cursor（项目经理）和 Claude Code（工作者）的角色分工与协作方法。

双代理工作流程

角色分工

代理	角色	职责
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 升级报告。

工作流程指南Skill workflow-guide