work
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseWork Skill
Work Skill
Plans.md のタスクを実装する主力スキル。スコープに応じて戦略を自動選択。
这是实现Plans.md中任务的核心Skill。可根据任务范围自动选择执行策略。
Philosophy
设计理念
「聞いて、判断して、実行する」1タスクなら直接実装。複数なら並列。大量なら自動反復。 ユーザーはスコープだけ決めれば、あとは自動。
「倾听、判断、执行」单个任务则直接实现。多个任务则并行处理。大量任务则自动迭代。 用户只需确定任务范围,后续流程自动执行。
Quick Reference
快速参考
bash
/work # スコープを聞いてから実行
/work 3 # タスク3だけ即実行
/work all # 全タスクを即実行
/work 3-6 # タスク3〜6を即実行
/work --codex # Codex CLI で実装(スコープを聞く)
/work --codex all # Codex CLI で全タスク即実行
/work --parallel 5 # 並列5ワーカーで実行
/work --no-commit # 自動コミット抑制
/work --resume latest # 前回セッション再開bash
/work # 询问范围后执行
/work 3 # 立即执行仅任务3
/work all # 立即执行所有任务
/work 3-6 # 立即执行任务3至6
/work --codex # 通过Codex CLI实现(询问范围)
/work --codex all # 通过Codex CLI立即执行所有任务
/work --parallel 5 # 使用5个并行工作线程执行
/work --no-commit # 禁用自动提交
/work --resume latest # 恢复上次会话Options
选项
| Option | Description | Default |
|---|---|---|
| 全未完了タスクを対象 | - |
| タスク番号/範囲指定 | - |
| Codex CLI で実装委託 | false |
| 並列ワーカー数 | auto |
| 並列禁止(直列実行) | - |
| 自動コミット抑制 | false |
| 反復上限(all 時) | 10 |
| セッション再開 | - |
| セッションフォーク | - |
| 选项 | 描述 | 默认值 |
|---|---|---|
| 针对所有未完成任务 | - |
| 指定任务编号/范围 | - |
| 委托Codex CLI实现 | false |
| 并行工作线程数 | auto |
| 禁止并行(串行执行) | - |
| 禁用自动提交 | false |
| 最大迭代次数(使用all时) | 10 |
| 恢复会话 | - |
| 分支会话 | - |
Scope Dialog (引数なし時)
范围对话(无参数时)
引数なしで呼ぶと、対話でスコープを確認:
/work
どこまでやりますか?
1) 次のタスク (推奨): Plans.md の次の未完了タスク
2) 全部: 残りのタスクを全て完了
3) 指定: タスク番号や範囲を指定 (例: 3, 3-6)
> [Enter = 1]引数ありなら即実行(対話スキップ)。
詳細: references/scope-dialog.md
无参数调用时,会通过对话确认任务范围:
/work
要处理到什么范围?
1) 下一个任务(推荐):Plans.md中的下一个未完成任务
2) 全部:完成所有剩余任务
3) 指定:指定任务编号或范围(示例:3, 3-6)
> [按回车键默认选择1]如果带参数则立即执行(跳过对话)。
详情:references/scope-dialog.md
Auto Strategy Selection
自动策略选择
スコープに応じて、内部戦略を自動選択:
| スコープ | 戦略 | 元スキル相当 |
|---|---|---|
| 1タスク | 直接実装 | 旧 |
| 2-3タスク | サブエージェント並列 | 旧 |
4+タスク or | サブエージェント並列 + 自動反復 | 旧 |
実行開始時に戦略を表示:
🔧 戦略: 直接実装 (タスク1件)
🔧 戦略: 並列 3 ワーカー (タスク3件)
🔧 戦略: 並列 3 ワーカー + 自動反復 (タスク8件, 最大10回)ユーザーは戦略を意識する必要なし。
根据任务范围自动选择内部执行策略:
| 范围 | 策略 | 等效原Skill |
|---|---|---|
| 单个任务 | 直接实现 | 旧版 |
| 2-3个任务 | 子Agent并行处理 | 旧版 |
4个以上任务或 | 子Agent并行处理 + 自动迭代 | 旧版 |
执行开始时会显示策略:
🔧 策略:直接实现(1件任务)
🔧 策略:3个并行工作线程(3件任务)
🔧 策略:3个并行工作线程 + 自动迭代(8件任务,最大10次迭代)用户无需关注策略细节。
Default Flow
默认流程
/work [scope]
↓
Phase 0: スコープ確認 (引数なしなら対話)
↓
Phase 1: 戦略選択 (タスク数で自動判断)
↓
Phase 2: 実装
→ 1タスク: 直接実装
→ 複数: task-worker サブエージェント並列
→ 全部/4+: 並列 + 反復ループ (完了まで自動)
↓
Phase 3: Review Loop (harness-review)
→ APPROVE: proceed
→ REQUEST_CHANGES: fix → re-review
↓
Phase 4: Auto-commit (unless --no-commit)
↓
Tip 表示/work [范围]
↓
阶段0:范围确认(无参数时触发对话)
↓
阶段1:策略选择(根据任务数量自动判断)
↓
阶段2:实现
→ 单个任务:直接实现
→ 多个任务:通过task-worker子Agent并行处理
→ 全部/4个以上:并行处理 + 自动迭代循环(直至完成)
↓
阶段3:评审循环(harness-review)
→ 批准:继续
→ 请求修改:修复 → 重新评审
↓
阶段4:自动提交(除非使用--no-commit)
↓
显示提示信息Unified Memory Gate(必須)
Unified Memory Gate(必填)
/work- 実装前:
harness_mem_resume_pack(project, session_id?, limit=5, include_private=false) - マイルストーン到達時(設計確定・大きな修正・方針転換):
harness_mem_record_checkpoint(session_id, title, content, tags?, privacy_tags?) - 実装完了時(handoff 前):
harness_mem_finalize_session(session_id, summary_mode="standard")
補足:
- は
session_id→$CLAUDE_SESSION_IDの.claude/state/session.jsonの順で取得する.session_id - の先頭利用は read-only(resume確認)に限定し、
harness_mem_sessions_list(project, limit=1)/record_checkpointは明示finalize_sessionが無い場合に失敗扱いとするsession_id - Codex では hook(after_agent)とこの手順を併用し、記録漏れを抑える
notify - は daemon 側で自動インジェストされるため、手動追記不要
.codex/history.jsonl - いずれかが失敗した場合は と
harness_mem_health()で状態確認し、復旧後に同ステップを再実行するscripts/harness-memd doctor
执行时,必须严格按照以下顺序通过Unified Harness Memory:
/work- 实现前:
harness_mem_resume_pack(project, session_id?, limit=5, include_private=false) - 到达里程碑时(设计确定、重大修改、方针转变):
harness_mem_record_checkpoint(session_id, title, content, tags?, privacy_tags?) - 实现完成时(移交前):
harness_mem_finalize_session(session_id, summary_mode="standard")
补充说明:
- 按
session_id→$CLAUDE_SESSION_ID中的.claude/state/session.json顺序获取.session_id - 的首个结果仅限只读使用(恢复会话确认),无明确
harness_mem_sessions_list(project, limit=1)时session_id/record_checkpoint视为失败finalize_session - 在Codex中需结合钩子(after_agent)和此流程,避免记录遗漏
notify - 由daemon端自动导入,无需手动追加
.codex/history.jsonl - 若任一步骤失败,需通过和
harness_mem_health()确认状态,恢复后重新执行该步骤scripts/harness-memd doctor
Auto-Iteration (4+ tasks or all
)
all自动迭代(4个以上任务或all
)
all大量タスク時は自動反復ロジックが有効化:
- 前回の失敗から自己学習
- 未完了タスクを次イテレーションで再試行
- 完了条件: 全タスク cc:done + ビルド成功 + テスト通過 + Review APPROVE
- 最大反復回数: (default: 10)
--max-iterations
詳細: references/auto-iteration.md
处理大量任务时自动启用迭代逻辑:
- 从上次失败中自我学习
- 未完成任务将在下次迭代中重试
- 完成条件:所有任务标记为cc:done + 构建成功 + 测试通过 + 评审批准
- 最大迭代次数:(默认值:10)
--max-iterations
详情:references/auto-iteration.md
--codex Engine
--codex 引擎
--codex| 項目 | デフォルト | --codex |
|---|---|---|
| 実装主体 | Claude (直接コーディング) | Codex CLI |
| Claude の役割 | 調整 + 実装 | PM (調整のみ) |
| Edit/Write | 許可 | 禁止 (guard 適用) |
| 品質保証 | セルフレビュー | AGENTS_SUMMARY + Quality Gates |
詳細: references/codex-engine.md
使用标志可将所有实现工作委托给Codex CLI:
--codex| 项目 | 默认值 | --codex模式 |
|---|---|---|
| 实现主体 | Claude(直接编码) | Codex CLI |
| Claude的角色 | 协调 + 实现 | PM(仅协调) |
| 编辑/写入权限 | 允许 | 禁止(启用防护) |
| 质量保证 | 自我评审 | AGENTS_SUMMARY + 质量关卡 |
详情:references/codex-engine.md
Feature Details
功能详情
| Feature | Reference |
|---|---|
| Scope Dialog | See references/scope-dialog.md |
| Auto-Iteration | See references/auto-iteration.md |
| Codex Engine | See references/codex-engine.md |
| Execution Flow | See references/execution-flow.md |
| Parallel Execution | See references/parallel-execution.md |
| Session Management | See references/session-management.md |
| Review Loop | See references/review-loop.md |
| Auto-commit | See references/auto-commit.md |
| Error Handling | See references/error-handling.md |
| 功能 | 参考文档 |
|---|---|
| 范围对话 | 查看 references/scope-dialog.md |
| 自动迭代 | 查看 references/auto-iteration.md |
| Codex引擎 | 查看 references/codex-engine.md |
| 执行流程 | 查看 references/execution-flow.md |
| 并行执行 | 查看 references/parallel-execution.md |
| 会话管理 | 查看 references/session-management.md |
| 评审循环 | 查看 references/review-loop.md |
| 自动提交 | 查看 references/auto-commit.md |
| 错误处理 | 查看 references/error-handling.md |
Smart Parallel Detection
智能并行检测
| Condition | Parallel Count |
|---|---|
| 1 task | 1 |
| All tasks edit same file | 1 |
| 2-3 independent tasks | 2-3 |
| 4+ independent tasks | 3 (max) |
| 条件 | 并行数量 |
|---|---|
| 1个任务 | 1 |
| 所有任务编辑同一文件 | 1 |
| 2-3个独立任务 | 2-3 |
| 4个以上独立任务 | 3(最大值) |
Completion Tip
完成提示
実行完了時に次のアクションを案内:
Done! 2 tasks completed. (3 remaining)
Tip: /breezing でチーム並列実行できます
Tip: --codex を付けると Codex に実装を委託できます执行完成时会引导后续操作:
完成!已完成2个任务。(剩余3个)
提示:使用/breezing可进行团队并行执行
提示:添加--codex可将实现工作委托给CodexSession State
会话状态
初期化
初始化
bash
undefinedbash
undefinedwork-active.json を作成
创建work-active.json
cat > .claude/state/work-active.json <<EOF
{
"active": true,
"started_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
"strategy": "iteration",
"codex_mode": false,
"bypass_guards": ["rm_rf", "git_push"],
"allowed_rm_paths": ["node_modules", "dist", ".next", ".cache"],
"review_status": "pending"
}
EOF
undefinedcat > .claude/state/work-active.json <<EOF
{
"active": true,
"started_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
"strategy": "iteration",
"codex_mode": false,
"bypass_guards": ["rm_rf", "git_push"],
"allowed_rm_paths": ["node_modules", "dist", ".next", ".cache"],
"review_status": "pending"
}
EOF
undefined完了時クリア
完成时清理
bash
rm -f .claude/state/work-active.jsonbash
rm -f .claude/state/work-active.jsonAuto-invoke Skills
自动调用Skill
| Skill | Purpose | When to Call |
|---|---|---|
| Feature implementation | On task implementation |
| Build verification | On post-implementation verification |
| Multi-perspective review | After implementation complete |
| Skill | 用途 | 调用时机 |
|---|---|---|
| 功能实现 | 任务实现时 |
| 构建验证 | 实现后验证时 |
| 多视角评审 | 实现完成后 |
Project Configuration
项目配置
Override defaults via :
.claude-code-harness.config.yamlyaml
work:
auto_commit: false # Disable auto-commit
commit_on_pm_approve: true # 2-Agent: defer commit until PM approves可通过覆盖默认设置:
.claude-code-harness.config.yamlyaml
work:
auto_commit: false # 禁用自动提交
commit_on_pm_approve: true # 双Agent模式:等待PM批准后再提交VibeCoder Hints
VibeCoder 使用提示
| What You Want | How to Say |
|---|---|
| 次のタスクだけ | |
| 全部終わらせて | |
| この番号だけ | |
| ここからここまで | |
| Codex に任せて | |
| 並列で速く | |
| チームで完走して | → |
| 需求 | 指令方式 |
|---|---|
| 仅处理下一个任务 | |
| 完成所有任务 | |
| 仅处理指定编号任务 | |
| 处理指定范围任务 | |
| 委托给Codex | |
| 并行加速执行 | |
| 团队并行完成 | → 使用 |
Related Skills
相关Skill
- - Agent Teams でチーム並列完走(Lead は指揮のみ)
breezing - - コードレビュー(/work 内で自動起動)
harness-review - - 個別タスクの実装ロジック
impl
- - 通过Agent Teams进行团队并行执行(负责人仅需指挥)
breezing - - 代码评审(在/work内自动触发)
harness-review - - 单个任务的实现逻辑
impl