跳到正文
cccskills
免费在 GitHub 公开

harness-progress

Turn task statuses in Plans.md into a standalone progress dashboard. It shows task counts and completion percentage, elapsed and estimated time, and reported costs, with support for regenerating the HTML snapshot.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Generate a Progress Tracker HTML for non-engineer vibecoders to glance at session progress (cc:WIP / cc:TODO / cc:完了 counts, percentage, elapsed/estimated minutes, cost so far/estimate, drift alerts). Uses Plans.md as source of truth, renders a single-file HTML with auto-regeneration support. Use when user asks for progress overview, session status snapshot, dashboard, or says: progress tracker, 進捗確認, 進捗ボード, dashboard. Do NOT load for: actual implementation, code review, release work.

Chachamaru127/claude-code-harness星标 3,187(GitHub 3,187 + cccskills 0)

实测评分 未实测

查看安装方法

适用场景

  • Get a snapshot of current session progress
  • See task counts and completion percentage
  • Review elapsed time and cost estimates

包含的文件(5)

  • SKILL.md7.5 KB
  • schemas/orchestration-ledger.v1.schema.json2.1 KB
  • schemas/orchestration-scorecard.v1.schema.json3.1 KB
  • schemas/orchestration-totals.v1.schema.json2.5 KB
  • schemas/progress-snapshot.v1.schema.json5.9 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Harness Progress Tracker

Phase 65.4 (Progress Tracker) — 3rd surface of the cognitive-load HTML triplet. Plan Brief / Acceptance Demo に続く 3 つ目の HTML surface で、進行中セッションの全体像を 1 枚の紙で把握 できるようにする。

Quick Reference

入力動作
/harness-progress現プロジェクトの進捗 snapshot HTML を生成し開く
/harness-progress --no-open生成のみ (browser 開かない、PostToolUse hook 用)
/harness-progress --out <path>出力先指定 (default: out/progress-snapshot.html)

Mission

"今のセッションは何件のタスクをどこまで終わらせて、いつ終わる見込みで、いくら使ったか" を、 エンジニアじゃない vibecoder が 3 秒でブラウザで把握 できる HTML 1 枚を生成する。

やる:

  • Plans.md の cc:TODO / cc:WIP / cc:完了 件数を集計
  • progress_pct (完了率) を計算 (cc:完了 ÷ 総タスク × 100)
  • 経過分数 / 推定総分数 / コスト so-far / コスト estimate を表示
  • drift alert を表示 (Phase 65.4.3 以降で populate)

完了率は Plans.md のマーカーから算出した値であり、受け入れ検証の合格率ではない。説明では計測値と推定値を分ける。 state 欠損時の表示用既定値を実測の 0 と主張せず、元の計測が未取得ならその限界を報告する。ボード生成だけでタスクを完了にしない。

やらない (本 cycle):

  • WebSocket / SSE による live update (静的 HTML、再生成で更新)
  • 過去 session の history 比較 (Phase 65.4.4 で別軸)
  • 他 project の cross-project view (Phase 65.3 と独立)

Schema: progress-snapshot.v1

詳細仕様: schemas/progress-snapshot.v1.schema.json

schema:        progress-snapshot.v1
project:       <basename of git repo>
current_task:  <cc:WIP の最初の項目 1 行サマリ、なければ空文字>
progress_pct:  <0-100 の整数、cc:完了 ÷ 総タスク × 100 の四捨五入>
todo_tasks:    [{number, title}]    ← cc:TODO のみ
wip_tasks:     [{number, title}]    ← cc:WIP のみ
done_tasks:    [{number, title, commit}]   ← cc:完了 [hash] のみ、hash は 7 chars
elapsed_minutes:          <int, state file から>
estimated_total_minutes:  <int, state file から>
cost_so_far_usd:          <float, state file から>
cost_estimate_usd:        <float, state file から>
alerts:                    []   ← Phase 65.4.3 以降で populate
generated_at:             <ISO8601 UTC>
writing_lint_pending:     [{id, pattern, approve_command, pending_count}]  ← optional/additive (Phase 136.2)
deferred_ops_pending:     [{id, command, approve_command, pending_count}]  ← optional/additive (Phase 140.2)

writing_lint_pending (Phase 136.2)

