Harness plan

Skill lane2077/claude-code-harness-zh/skills/harness-plan

Harness v3 统一规划技能。负责任务规划、Plans.md 管理和进度同步。用户提到以下内容时使用：创建计划、添加任务、更新 Plans.md、标记完成、查看进度、我现在做到哪了、harness-plan、harness-sync。不要用于实现、代码评审或发布任务。From its SKILL.md

Install

npx -y skills add lane2077/claude-code-harness-zh --skill harness-plan

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

6.1 KB, as published. Nobody here has run it

Harness Plan (v3)

Harness v3 的统一规划技能。整合了以下 3 个旧技能：

planning (plan-with-agent) — 将想法落到 Plans.md 中
plans-management — 管理任务状态和标记更新
sync-status — 检查 Plans.md 与实际实现是否同步

Quick Reference

用户输入	子命令	动作
“做个计划” / `create a plan`	`create`	交互式访谈 → 生成 Plans.md
“加个任务” / `add a task`	`add`	向 Plans.md 追加新任务
“标记完成” / `mark complete`	`update`	将任务标记改为 `cc:完了`
“我现在做到哪了？” / `check progress`	`sync`	对照实际实现与 Plans.md，并执行同步
`harness-sync`	`sync`	检查进度（与独立 sync surface 等效）
`harness-plan create`	`create`	创建计划

子命令详情

create — 创建计划

See references/create.md

通过访谈收集想法与需求，并生成可执行的 Plans.md。

流程：

确认对话上下文（从前面的讨论中提取，或重新访谈）
询问要做什么（最多 3 个问题）
技术调研（WebSearch）
提取功能列表
优先级矩阵（Required / Recommended / Optional）
判断是否采用 TDD（测试设计）
生成 Plans.md（带 cc:TODO 标记）
给出下一步建议

CI 模式（--ci）：不进行访谈。直接沿用现有 Plans.md，只执行任务拆分。

add — 添加任务

向 Plans.md 中追加新任务。

harness-plan add 任务名: 详细说明 [--phase 阶段编号]

任务会以 cc:TODO 标记的形式追加。

update — 更新标记

修改任务的状态标记。

harness-plan update [任务名|任务编号] [WIP|完了|blocked]

标记对照表：

命令	标记
`WIP`	`cc:WIP`
`完了` / `done`	`cc:完了`
`blocked`	`blocked`
`TODO`	`cc:TODO`

sync — 同步进度

对照实际实现状况与 Plans.md，检测并更新差异。

See references/sync.md

流程：

获取当前 Plans.md 状态
检测 Plans.md 格式（v1: 3 列 / v2: 5 列）
从 git status / git log 获取实现状态
查看 agent trace（.claude/state/agent-trace.jsonl）
检测 Plans.md 与实现之间的差异
自动提出修复未更新标记的建议
给出下一步动作

Retrospective（默认开启）：只要存在 1 个或以上 cc:完了 任务，就会自动执行回顾。系统会分析估算精度、阻塞原因模式与范围变动，并记录经验。可通过 sync --no-retro 显式跳过。

team mode / issue bridge

Plans.md 仍保持为正本，GitHub Issue 联动只在 opt-in 的 team mode 中启用。

Solo 开发中不使用 bridge
team mode 会创建 1 个 tracking issue，并在其下按任务生成 dry-run 的 sub-issue payload
scripts/plans-issue-bridge.sh 不会真的改 GitHub，而是始终返回 dry-run payload
这个 bridge 不会直接修改 Plans.md

参照:

docs/plans/team-mode.md

Plans.md 格式规范

格式

# [项目名] Plans.md

作成日: YYYY-MM-DD

---

## Phase N: 阶段名

| Task | 内容 | DoD | Depends | Status |
|------|------|-----|---------|--------|
| N.1  | 说明 | 测试通过 | - | cc:TODO |
| N.2  | 说明 | lint 错误为 0 | N.1 | cc:WIP |
| N.3  | 说明 | 迁移可执行 | N.1, N.2 | cc:完了 |

DoD（Definition of Done）：用 1 行写清可验证的完成条件。禁止使用“感觉差不多”“应该能用”之类表达，必须能用 Yes / No 判断。

Depends：任务间依赖关系。可写 -（无依赖）、任务编号（N.1）、逗号分隔（N.1, N.2）或阶段依赖（Phase N）。

optional briefs / manifest

harness-plan create 只在必要时附加 brief。

含 UI 的任务用 design brief
含 API 的任务用 contract brief
brief 只是对“要做什么”的简短定锚补充资料，不替代 Plans.md
skill frontmatter 列表可通过 scripts/generate-skill-manifest.sh 生成 machine-readable JSON

参照:

docs/plans/briefs-manifest.md

标记列表

标记	含义
`pm:依頼中`	PM 已下发请求
`cc:TODO`	尚未开始
`cc:WIP`	进行中
`cc:完了`	Worker 已完成工作
`pm:確認済`	PM 评审完成
`blocked`	被阻塞中（必须写明原因）