hermes-pilot 0.0.0-stage → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.ja.md +419 -0
- package/README.md +428 -2
- package/__init__.py +15 -0
- package/apps/bridge/src/api-errors.js +165 -0
- package/apps/bridge/src/architect.js +1298 -0
- package/apps/bridge/src/auth.js +202 -0
- package/apps/bridge/src/capabilities.js +256 -0
- package/apps/bridge/src/capture.js +145 -0
- package/apps/bridge/src/chat-profile.js +95 -0
- package/apps/bridge/src/config.js +73 -0
- package/apps/bridge/src/discord.js +89 -0
- package/apps/bridge/src/gitinfo.js +211 -0
- package/apps/bridge/src/hermes.js +97 -0
- package/apps/bridge/src/inbox.js +347 -0
- package/apps/bridge/src/kanban.js +361 -0
- package/apps/bridge/src/lang.js +60 -0
- package/apps/bridge/src/live.js +285 -0
- package/apps/bridge/src/memos.js +150 -0
- package/apps/bridge/src/ops.js +201 -0
- package/apps/bridge/src/pair-codes.js +125 -0
- package/apps/bridge/src/pipeline-optimizer.js +513 -0
- package/apps/bridge/src/pipeline-watcher.js +1022 -0
- package/apps/bridge/src/qr.js +808 -0
- package/apps/bridge/src/repos.js +544 -0
- package/apps/bridge/src/review-watcher.js +271 -0
- package/apps/bridge/src/review.js +1749 -0
- package/apps/bridge/src/search.js +162 -0
- package/apps/bridge/src/server.js +1745 -0
- package/apps/bridge/src/snippets.js +373 -0
- package/apps/bridge/src/specs.js +806 -0
- package/apps/bridge/src/tail.js +28 -0
- package/apps/bridge/src/telemetry.js +667 -0
- package/apps/bridge/src/term-snippets.js +228 -0
- package/apps/bridge/src/transcript.js +231 -0
- package/apps/bridge/src/usage.js +294 -0
- package/apps/bridge/src/workerFeed.js +72 -0
- package/apps/dashboard/index.js +2014 -0
- package/apps/dashboard/manifest.json +14 -0
- package/apps/dashboard/pilot_dashboard.py +1466 -0
- package/apps/dashboard/plugin_api.py +237 -0
- package/apps/dashboard/plugin_init.py +15 -0
- package/apps/dashboard/style.css +928 -0
- package/apps/web/dist/assets/TermPane-DYP7pi_n.css +32 -0
- package/apps/web/dist/assets/TermPane-q4f5Zu0I.js +12 -0
- package/apps/web/dist/assets/index-BzUof8lw.js +94 -0
- package/apps/web/dist/assets/index-DwZdbPU7.css +1 -0
- package/apps/web/dist/favicon.ico +0 -0
- package/apps/web/dist/icon-180-v6.png +0 -0
- package/apps/web/dist/icon-192-v6.png +0 -0
- package/apps/web/dist/icon-512-v6.png +0 -0
- package/apps/web/dist/icon-maskable-192-v6.png +0 -0
- package/apps/web/dist/icon-maskable-512-v6.png +0 -0
- package/apps/web/dist/icon-v6.svg +15 -0
- package/apps/web/dist/index.html +21 -0
- package/apps/web/dist/manifest.webmanifest +49 -0
- package/apps/web/dist/sw.js +69 -0
- package/bin/hermes-pilot.mjs +964 -0
- package/dashboard/dist/index.js +2014 -0
- package/dashboard/dist/style.css +928 -0
- package/dashboard/manifest.json +14 -0
- package/dashboard/pilot_dashboard.py +1466 -0
- package/dashboard/plugin_api.py +237 -0
- package/package.json +75 -4
- package/plugin.json +70 -0
- package/plugin.yaml +4 -0
- package/scripts/deploy.mjs +58 -0
- package/scripts/migrate-to-hermes-pilot.mjs +472 -0
- package/scripts/postinstall.mjs +32 -0
- package/scripts/sync-dashboard.mjs +98 -0
- package/skills/annotation/SKILL.md +138 -0
- package/skills/quick-review/SKILL.md +200 -0
- package/skills/quick-review/assets/sheet-template.html +175 -0
- package/skills/spec-architect/SKILL.md +226 -0
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: annotation
|
|
3
|
+
description: "Fix UI from a hand-drawn red-mark screenshot: file an [review] annotation task, read marks/note, apply the change."
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
license: MIT
|
|
6
|
+
metadata:
|
|
7
|
+
hermes:
|
|
8
|
+
tags: [review, annotation, screenshot, ui, human-in-the-loop]
|
|
9
|
+
category: workflow
|
|
10
|
+
phase: fix
|
|
11
|
+
role: author
|
|
12
|
+
abstract_roles: [role:visual-reviewer, role:builder]
|
|
13
|
+
recommended_role: role:visual-reviewer
|
|
14
|
+
quality_tier: evidence-based
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# Annotation(スクショの赤入れで修正点を受け取る)
|
|
18
|
+
|
|
19
|
+
実装後の UI 確認を「文章の指摘」ではなく**画像の赤入れ**で受け取る。
|
|
20
|
+
人はスクショに線・矩形・矢印とひとことを書き、アプリが座標付きの
|
|
21
|
+
`.annotation.json`(`marks` + `note`)に落とす。エージェントはそれを読み、
|
|
22
|
+
**指摘された場所を特定して直す**。
|
|
23
|
+
|
|
24
|
+
このスキルは **`hermes-pilot` プラグイン同梱**。データの置き場は
|
|
25
|
+
`~/.hermes/plugin-data/hermes-pilot/review/`(環境変数 `HP_DATA_DIR` で上書き可)。
|
|
26
|
+
|
|
27
|
+
## いつ使うか
|
|
28
|
+
|
|
29
|
+
- 実装後の見た目(間隔・折返し・色・重なり)を人の目で確定したい
|
|
30
|
+
- 文章で説明すると長くなる・言葉が食い違う(「ここ」が通じない)
|
|
31
|
+
- PWA のスクショに赤を入れるのが最短(`390x844` の撮影が済んでいる)
|
|
32
|
+
|
|
33
|
+
使わない: 一意に決まる不具合(テスト失敗、例外、型エラー)は自分で直す。
|
|
34
|
+
|
|
35
|
+
## 抽象ロールと委譲・フォールバック(Model-Agnostic Delegation)
|
|
36
|
+
|
|
37
|
+
このスキルは**モデル非依存**。特定モデル名・プロバイダ名・課金プラン・個人環境のパスを
|
|
38
|
+
ここに書かない。「どの抽象ロールをどの実モデルへ割り当てるか」は実機プロファイル側
|
|
39
|
+
(プロファイルメモリ / `SOUL.md` の割当表)が持つ。
|
|
40
|
+
|
|
41
|
+
- `role:visual-reviewer` — 実装ロールとは別枠。スクショ差分(`.before.png` / `.after.png`)と
|
|
42
|
+
赤入れ画像(`.annotated.png`)の読解・座標の言語化・`390x844` / `820x1180` の視覚検収。
|
|
43
|
+
**このスキルの主ロール**。
|
|
44
|
+
- `role:builder` — 特定された箇所の修正実装、`npm run deploy`、`npm run verify`。
|
|
45
|
+
- `role:decision-framer` — 「どこまで直すか」が分岐するときの設問設計(`quick-review` へ渡す)。
|
|
46
|
+
- `role:planner` — 赤の指摘が複数コンポーネント/状態に跨り、原因究明が複雑なとき。
|
|
47
|
+
|
|
48
|
+
### ネイティブ委譲とフォールバック
|
|
49
|
+
|
|
50
|
+
1. 手順 B の画像読解は **`role:visual-reviewer` へ `delegate_task` で委譲するのを推奨**。
|
|
51
|
+
`images` に画像パスを渡し、`goal` / `context` にロール名と「指摘箇所を領域名+根拠で返す」を明記する。
|
|
52
|
+
2. 子は**読み取り専用の助言者**。ファイル編集・commit・`npm run deploy` はしない。
|
|
53
|
+
適用と検証は親(`role:builder`)が行う。
|
|
54
|
+
3. 委譲が失敗した(エラー / レート制限 / タイムアウト / マルチモーダル非対応 / 委譲ツール未搭載)
|
|
55
|
+
場合は**停止しない**。`.annotation.json` の `marks` 座標配列(0〜1 正規化)と `note` だけで
|
|
56
|
+
自分で特定し、修正まで完走する。座標があれば画像の読解は代替できる。
|
|
57
|
+
4. フォールバックした事実は `comment` に 1 行残す。
|
|
58
|
+
|
|
59
|
+
### 外部 AI CLI の禁止境界
|
|
60
|
+
|
|
61
|
+
`gemini` CLI(`gemini -p` 等)・`agy -p` のような外部 AI CLI をサブプロセスで起動して
|
|
62
|
+
画像を読ませる経路は使わない(`spawn` / `execFile` / `exec` も対象)。委譲は Hermes の
|
|
63
|
+
ネイティブ API プロバイダ+`delegate_task` のみ。ランタイムコード側は `npm run check:oauth` が機械検査する。
|
|
64
|
+
|
|
65
|
+
## 手順 A: 自分で注釈タスクを起票する(スクショを撮った側)
|
|
66
|
+
|
|
67
|
+
### 1. 撮る(UI が変わる変更のときだけ)
|
|
68
|
+
|
|
69
|
+
- `npm run deploy` を**先に**実行(ブリッジは `apps/web/dist` を配信する。ビルドしないと古い画面が写る)
|
|
70
|
+
- 撮影: PWA は `390x844`(タブレット確認は `820x1180`)
|
|
71
|
+
- 置き場: `~/.hermes/plugin-data/hermes-pilot/review/shots/<label>-<round>.png`
|
|
72
|
+
- 変更前と後を比べるなら `.before.png` / `.after.png` を両方残す
|
|
73
|
+
|
|
74
|
+
### 2. 起票して `blocked` にする
|
|
75
|
+
|
|
76
|
+
本文の機械可読行:
|
|
77
|
+
|
|
78
|
+
```text
|
|
79
|
+
[review] label=<label> round=<round> mode=annotation image=shots/<label>-<round>.png target=<repo_path> chat=<session_id>
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
hermes kanban create "注釈: <何を見てほしいか>" --body "$(cat <<'BODY'
|
|
84
|
+
見てほしい点(1〜3 個)。どの画面の、どの状態か。
|
|
85
|
+
|
|
86
|
+
[review] label=tasks-strip round=1 mode=annotation image=shots/tasks-strip-1.png target=~/Projects/your-repo chat=<session_id>
|
|
87
|
+
BODY
|
|
88
|
+
)" --assignee <profile>
|
|
89
|
+
|
|
90
|
+
hermes kanban block <task_id> "注釈待ち(赤入れ)" --kind needs_input
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
- `image=` は `review/` からの相対(`shots/...`)。`..` と絶対パスは拒否される
|
|
94
|
+
- `assignee` は必須(無いと dispatcher が拾わない)
|
|
95
|
+
- PWA から起票する場合: レビュータブ →[+ 注釈]→ 画像を選ぶ → 送信
|
|
96
|
+
(`POST /api/review/annotation/new`。本文と `chat=` はブリッジが組み立てる)
|
|
97
|
+
|
|
98
|
+
### 3. 待つ
|
|
99
|
+
|
|
100
|
+
回答(赤入れ)が来るまで別のタスクを進める。赤を自分で捏造しない。
|
|
101
|
+
|
|
102
|
+
## 手順 B: 赤入れを受け取って直す
|
|
103
|
+
|
|
104
|
+
保存物(`review/shots/` 配下):
|
|
105
|
+
|
|
106
|
+
| ファイル | 中身 |
|
|
107
|
+
|---|---|
|
|
108
|
+
| `<label>-<r>.png` | 下地(元のスクショ) |
|
|
109
|
+
| `<label>-<r>.annotated.png` | 赤入れ合成済み(**人が何を指したかはこれで見る**) |
|
|
110
|
+
| `<label>-<r>.annotation.json` | `{ note, marks: [{tool, points}], base_image, annotated_image, base_sha256, image_sha256, annotated_at }` |
|
|
111
|
+
|
|
112
|
+
`marks[].points` は **元画像の幅・高さに対する % (0〜1)**。`tool` は `pen` / `rect` / `arrow`。
|
|
113
|
+
ので、座標 → 実画面の位置は `x * width`, `y * height` で戻す。
|
|
114
|
+
|
|
115
|
+
1. `.annotation.json` の `note` を読む(ひとこと。ここに意図が書いてある)
|
|
116
|
+
2. `annotated.png` を**`role:visual-reviewer` へ `delegate_task` で委譲して**読む
|
|
117
|
+
(`images` に `annotated.png` と `before` / `after` を渡し、指摘の領域・対象コンポーネント・
|
|
118
|
+
根拠を返させる)。委譲できないときは画像を無くても `marks` の座標だけで読める —
|
|
119
|
+
**止まらずに座標フォールバック**へ落ちる
|
|
120
|
+
3. 赤の領域 → どのコンポーネントかを特定する(DOM なら `document.elementFromPoint`、
|
|
121
|
+
React なら該当 CSS/JSX を `rg` で引く)
|
|
122
|
+
4. **指摘された場所だけ**直す。周辺の「ついで改善」は混ぜない(差分が読めなくなる)
|
|
123
|
+
5. `npm run deploy` → 撮り直して after を残す(実装・デプロイ・`npm run verify` は `role:builder` の仕事=親が行う)
|
|
124
|
+
6. `hermes kanban comment <task_id> "反映: <どのファイルの何をどう直したか>"` を残す
|
|
125
|
+
|
|
126
|
+
赤入れは `POST /api/review/<task_id>/annotation`
|
|
127
|
+
(`{annotated_image: "data:image/png;base64,…", marks, note}`)で保存され、
|
|
128
|
+
同時に `comment` + `unblock` される。同じ画像の再送は冪等(`image_sha256`)。
|
|
129
|
+
|
|
130
|
+
## 落とし穴
|
|
131
|
+
|
|
132
|
+
- **回答は `blocked` のときだけ**受け付ける。`ready` / `running` / `done` に送ると 409 `NOT_WAITING`
|
|
133
|
+
- 画像は 12MB まで(data URL)。超えるなら縮小してから送る
|
|
134
|
+
- `marks` は 200 件、`points` は 1 ストローク 400 点までに丸められる(それ以上は捨てられる)
|
|
135
|
+
- `.annotation.json` の `annotated_image` は**相対パス**。解決はブリッジが `review/` 配下で行う
|
|
136
|
+
- 座標は「元画像」基準。合成済み画像を縮小して見ても比率は変わらないが、
|
|
137
|
+
スクショを撮り直して下地が変わったら**古い marks は使えない**(round を上げて起票し直す)
|
|
138
|
+
- 画像をコピーするときは `preserveTimestamps: true`(一覧は `mtime` の新しい順に並ぶ)
|
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: quick-review
|
|
3
|
+
description: "Ask a human to decide between options: build a Quick Review sheet, file a blocked [review] task, then apply the answer."
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
license: MIT
|
|
6
|
+
metadata:
|
|
7
|
+
hermes:
|
|
8
|
+
tags: [review, human-in-the-loop, kanban, sheet]
|
|
9
|
+
category: workflow
|
|
10
|
+
phase: decide
|
|
11
|
+
role: author
|
|
12
|
+
abstract_roles: [role:decision-framer, role:planner, role:visual-reviewer]
|
|
13
|
+
recommended_role: role:decision-framer
|
|
14
|
+
quality_tier: decision-ready
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# Quick Review(設問シートで判断を仰ぐ)
|
|
18
|
+
|
|
19
|
+
エージェントが実装・調査の分岐点で**人に決めてほしい**とき、長文チャットで質問せず
|
|
20
|
+
「選択肢+推奨案」のシートを 1 枚出し、スマホから 1 タップで答えてもらう。
|
|
21
|
+
答えはカンバンの `comment` と `unblock` として戻り、ワーカーが自走を再開する。
|
|
22
|
+
|
|
23
|
+
このスキルは **`hermes-pilot` プラグイン同梱**。データの置き場は
|
|
24
|
+
`~/.hermes/plugin-data/hermes-pilot/review/`(環境変数 `HP_DATA_DIR` で上書き可)。
|
|
25
|
+
|
|
26
|
+
## いつ使うか / 使わないか
|
|
27
|
+
|
|
28
|
+
使う:
|
|
29
|
+
- 見た目・配置・文言など、**正解が一意でない**判断
|
|
30
|
+
- 2 つ以上の実装方針があり、どちらも成立する
|
|
31
|
+
- 破壊的・不可逆な操作の直前に、人の意思を確定させたい
|
|
32
|
+
|
|
33
|
+
使わない(自分で決めて進む):
|
|
34
|
+
- 正解が一意(テストが通る/通らない、型エラー、排他 1 択)
|
|
35
|
+
- 事実確認だけで決まること(`file:line` を読めば分かる)
|
|
36
|
+
- 多数の項目の一括検収(1 枚に詰め込むと答えられない)
|
|
37
|
+
|
|
38
|
+
## 抽象ロールと委譲・フォールバック(Model-Agnostic Delegation)
|
|
39
|
+
|
|
40
|
+
このスキルは**モデル非依存**。特定モデル名・プロバイダ名・課金プラン・個人環境のパスを
|
|
41
|
+
ここに書かない。「どの抽象ロールをどの実モデルへ割り当てるか」は実機プロファイル側
|
|
42
|
+
(プロファイルメモリ / `SOUL.md` の割当表)が持つ。
|
|
43
|
+
|
|
44
|
+
- `role:decision-framer` — 設問設計・トレードオフ整理。**このスキルの主ロール**。
|
|
45
|
+
3±1 問への切り出し、選択肢 2〜3 と推奨理由(利点 / 代償)の構成。
|
|
46
|
+
- `role:planner` — 複雑な設計分岐の選択肢抽出・トレードオフ比較(正解が一意でない設計判断)。
|
|
47
|
+
- `role:visual-reviewer` — 見た目比較の挿絵(`thumbs/*.png`)チェック。絵を付けたときだけ。
|
|
48
|
+
- `role:builder` — 回答の反映実装と `npm run verify`。
|
|
49
|
+
|
|
50
|
+
### ネイティブ委譲とフォールバック
|
|
51
|
+
|
|
52
|
+
1. 上記のロールに当たるサブタスクは **`delegate_task` で委譲できる**(`goal` / `context` に
|
|
53
|
+
ロール名と「設問 JSON に落とせる形で返す」を明記する)。
|
|
54
|
+
2. 子は**読み取り専用の助言者**。シートの作成・起票・回答の反映は親が行う。
|
|
55
|
+
3. 委譲が失敗した(エラー / レート制限 / タイムアウト / 未対応モデル / 委譲ツール未搭載)
|
|
56
|
+
場合は**停止しない**。主モデルへフォールバックし、設問 JSON を自分で完結させる。
|
|
57
|
+
シートが出ないままブロックするのが最悪なので、フォールバックして必ず 1 枚出す。
|
|
58
|
+
4. フォールバックした事実は `comment` に 1 行残す。
|
|
59
|
+
|
|
60
|
+
### 外部 AI CLI の禁止境界
|
|
61
|
+
|
|
62
|
+
`gemini` CLI(`gemini -p` 等)・`agy -p` のような外部 AI CLI をサブプロセスで起動して
|
|
63
|
+
設問案や挿絵を作る経路は使わない(`spawn` / `execFile` / `exec` も対象)。委譲は Hermes の
|
|
64
|
+
ネイティブ API プロバイダ+`delegate_task` のみ。ランタイムコード側は `npm run check:oauth` が機械検査する。
|
|
65
|
+
|
|
66
|
+
## 手順
|
|
67
|
+
|
|
68
|
+
### 1. 問いを 3±1 に絞る
|
|
69
|
+
|
|
70
|
+
各問は「人が決めること 1 つ」。**事実(`file:line` か実行結果)は本文に書き、人には決定だけを残す**。
|
|
71
|
+
選択肢は 2〜3。推奨を 1 つ決め、理由(利点 / 代償)を必ず書く。
|
|
72
|
+
|
|
73
|
+
### 2. 絵にする(任意・見た目の論点だけ)
|
|
74
|
+
|
|
75
|
+
見た目・配置・情報密度・配色の**比較そのものが論点**のときだけ、両方の案を絵にする。
|
|
76
|
+
現行 UI に加える変更なら、まず現行画面の忠実な再現を撮る(現物と乖離したモックを描かない)。
|
|
77
|
+
絵の無い論点(命名、保存形式、API、ロジック)には付けない — 付けない方が速く、判断もぶれない。
|
|
78
|
+
スクショが必要なときだけヘッドレスブラウザ(`browser_exec`)を使う。
|
|
79
|
+
|
|
80
|
+
### 3. シートを作る(JSON が主・HTML は任意)
|
|
81
|
+
|
|
82
|
+
**第一推奨は構造化 JSON 1 枚(`mode=standard`)**。PWA はこれでネイティブフォームを描く。
|
|
83
|
+
`.html` は複数タブ比較・図解・スクショ並べが不可欠なときだけの**任意拡張**。
|
|
84
|
+
|
|
85
|
+
置き場: `~/.hermes/plugin-data/hermes-pilot/review/sheets/<label>-<round>.json`
|
|
86
|
+
(`mkdir -p` してから書く。`<label>` は `^[a-z0-9][a-z0-9._-]{0,40}$`)
|
|
87
|
+
|
|
88
|
+
```json
|
|
89
|
+
{
|
|
90
|
+
"label": "cockpit-03",
|
|
91
|
+
"round": 1,
|
|
92
|
+
"mode": "standard",
|
|
93
|
+
"title": "シートの表題(タスク名と同じでよい)",
|
|
94
|
+
"topic": "何を決めるのか 1〜2 文",
|
|
95
|
+
"target": "~/Projects/your-repo",
|
|
96
|
+
"questions": [
|
|
97
|
+
{
|
|
98
|
+
"id": "q1",
|
|
99
|
+
"text": "問いの本文",
|
|
100
|
+
"options": [
|
|
101
|
+
{ "id": "A", "label": "選択肢", "detail": "利点: … / 代償: …", "recommended": true, "thumb": "thumbs/cockpit-03-1/q1-A.png" },
|
|
102
|
+
{ "id": "B", "label": "選択肢", "detail": "利点: … / 代償: …" }
|
|
103
|
+
]
|
|
104
|
+
}
|
|
105
|
+
],
|
|
106
|
+
"has_global_note": true,
|
|
107
|
+
"sheet": "sheets/cockpit-03-1.json",
|
|
108
|
+
"created_at": "2026-11-13"
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
挿絵を付けるなら `review/thumbs/<label>-<round>/q1-A.png` に置き、`thumb` は `thumbs/...` の相対パスにする。
|
|
113
|
+
|
|
114
|
+
`.html` を併用する場合だけ、このスキルの `assets/sheet-template.html` をコピーして中身を差し替える。
|
|
115
|
+
ブリッジが読むのはこの 3 点なので**構造は変えない**(`.json` だけで起票するときは不要):
|
|
116
|
+
|
|
117
|
+
- `#akForm` … 設問フォームのルート
|
|
118
|
+
- `#out` … 回答テキストの出力先(`textarea`)
|
|
119
|
+
- `#genBtn` … 回答テキストを組み立てるボタン(アプリ内では「回答を送信」に化ける)
|
|
120
|
+
|
|
121
|
+
HTML を書くときの設問のマークアップ(ブリッジの注入スクリプトが `#akForm .q h3` を装飾する):
|
|
122
|
+
|
|
123
|
+
```html
|
|
124
|
+
<section class="q" data-q="q1">
|
|
125
|
+
<h3>Q1. 帯の形は、流す・静止・今のまま、どれにするか</h3>
|
|
126
|
+
<label data-opt="A"><input type="radio" name="q1" value="A"> A. 流れるティッカー <span class="rec">推奨</span>
|
|
127
|
+
<span class="d">利点: 件名が長くても最後まで読める / 代償: 動く文字を追い続ける負担</span></label>
|
|
128
|
+
<label data-opt="B"><input type="radio" name="q1" value="B"> B. 静止 1 行
|
|
129
|
+
<span class="d">利点: 疲れない / 代償: 2 件目以降は省略</span></label>
|
|
130
|
+
<textarea name="note-q1" placeholder="補足(任意)"></textarea>
|
|
131
|
+
</section>
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
> 旧手順(`.html` を主・`mode=sheet`)は**レガシー/カスタム HTML 拡張**として残る。
|
|
135
|
+
> どちらの `mode` でも、`.json` さえあれば PWA は `<StandardForm>` で回答でき、
|
|
136
|
+
> `.html` が無ければブリッジが `.json` から安全な HTML を動的生成する。
|
|
137
|
+
|
|
138
|
+
### 4. カンバンに起票して `blocked` にする
|
|
139
|
+
|
|
140
|
+
本文の**機械可読行**(この 1 行がブリッジの唯一の手掛かり):
|
|
141
|
+
|
|
142
|
+
```text
|
|
143
|
+
[review] label=<label> round=<round> mode=standard sheet=sheets/<label>-<round>.json target=<repo_path> chat=<session_id>
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
hermes kanban create "Q1〜Q3: <表題>" --body "$(cat <<'BODY'
|
|
148
|
+
<人向けの要約。何が決まれば進めるか、いま何が止まっているか>
|
|
149
|
+
|
|
150
|
+
[review] label=cockpit-03 round=1 mode=standard sheet=sheets/cockpit-03-1.json target=~/Projects/your-repo chat=<session_id>
|
|
151
|
+
BODY
|
|
152
|
+
)" --assignee <profile>
|
|
153
|
+
|
|
154
|
+
hermes kanban block <task_id> "レビュー待ち(Q1〜Q3)" --kind needs_input
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
- `target=` は `~` 展開後の絶対パスでも `~/...` でもよい(ブリッジが実パスに直す)
|
|
158
|
+
- `chat=<session_id>` を書くと、完了報告がその会話に戻る(書かないとフィードだけ)
|
|
159
|
+
- **`assignee` を必ず付ける**(無いと dispatcher が拾わない)
|
|
160
|
+
- 起票後は**待つ**。回答が来るまで別のタスクを進める(自分で回答を捏造しない)
|
|
161
|
+
|
|
162
|
+
### 5. 回答を受けて反映する
|
|
163
|
+
|
|
164
|
+
回答は次のどちらかで届く:
|
|
165
|
+
|
|
166
|
+
1. PWA のレビュー画面 → `POST /api/review/<task_id>/answer`
|
|
167
|
+
→ `review/sheets/<label>-<round>.answer.json` と `.answer.txt` が書かれ、タスクが `comment` + `unblock` される
|
|
168
|
+
2. タスクのコメントに貼られた回答テキスト(`【レビュー回答】` 形式)
|
|
169
|
+
|
|
170
|
+
`.answer.txt`(またはコメント)を読み、**選ばれた選択肢どおりに実装**する。
|
|
171
|
+
`(未選択 = お任せ)` は推奨案で確定してよい。`全体へのコメント:` の指示は最優先。
|
|
172
|
+
|
|
173
|
+
反映したら `hermes kanban comment <task_id> "反映: <何をどう変えたか>"` を残して完了へ進む。
|
|
174
|
+
反映が回答と違うと判断したら `POST /api/review/<task_id>/reopen`(`request-changes`)で再質問する。
|
|
175
|
+
|
|
176
|
+
## 回答フォーマット(壊さない)
|
|
177
|
+
|
|
178
|
+
シートが生成するテキストはこの形。ブリッジの `parseReplyText` は
|
|
179
|
+
`【レビュー回答】` と `全体へのコメント:` を読み、旧 `【赤ペン回答】` / `全体への赤ペン:` も受理する。
|
|
180
|
+
|
|
181
|
+
```text
|
|
182
|
+
【レビュー回答】cockpit-03
|
|
183
|
+
Q1. 帯の形は、流す・静止・今のまま、どれにするか: A — 流れるティッカー / 補足: 3 件までなら可
|
|
184
|
+
Q2. 既存バーは置き換えるか: (未選択 = お任せ)
|
|
185
|
+
全体へのコメント: 色は現行のまま
|
|
186
|
+
---
|
|
187
|
+
上の回答を反映して作業を続けてください。お任せの項目は推奨案で確定してください。
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
## 落とし穴
|
|
191
|
+
|
|
192
|
+
- **`sheet=` のパスは `review/` からの相対**(`sheets/x-1.json`)。`..`・絶対パスは拒否される
|
|
193
|
+
- 機械可読行は **`mode=standard sheet=sheets/<label>-<round>.json`** を第一推奨にする
|
|
194
|
+
(`.html` を併用したときだけ `mode=sheet sheet=sheets/x-1.html`)。`image=` に `.html` を書いても
|
|
195
|
+
`sheet` として救済されるが、`sheet=` を正しく書く
|
|
196
|
+
- **見た目の比較が論点でないときに `.html` を手書きしたり `browser_exec` で撮ったりしない**。
|
|
197
|
+
JSON 1 枚で足りる論点に絵を付けると、シート 1 枚に数分かかり回答も遅れる
|
|
198
|
+
- 同じ回答の再送は冪等(`.answer.json` の `sha256` で判定)。二重に `comment` は付かない
|
|
199
|
+
- 回答は **`blocked` のときだけ**受け付ける。`ready` / `running` / `done` に送ると 409 `NOT_WAITING`
|
|
200
|
+
- 2 ラウンド目は `round=2` で**新しいファイル**(`<label>-2.json` / `.html`)を作る(1 を上書きしない)
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="ja">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
6
|
+
<title>Quick Review テンプレート</title>
|
|
7
|
+
<!--
|
|
8
|
+
hermes-pilot / skills/quick-review/assets/sheet-template.html
|
|
9
|
+
|
|
10
|
+
使い方:
|
|
11
|
+
1. このファイルをコピーして
|
|
12
|
+
~/.hermes/plugin-data/hermes-pilot/review/sheets/<label>-<round>.html に置く
|
|
13
|
+
2. タイトル・事実・設問(.q セクション)を差し替える
|
|
14
|
+
3. 同じディレクトリに <label>-<round>.json を書く(PWA のネイティブフォーム用)
|
|
15
|
+
|
|
16
|
+
ブリッジが依存する構造(消さない):
|
|
17
|
+
#akForm … 設問フォームのルート(注入スクリプトが .q h3 を装飾する)
|
|
18
|
+
#out … 回答テキストの出力先(textarea)
|
|
19
|
+
#genBtn … 回答テキストを組み立てるボタン(アプリ内では「回答を送信」に化ける)
|
|
20
|
+
.q[data-q], h3, label[data-opt], input[type=radio][name=qN]
|
|
21
|
+
file:// で開いても、アプリ内(/api/review/:id/sheet)で開いても動く。
|
|
22
|
+
-->
|
|
23
|
+
<style>
|
|
24
|
+
:root{--ink:#212529;--muted:#64707C;--line:#DEE2E6;--paper:#fff;--dim:#F6F8FA;--accent:#2563EB;--red:#DC2626}
|
|
25
|
+
*{box-sizing:border-box}
|
|
26
|
+
body{background:var(--paper);color:var(--ink);margin:0;padding:0 16px 40px;border-top:3px solid var(--red);
|
|
27
|
+
font-family:'IBM Plex Sans JP','Hiragino Kaku Gothic ProN','Hiragino Sans',-apple-system,sans-serif;
|
|
28
|
+
font-size:14.5px;line-height:1.9;-webkit-text-size-adjust:100%}
|
|
29
|
+
main{max-width:760px;margin:0 auto}
|
|
30
|
+
.kicker{font-family:'IBM Plex Mono',Menlo,monospace;font-size:12.5px;letter-spacing:.08em;color:var(--red);
|
|
31
|
+
font-weight:600;padding-top:14px}
|
|
32
|
+
h1{font-size:23px;line-height:1.45;margin:8px 0 12px}
|
|
33
|
+
h2{font-size:18px;line-height:1.45;margin:28px 0 8px;padding-bottom:4px;border-bottom:1px solid var(--line)}
|
|
34
|
+
h3{font-size:15px;line-height:1.5;margin:0 0 8px}
|
|
35
|
+
p{margin:8px 0}
|
|
36
|
+
.m{color:var(--muted);font-size:12.5px;line-height:1.7}
|
|
37
|
+
.concl{border:1px solid var(--line);border-left:3px solid var(--red);border-radius:10px;padding:12px 16px}
|
|
38
|
+
code{font-family:'IBM Plex Mono',Menlo,monospace;font-size:12.5px;background:var(--dim);border:1px solid var(--line);
|
|
39
|
+
border-radius:4px;padding:0 4px}
|
|
40
|
+
#akForm{margin-top:28px}
|
|
41
|
+
.q{border:1px solid var(--line);border-radius:10px;padding:14px 16px;margin:12px 0;background:var(--paper)}
|
|
42
|
+
.q label{display:block;border:1px solid var(--line);border-radius:8px;padding:10px 12px;margin:8px 0;cursor:pointer}
|
|
43
|
+
.q label:has(input:checked){border-color:var(--red);background:#FFF7F7}
|
|
44
|
+
.q input[type=radio]{margin-right:6px}
|
|
45
|
+
.rec{font-family:'IBM Plex Mono',Menlo,monospace;font-size:11px;color:var(--red);border:1px solid var(--red);
|
|
46
|
+
border-radius:4px;padding:0 5px;margin-left:4px;white-space:nowrap}
|
|
47
|
+
.d{display:block;color:var(--muted);font-size:12.5px;line-height:1.7;margin-top:2px}
|
|
48
|
+
textarea{width:100%;font:inherit;font-size:13px;border:1px solid var(--line);border-radius:8px;padding:8px 10px;
|
|
49
|
+
background:var(--paper);color:var(--ink);min-height:56px}
|
|
50
|
+
#out{min-height:140px;display:none}
|
|
51
|
+
.actions{display:flex;gap:8px;flex-wrap:wrap;margin:16px 0 8px}
|
|
52
|
+
button{font:inherit;font-size:14px;padding:10px 16px;border-radius:10px;border:1px solid var(--red);
|
|
53
|
+
background:var(--red);color:#fff;cursor:pointer}
|
|
54
|
+
button.ghost{background:var(--paper);color:var(--red)}
|
|
55
|
+
.status{font-size:13px;min-height:1.6em;margin:6px 0}
|
|
56
|
+
.status.ok{color:#0b5f45}.status.err{color:#8a1f17}
|
|
57
|
+
footer{margin-top:24px;border-top:1px solid var(--line);padding-top:10px}
|
|
58
|
+
@media (prefers-color-scheme: dark){
|
|
59
|
+
:root{--ink:#e8f4f6;--muted:#84a5ad;--line:rgba(120,190,205,.2);--paper:#0a2029;--dim:#0e2a35}
|
|
60
|
+
}
|
|
61
|
+
</style>
|
|
62
|
+
</head>
|
|
63
|
+
<body>
|
|
64
|
+
<main>
|
|
65
|
+
<div class="kicker">QUICK REVIEW / label=<span id="labelSlot">example-01</span> round=1</div>
|
|
66
|
+
<h1>ここに表題(タスク名と同じでよい)</h1>
|
|
67
|
+
|
|
68
|
+
<div class="concl">
|
|
69
|
+
<p><strong>決めてほしいこと:</strong> 何が決まれば作業を再開できるかを 1〜2 文で。</p>
|
|
70
|
+
<p class="m">判断に必要な事実はここに書く(<code>file:line</code> や実測値)。人は決定だけを返す。</p>
|
|
71
|
+
</div>
|
|
72
|
+
|
|
73
|
+
<h2>設問</h2>
|
|
74
|
+
|
|
75
|
+
<form id="akForm">
|
|
76
|
+
<section class="q" data-q="q1">
|
|
77
|
+
<h3>Q1. 問いを 1 つだけ書く</h3>
|
|
78
|
+
<label data-opt="A"><input type="radio" name="q1" value="A"> A. 選択肢 A のラベル <span class="rec">推奨</span>
|
|
79
|
+
<span class="d">利点: … / 代償: …</span></label>
|
|
80
|
+
<label data-opt="B"><input type="radio" name="q1" value="B"> B. 選択肢 B のラベル
|
|
81
|
+
<span class="d">利点: … / 代償: …</span></label>
|
|
82
|
+
<textarea name="note-q1" placeholder="補足(任意)"></textarea>
|
|
83
|
+
</section>
|
|
84
|
+
|
|
85
|
+
<section class="q" data-q="q2">
|
|
86
|
+
<h3>Q2. 問いを 1 つだけ書く</h3>
|
|
87
|
+
<label data-opt="A"><input type="radio" name="q2" value="A"> A. 選択肢 A のラベル <span class="rec">推奨</span>
|
|
88
|
+
<span class="d">利点: … / 代償: …</span></label>
|
|
89
|
+
<label data-opt="B"><input type="radio" name="q2" value="B"> B. 選択肢 B のラベル
|
|
90
|
+
<span class="d">利点: … / 代償: …</span></label>
|
|
91
|
+
<textarea name="note-q2" placeholder="補足(任意)"></textarea>
|
|
92
|
+
</section>
|
|
93
|
+
|
|
94
|
+
<h2>全体へのコメント</h2>
|
|
95
|
+
<textarea name="global_note" placeholder="複数の問いをまたぐ指示(任意)"></textarea>
|
|
96
|
+
|
|
97
|
+
<div class="actions">
|
|
98
|
+
<button type="button" id="genBtn">回答テキストを作る</button>
|
|
99
|
+
<button type="button" class="ghost" id="copyBtn">コピー</button>
|
|
100
|
+
</div>
|
|
101
|
+
<p class="m">選んで[回答テキストを作る]を押すと、下に貼り付け用のテキストが出ます(未選択は「お任せ」)。
|
|
102
|
+
アプリから開いた場合はボタンが[回答を送信]に変わり、そのままレビューへ返ります。</p>
|
|
103
|
+
<div id="status" class="status"></div>
|
|
104
|
+
<textarea id="out" readonly></textarea>
|
|
105
|
+
</form>
|
|
106
|
+
|
|
107
|
+
<footer class="m">
|
|
108
|
+
<p>反映先: <code id="targetSlot">~/Projects/your-repo</code></p>
|
|
109
|
+
</footer>
|
|
110
|
+
</main>
|
|
111
|
+
<script>
|
|
112
|
+
(function () {
|
|
113
|
+
var QUESTIONS = [
|
|
114
|
+
{ id: 'q1', text: 'Q1. 問いを 1 つだけ書く' },
|
|
115
|
+
{ id: 'q2', text: 'Q2. 問いを 1 つだけ書く' }
|
|
116
|
+
];
|
|
117
|
+
var LABEL = 'example-01';
|
|
118
|
+
|
|
119
|
+
function oneLine(s) { return String(s || '').replace(/\s+/g, ' ').trim(); }
|
|
120
|
+
|
|
121
|
+
function buildReply() {
|
|
122
|
+
var lines = ['【レビュー回答】' + LABEL];
|
|
123
|
+
QUESTIONS.forEach(function (q) {
|
|
124
|
+
var el = document.querySelector('input[name="' + q.id + '"]:checked');
|
|
125
|
+
var noteEl = document.querySelector('textarea[name="note-' + q.id + '"]');
|
|
126
|
+
var note = oneLine(noteEl ? noteEl.value : '');
|
|
127
|
+
var line = q.text + ': ';
|
|
128
|
+
if (el) {
|
|
129
|
+
var lab = el.closest('label');
|
|
130
|
+
var lbl = lab ? oneLine(lab.textContent).replace(/^(A|B|C)\.\s*/, '') : '';
|
|
131
|
+
line += el.value + ' — ' + lbl;
|
|
132
|
+
} else {
|
|
133
|
+
line += '(未選択 = お任せ)';
|
|
134
|
+
}
|
|
135
|
+
if (note) line += ' / 補足: ' + note;
|
|
136
|
+
lines.push(line);
|
|
137
|
+
});
|
|
138
|
+
var g = document.querySelector('textarea[name="global_note"]');
|
|
139
|
+
var gv = oneLine(g ? g.value : '');
|
|
140
|
+
lines.push('全体へのコメント: ' + (gv || '(なし)'));
|
|
141
|
+
lines.push('---');
|
|
142
|
+
lines.push('上の回答を反映して作業を続けてください。お任せの項目は推奨案で確定してください。');
|
|
143
|
+
return lines.join('\n');
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
function setStatus(msg, cls) {
|
|
147
|
+
var el = document.getElementById('status');
|
|
148
|
+
if (!el) return;
|
|
149
|
+
el.textContent = msg || '';
|
|
150
|
+
el.className = 'status' + (cls ? ' ' + cls : '');
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
document.getElementById('genBtn').addEventListener('click', function () {
|
|
154
|
+
var out = document.getElementById('out');
|
|
155
|
+
out.style.display = 'block';
|
|
156
|
+
out.value = buildReply();
|
|
157
|
+
setStatus('回答テキストを作りました。貼り付けるか[回答を送信]してください。', 'ok');
|
|
158
|
+
});
|
|
159
|
+
|
|
160
|
+
document.getElementById('copyBtn').addEventListener('click', function () {
|
|
161
|
+
var out = document.getElementById('out');
|
|
162
|
+
var text = out.value || buildReply();
|
|
163
|
+
var done = function (ok) {
|
|
164
|
+
setStatus(ok ? '✓ コピーしました' : 'テキストを選択してコピーしてください', ok ? 'ok' : 'err');
|
|
165
|
+
};
|
|
166
|
+
if (navigator.clipboard && navigator.clipboard.writeText) {
|
|
167
|
+
navigator.clipboard.writeText(text).then(function () { done(true); }, function () { done(false); });
|
|
168
|
+
} else {
|
|
169
|
+
try { out.select(); done(document.execCommand('copy')); } catch (e) { done(false); }
|
|
170
|
+
}
|
|
171
|
+
});
|
|
172
|
+
})();
|
|
173
|
+
</script>
|
|
174
|
+
</body>
|
|
175
|
+
</html>
|