scripts/writing-rule-list.sh --status pending --json の出力をそのまま snapshot に 組み込む optional フィールド。pending proposal が 0 件のときは配列が空になり、 progress.html.template の該当セクションは何も展開せず非表示になる (render-html.sh の {{#section}} は配列が空だと block を 0 回展開するため)。

表示するのは コピペ用のコマンド文字列 (scripts/writing-rule-approve.sh --id <id>) であって押せるボタンではない。承認は人間が CLI で writing-rule-approve.sh を実行する 一択の経路のまま (Phase 135.4。自動昇格経路は無い)。

Execution Flow

Step 0: PROJECT_NAME を取得

PROJECT_NAME="$(basename "$(git rev-parse --show-toplevel)" 2>/dev/null || echo "current")"

Step 1: snapshot を組み立て

SNAPSHOT_JSON="$(mktemp /tmp/progress-snapshot-XXXX.json)"
bash scripts/progress-snapshot.sh \
  --plans Plans.md \
  --project "$PROJECT_NAME" \
  > "$SNAPSHOT_JSON"

scripts/progress-snapshot.sh (Phase 65.4.1 で実装) は Plans.md を parse し progress-snapshot.v1 schema 準拠の JSON を出力する。内部で scripts/writing-rule-list.sh --status pending --json も呼び、writing_lint_pending を additive に組み込む (Phase 136.2。writing-rule-list.sh が無い/失敗する場合は空配列)。 同様に .claude/state/deferred-ops.jsonl の status: pending 行を deferred_ops_pending として組み込む (Phase 140.2。ファイルが無い/壊れた行は読み飛ばして空配列)。表示するのは コピペ用の bin/harness deferred approve <id> 文字列で、押せるボタンではない。

Step 2: HTML をレンダリング

OUT_PATH="${OUT_PATH:-out/progress-snapshot.html}"
mkdir -p "$(dirname "$OUT_PATH")"

bash scripts/render-html.sh \
  --template progress \
  --data "$SNAPSHOT_JSON" \
  --out "$OUT_PATH"

Step 3: ブラウザで開く

--no-open flag がない場合のみ実行 (PostToolUse hook からの背景再生成では skip):

bash scripts/plan-brief-open.sh --path "$OUT_PATH"

Cross-project search (default OFF)

Phase 65.4.4 で --cross-project-group <name> flag が追加される。本 cycle (65.4.1) では default OFF、現プロジェクトのみ集計する。

Failure modes

状態動作
Plans.md が無いprogress-snapshot.sh が exit 1 (clear error message)
Plans.md にタスクが 1 件もないprogress_pct: 0, 空配列 で snapshot 生成 (HTML は「タスクなし」表示)
state file (経過分数等) が無いelapsed_minutes: 0, cost_so_far_usd: 0 で fallback (warning なし)
git 不在 / git repo 外project: "current" で fallback

Related

  • harness-plan-brief (Phase 65.1.x) — 1st surface (実装前の説明会)
  • harness-accept (Phase 65.2.x) — 2nd surface (検収判断)
  • harness-progress (本 skill, Phase 65.4.x) — 3rd surface (進捗ダッシュボード)
  • 65.4.2 (PostToolUse auto-regen)、65.4.3 (drift alert 5 種)、65.4.4 (過去判断 lookup) で機能拡張

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Use the agent-browser CLI to navigate web pages, inspect interactive elements, fill forms, capture screenshots, and collect page information. It helps check web app behavior through browser actions and snapshots.

中文简介正在准备中。当前显示英语简介。

  • Navigate a page and inspect its current state
  • Fill and submit a web form
  • Capture a screenshot for a UI check
Chachamaru127/claude-code-harness31872026年10月26日 更新

breezing

免费

Run planned software tasks as a coordinated team workflow. It assigns ready tasks to isolated workers, performs per-task and integrated reviews, incorporates approved changes, and reports progress and completion. Worker execution can use the selected backend, including optional Cursor delegation.

中文简介正在准备中。当前显示英语简介。

  • Run all remaining planned tasks as a team
  • Delegate a selected task range to workers
  • Use Cursor for worker implementation
Chachamaru127/claude-code-harness31872026年10月26日 更新

breezing

免费

Run planned work through a team workflow: delegate implementation to workers, coordinate independent review and revisions, then report the outcome. Select a task range or backend, or run all unfinished tasks in one command.

中文简介正在准备中。当前显示英语简介。

  • Run all unfinished planned tasks
  • Delegate a selected task range
  • Request implementation through the Codex or Cursor backend
Chachamaru127/claude-code-harness31872026年10月26日 更新

Review changes that integrate Claude Code or Codex updates. Classify each new Feature Table entry as implemented, inherited upstream, or tracked in Plans, and flag entries that are only documented without supporting work.

中文简介正在准备中。当前显示英语简介。

  • Review a Claude Code or Codex update integration
  • Check new Feature Table entries against implementation
  • Confirm future work is recorded in Plans
Chachamaru127/claude-code-harness31872026年10月26日 更新

ci

免费

Diagnose failed CI runs by reviewing logs, reproduction details, specifications, and recent commits. Identify whether the cause lies in implementation, tests, or the environment, then make authorized fixes without hiding failures by skipping checks.

中文简介正在准备中。当前显示英语简介。

  • Find the cause of a failed CI run
  • Trace a build error to a recent commit
  • Fix implementation issues behind failing tests
Chachamaru127/claude-code-harness31872026年10月26日 更新

Send a question, investigation, or design discussion to cursor-agent in read-only ask mode. It returns a second opinion or evidence-based findings that the host agent summarizes, without making file changes or running implementation work.

中文简介正在准备中。当前显示英语简介。

  • Ask for a second opinion on a design decision
  • Investigate code or configuration and request supporting evidence
  • Get an adversarial sanity check on a proposed change
Chachamaru127/claude-code-harness31872026年10月26日 更新

查看 Chachamaru127 的全部技能

报告此技能的问题