@shinaps/skills 0.35.3 → 0.36.0
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/README.md +18 -20
- package/package.json +1 -1
- package/plugins/shinaps-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/shinaps-claude/agents/shinaps-architect.md +8 -5
- package/plugins/shinaps-claude/agents/shinaps-implementer.md +5 -4
- package/plugins/shinaps-claude/agents/shinaps-plan-reviewer.md +1 -1
- package/plugins/shinaps-claude/agents/shinaps-review-verifier.md +4 -4
- package/plugins/shinaps-claude/agents/shinaps-reviewer.md +23 -11
- package/plugins/shinaps-claude/managed-agents/agents/shinaps-architect.md +8 -5
- package/plugins/shinaps-claude/managed-agents/agents/shinaps-dev-managed-cc.md +4 -2
- package/plugins/shinaps-claude/managed-agents/agents/shinaps-implementer.md +5 -4
- package/plugins/shinaps-claude/managed-agents/agents/shinaps-plan-reviewer.md +1 -1
- package/plugins/shinaps-claude/managed-agents/agents/shinaps-refine-agent.md +88 -0
- package/plugins/shinaps-claude/managed-agents/agents/shinaps-review-verifier.md +38 -0
- package/plugins/shinaps-claude/managed-agents/agents/shinaps-reviewer.md +23 -11
- package/plugins/shinaps-claude/managed-agents/skills/dev-managed-cc/SKILL.md +5 -4
- package/plugins/shinaps-claude/managed-agents/skills/dev-managed-cc/references/launch.md +1 -1
- package/plugins/shinaps-claude/managed-agents/skills/dev-managed-cc/references/staffing.md +35 -22
- package/plugins/shinaps-claude/managed-agents/skills/dev-managed-cc/references/workflow.md +32 -16
- package/plugins/shinaps-claude/references/dev/staffing.md +51 -24
- package/plugins/shinaps-claude/references/dev/workflow.md +45 -36
- package/plugins/shinaps-claude/references/human-review.md +17 -3
- package/plugins/shinaps-claude/references/linear/bridge.md +6 -5
- package/plugins/shinaps-claude/references/linear/claude-cli.md +6 -6
- package/plugins/shinaps-claude/references/linear/configuration.md +12 -8
- package/plugins/shinaps-claude/references/linear/execution.md +2 -2
- package/plugins/shinaps-claude/references/linear/qa.md +20 -1
- package/plugins/shinaps-claude/references/linear/workflow.md +30 -14
- package/plugins/shinaps-claude/references/managed/execute.md +5 -3
- package/plugins/shinaps-claude/references/managed/setup.md +6 -4
- package/plugins/shinaps-claude/skills/commit/SKILL.md +4 -4
- package/plugins/shinaps-claude/skills/dev-claude/SKILL.md +2 -2
- package/plugins/shinaps-claude/skills/linear-execute/SKILL.md +1 -1
- package/plugins/shinaps-claude/skills/managed-execute/SKILL.md +2 -2
- package/plugins/shinaps-codex/.codex-plugin/plugin.json +1 -1
- package/plugins/shinaps-codex/managed-agents/agents/shinaps-architect.md +8 -5
- package/plugins/shinaps-codex/managed-agents/agents/shinaps-dev-managed-cc.md +4 -2
- package/plugins/shinaps-codex/managed-agents/agents/shinaps-implementer.md +5 -4
- package/plugins/shinaps-codex/managed-agents/agents/shinaps-plan-reviewer.md +1 -1
- package/plugins/shinaps-codex/managed-agents/agents/shinaps-refine-agent.md +88 -0
- package/plugins/shinaps-codex/managed-agents/agents/shinaps-review-verifier.md +38 -0
- package/plugins/shinaps-codex/managed-agents/agents/shinaps-reviewer.md +23 -11
- package/plugins/shinaps-codex/managed-agents/skills/dev-managed-cc/SKILL.md +5 -4
- package/plugins/shinaps-codex/managed-agents/skills/dev-managed-cc/references/launch.md +1 -1
- package/plugins/shinaps-codex/managed-agents/skills/dev-managed-cc/references/staffing.md +35 -22
- package/plugins/shinaps-codex/managed-agents/skills/dev-managed-cc/references/workflow.md +32 -16
- package/plugins/shinaps-codex/references/dev/staffing.md +51 -24
- package/plugins/shinaps-codex/references/dev/workflow.md +45 -36
- package/plugins/shinaps-codex/references/human-review.md +17 -3
- package/plugins/shinaps-codex/references/linear/bridge.md +6 -5
- package/plugins/shinaps-codex/references/linear/claude-cli.md +6 -6
- package/plugins/shinaps-codex/references/linear/configuration.md +12 -8
- package/plugins/shinaps-codex/references/linear/execution.md +2 -2
- package/plugins/shinaps-codex/references/linear/qa.md +20 -1
- package/plugins/shinaps-codex/references/linear/workflow.md +30 -14
- package/plugins/shinaps-codex/references/managed/execute.md +5 -3
- package/plugins/shinaps-codex/references/managed/setup.md +6 -4
- package/plugins/shinaps-codex/skills/linear-execute/SKILL.md +3 -3
- package/plugins/shinaps-codex/skills/managed-execute/SKILL.md +2 -2
|
@@ -6,12 +6,12 @@
|
|
|
6
6
|
|
|
7
7
|
## 起動と観測
|
|
8
8
|
|
|
9
|
-
通常の `-p` は既存の設定・skills・plugins・Agentを読み込む。`--bare` やsafe-mode
|
|
9
|
+
通常の `-p` は既存の設定・skills・plugins・Agentを読み込む。`--bare` やsafe-modeで省かない。メインのモデルは[経路](configuration.md#経路)のとおり、起動とすべてのresumeで `--model opus` を指定する。resumeで省くと既定のモデルで再開され得るため、毎回指定する。effort・plugin構成は指定して上書きせず、利用者のCLI設定を保持する。Skill/Agentを技術的に呼べることと、その操作の権限が許可されることは別である。
|
|
10
10
|
|
|
11
11
|
依頼本文を作業記録のpromptファイルへ保存し、stdinで渡す。本文をshellへ展開しない。以下は絶対パスを今回の記録先に置き換え、コマンドのcwdを確定済みcheckoutへ指定して実行する例。毎回異なる出力名を使い、既存記録を上書きしない。必要なSkill/Agent・Read/Edit・検証コマンド等の `--allowedTools` は依頼の許可と範囲から個別に追加する。たとえばcommit段階の `Bash(git add <対象パス>)` と `Bash(git commit -m <確定メッセージ>)` は実際の引数に限定し、初回実装にはcommit権限を渡さない。広範な既存allow設定がある場合も対象外操作の許可とは扱わない。
|
|
12
12
|
|
|
13
13
|
```sh
|
|
14
|
-
claude -p --output-format json --permission-mode dontAsk --permission-prompts none < /absolute/work/request.txt > /absolute/work/result.json 2> /absolute/work/stderr.log
|
|
14
|
+
claude -p --model opus --output-format json --permission-mode dontAsk --permission-prompts none < /absolute/work/request.txt > /absolute/work/result.json 2> /absolute/work/stderr.log
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
途中経過が必要なら `--output-format stream-json --verbose` を使い、JSONLへ保存する。シェル実行ツールのprocess/session ID、開始時刻、cwd、Issue、出力パスを記録する。実行中は、実行ツールがprocessの終了を通知する場合はその通知を待つ。通知を受け取れるかは、利用時の実行ツールが実際に提供する機能で判断する。通知を受け取れない場合だけ、起動または前回の確認から5分おきに同じprocessの終了だけを確認する。この5分は確認の間隔で、進行役の1回の待機の長さ([実行](execution.md) の「待機の手順(進行役)」)とは別に扱い、短い待機から戻るたびには確認しない。終了を待つ間は、stream-json・stderr・出力ファイルなどのログや途中成果を読まない。異常の根拠がある場合と利用者に依頼された場合だけ、必要な範囲で調べる。新しいCLIを並行起動せず、終了したら終了コードを取得して結果を会話へ返す。
|
|
@@ -20,18 +20,18 @@ jsonの `session_id`、`result`、`is_error`、`permission_denials` を読み、
|
|
|
20
20
|
|
|
21
21
|
## 依頼・質問・修正・コミット
|
|
22
22
|
|
|
23
|
-
promptにはIssue、`shinaps:dev-claude
|
|
23
|
+
promptにはIssue、`shinaps:dev-claude`、成果物と受入条件、体制と体制判断の材料、exact cwd・branch・HEAD・既存差分、必須検証コマンドと確かめたツールチェーンの状態、許可・禁止操作と起動時に渡す `--allowedTools` の個別エントリ、規約と参照先、返却条件を含める。通常設定が `ask` なら、解決したmodeと回答の記録も含め、Claudeが再質問しないようにする。依頼の体制で進め、BASIC・ULTRAでは追加の担当をClaudeのメインが材料と現物から決め、体制と理由をresultに含める。linear-executeを再起動せず、実装後は未コミット差分を返してLocal Agent QAを待つ。spec/explore/review/debugの結果も同じ依頼へ渡す。質問・障害は最終resultに返し、Codexが既存合意で回答できれば回答、目的・権限の判断が必要なら人へ一問ずつ取り次ぐ。[途中確認](qa.md#qaの時点対象最終qa)の依頼は、実行中の担当が無い時点でresultに返す。この依頼は完了報告ではなく、CodexはLocal Agent QAへ進めない。CLIからBridge送信や人の対話入力を待たせない。
|
|
24
24
|
|
|
25
25
|
回答・QA修正・QA後のautoコミット依頼は、元のprocess終了後、記録済みの正確なIDで同じセッションをresumeする。`--continue` で別セッションを推測しない。
|
|
26
26
|
|
|
27
27
|
```sh
|
|
28
|
-
claude -p --resume '<recorded-session-id>' --output-format json --permission-mode dontAsk --permission-prompts none < /absolute/work/follow-up.txt > /absolute/work/follow-up-result.json 2> /absolute/work/follow-up-stderr.log
|
|
28
|
+
claude -p --resume '<recorded-session-id>' --model opus --output-format json --permission-mode dontAsk --permission-prompts none < /absolute/work/follow-up.txt > /absolute/work/follow-up-result.json 2> /absolute/work/follow-up-stderr.log
|
|
29
29
|
```
|
|
30
30
|
|
|
31
|
-
resumeにも同じcwdと許可境界を指定し、外部で変化したHEAD・差分を渡す。commit依頼にはLocal Agent QA結果、独立レビュー、単位案と全差分、実効review_flowと合意根拠(askでは解決したmode
|
|
31
|
+
resumeにも同じcwdと許可境界を指定し、外部で変化したHEAD・差分を渡す。commit依頼にはLocal Agent QA結果、独立レビュー、単位案と全差分、実効review_flowと合意根拠(askでは解決したmodeと回答の記録)を含める。完了報告は体制(必須担当の完了・未完了と合意による未実施を含む)と途中の増員、変更範囲、検証、未解決事項、単位案と予定差分、Local Agent QAの後に修正があった場合は変更記録([qa.md](qa.md#qaの時点対象最終qa))、commitした場合はSHA・単位照合・残差分・stash復元結果・修正サイクルで確定した変更を含める。復帰不能時は理由を報告し、黙って別sessionに作り直さない。
|
|
32
32
|
|
|
33
33
|
## 操作権限
|
|
34
34
|
|
|
35
|
-
`review_flow.mode: auto` はClaudeの `--permission-mode auto` を意味しない。非対話起動では `--permission-mode dontAsk` を明示し、既存設定がbypassでも継承しない。
|
|
35
|
+
`review_flow.mode: auto` はClaudeの `--permission-mode auto` を意味しない。非対話起動では `--permission-mode dontAsk` を明示し、既存設定がbypassでも継承しない。effort・pluginsは保持し、操作許可は既存の個別allow設定と今回の範囲に限定する。`--permission-prompts none` は対話できないpromptを拒否として返すためであり、許可を付与しない。permission_denialsがあれば操作と必要な権限を報告し、既存の明示許可が対象を満たすか確認する。満たす場合だけ必要なSkill/Agentや対象を限定した `--allowedTools` を明示し、同じsessionへ明示的に再依頼する。新しい権限が必要ならCodexが人へ確認する。`--allowedTools` を使う場合も対象・操作に限定し、無条件の `Bash(*)`、bypassPermissions、dangerously-skip-permissionsを使わない。拒否を隠すsilent retryをしない。会話上の許可はCLIの権限チェックを消さない。
|
|
36
36
|
|
|
37
37
|
CLI仕様の参照: [headless](https://code.claude.com/docs/en/headless)、[CLI reference](https://code.claude.com/docs/en/cli-reference)。利用版で必要なflagが非対応なら状態を報告して停止し、権限回避へ切り替えない。
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## 検証CLIと契約版
|
|
6
6
|
|
|
7
|
-
利用中のskillとCLIの版を確認し、0.
|
|
7
|
+
利用中のskillとCLIの版を確認し、0.36.0のskillには同じ版のnpm CLIを導入する(`npm install -g @shinaps/skills@0.36.0`)。pluginだけにはCLIは含まれない。導入・更新が必要ならその権限を確認し、検証のたびに `npx latest` を取得しない。
|
|
8
8
|
|
|
9
9
|
0.35.0から通常設定の `review_flow.mode` に `ask` を受理する。`config_version` は2のままで、既存のauto・manualの設定は変更不要。0.33.0〜0.34.xのCLIと `$schema` のURLは `ask` を拒否するため、`ask` を使う設定では `$schema` も0.35.0以降のURLにする。
|
|
10
10
|
|
|
@@ -88,13 +88,17 @@ shinaps-skills validate-linear-config /absolute/repository/.shinaps/linear.json
|
|
|
88
88
|
|
|
89
89
|
## 経路
|
|
90
90
|
|
|
91
|
-
実装・修正・コミットはClaude Codeが `shinaps:dev-claude` と `shinaps:commit`
|
|
91
|
+
実装・修正・コミットはClaude Codeが `shinaps:dev-claude` と `shinaps:commit` で行う(境界内のUIの微調整はCodexが行える。[担当と工程](workflow.md#codexによるuiの微調整))。Codexとの間の経路は、着手時に通常設定の `review_flow.mode` で一つに決める。
|
|
92
92
|
|
|
93
|
-
| 通常設定 | 経路 | 必要な許可 |
|
|
94
|
-
| --- | --- | --- |
|
|
95
|
-
| `auto` | Codexが起動するローカルClaude CLIの同じsession([Claude CLI](claude-cli.md)) | `claude_cli` |
|
|
96
|
-
| `manual` | WebStorm内の対話Claude CodeセッションへBridgeで依頼する([Bridge](bridge.md)) | `bridge_request` |
|
|
97
|
-
| `ask` | 着手時に人へ一問で確認した回答(auto・manual)の経路 | 回答した経路の許可 |
|
|
93
|
+
| 通常設定 | 経路 | 必要な許可 | メインのモデル |
|
|
94
|
+
| --- | --- | --- | --- |
|
|
95
|
+
| `auto` | Codexが起動するローカルClaude CLIの同じsession([Claude CLI](claude-cli.md)) | `claude_cli` | Opus。起動とすべてのresumeで `--model opus` を指定する |
|
|
96
|
+
| `manual` | WebStorm内の対話Claude CodeセッションへBridgeで依頼する([Bridge](bridge.md)) | `bridge_request` | Opusを基本とし、Issueの着手時にFableかOpusかを確認する。同じIssueの一括修正・継続・再開では選択を引き継ぐ |
|
|
97
|
+
| `ask` | 着手時に人へ一問で確認した回答(auto・manual)の経路 | 回答した経路の許可 | 回答した経路のモデル |
|
|
98
|
+
|
|
99
|
+
- メインはdevを実行するClaude Codeのセッションを指す。担当(独立レビュー・簡素化を含む)のモデルは役割定義の値で、経路とは独立している。単独のdev(Linear進行を経ないdev)のメインは利用者のセッション設定のまま。
|
|
100
|
+
- manualの対話セッションのモデルは、人が `/model` で切り替える。Claudeへのプロンプトや Bridge のメッセージでは切り替えられない([model-config](https://code.claude.com/docs/en/model-config))。
|
|
101
|
+
- manualで基本(Opus)と違う選択なら、Codexが人へ切り替えを依頼する。Codexは人の報告を記録し、実際のモデルを照合できたとは扱わない。
|
|
98
102
|
|
|
99
103
|
- `ask` では、進行役がClaudeへ依頼する前に、Issueの作業内容と推奨する経路の理由を添えてautoかmanualかを一問で確認し、回答まで着手しない。回答・Issue・作業先・設定・選んだ経路を作業記録に残し、同じIssueの修正・再開・QA・差分確定では再質問せず記録した選択を使う。同じIssueに明示的な既存の選択があれば再質問しない。Cycle全体・バックログ消化でもIssueごとに選ぶ。設定の `ask` は書き換えない。選択は他の許可を増やさず、選んだ経路の許可を確認する。
|
|
100
104
|
- 経路はIssueの途中で切り替えない。`permissions`・`stop_after`・`dev_delegation`・worktreeや別セッションの作成の許可は、経路によって変わらない。
|
|
@@ -173,7 +177,7 @@ shinaps-skills validate-linear-config /absolute/repository/.shinaps/linear.json
|
|
|
173
177
|
| --- | --- |
|
|
174
178
|
| `issue_update` | 対象のteam・projectの中で、利用者が任せたIssue・Cycleの範囲に対する運用上の更新(本文・コメント・状態・依存・Linearへの添付、整理で必要になったIssueの作成・分割)と、利用者から任された目的の作業を着手前にIssueへ紐づけるための作成([issue.md](issue.md) の「着手前に作業をIssueへ紐づける」)。チーム設定の変更、未合意の範囲・期限の変更、Cycle外への進行、Issueの削除、外部への送信を含めない |
|
|
175
179
|
| `development_operations` | 任された対象の開発に必要な、既存アカウントへの通常のログイン、ローカル環境準備、プロジェクトの依存導入、開発サーバー・Simulatorの起動停止、ビルド・テスト・QA操作を継続的に許可する。下の範囲に従う |
|
|
176
|
-
| `claude_cli` | auto経路で、Codexが行うClaudeのローカルCLI起動、同じsessionの状態・結果取得、質問への回答・修正・許可済みコミットのresume
|
|
180
|
+
| `claude_cli` | auto経路で、Codexが行うClaudeのローカルCLI起動、同じsessionの状態・結果取得、質問への回答・修正・許可済みコミットのresume。メインのモデル([経路](#経路))の指定のほかは既存CLI設定を保持し、個別の操作権限を維持する([手順](claude-cli.md)) |
|
|
177
181
|
| `bridge_request` | manual経路で、CodexがBridgeで対話Claude Codeセッションへ行う依頼と報告の受け取り、および別会話との任意の進行の引き渡し。報告は照合材料であり、操作許可を変更しない([手順](bridge.md)) |
|
|
178
182
|
| `push` | 対象Issueの作業ブランチの通常のpush |
|
|
179
183
|
| `pr_create` | 対象IssueのPRの作成と更新 |
|
|
@@ -20,9 +20,9 @@
|
|
|
20
20
|
|
|
21
21
|
## Issue開始時の実装体制
|
|
22
22
|
|
|
23
|
-
進行役は各Issueの設定・受入条件・関連範囲・既存検証・リスクを短く確認し、体制判断の材料として必須検証・許可範囲とともにClaude
|
|
23
|
+
進行役は各Issueの設定・受入条件・関連範囲・既存検証・リスクを短く確認し、体制判断の材料として必須検証・許可範囲とともにClaudeへ渡す。体制は[体制の選択](../dev/staffing.md)に従って確認して渡す。範囲全体の指定があれば引き継ぎ、無ければIssueごとに確認する。追加の担当(BASIC・ULTRA)は、Claudeのメインが材料と現物から設計担当の起動前に決め、進行役へ報告する。
|
|
24
24
|
|
|
25
|
-
Claude
|
|
25
|
+
Claudeのメインは途中の新しい根拠で必要な担当を増やし(BASIC・ULTRA。LITEは体制の変更を相談する)、進行役へ報告する。追加担当の確認が必要な工程は結果が揃うまで完了にしない。追加の担当・増員は人の承認待ちにせず、仕様・範囲・許可・予算の変更だけ確認する。
|
|
26
26
|
|
|
27
27
|
## 継続と待機
|
|
28
28
|
|
|
@@ -22,13 +22,32 @@ Simulator等の仮想端末は、プロジェクトごとのQA専用端末を作
|
|
|
22
22
|
- 同じプロジェクトの別の作業が使用中なら、調整して順に使い、占有を奪わない。
|
|
23
23
|
- 自動QAでは端末を不要に前面へ出さず、人の確認が必要なときに対象を表示する。表示やUI操作ツールの制約で他の作業と衝突する場合は、一方的に切り替えず調整する。
|
|
24
24
|
|
|
25
|
+
## QAの時点・対象・最終QA
|
|
26
|
+
|
|
27
|
+
Linear進行でpushまでにCodexへ依頼する動作QAは、次の3つの時点だけにする。push後の環境ごとのAgent QAとCycleの全体QAは、各工程の定めに従う。Claude側の検証・独立レビューとCodexのQAは互いの代わりにしない。
|
|
28
|
+
|
|
29
|
+
| 時点 | 内容 |
|
|
30
|
+
| --- | --- |
|
|
31
|
+
| 途中の目的別確認(以下、途中確認) | 開発途中に実現性や実際の動作を確かめる必要があるとき、Claudeが疑問と確認範囲を明示して依頼する。結果はLocal Agent QAの合格に読み替えない |
|
|
32
|
+
| Local Agent QA | devの完了後の初回QA。不合格後の再QAも初回QAの一部とし、修正の影響で範囲を決めて合格まで続ける |
|
|
33
|
+
| 最終QA | 全コミットの完了後、push前に行う。差分確定中の修正・コミットのたびにはCodexのQAへ戻さず、Claudeが検証・レビューして変更記録を残す |
|
|
34
|
+
|
|
35
|
+
依頼には、対象リビジョン、変更と影響範囲、既存のQA結果、今回確認したい内容を含める。
|
|
36
|
+
|
|
37
|
+
- **対象**: 比較元と予定差分を対象とする。対象外の未コミット変更は環境として記録し、対象に含めない。対象外の変更を含む作業ツリーでQAする場合、その影響を比較できなければ全検証にする。対象の識別は `.git` へ書き込まない読み取りで行う。
|
|
38
|
+
- **範囲**: 変更の影響と既存結果の有効性で決め、修正量の大小では決めない。影響を特定できる範囲は重点的に確認し、比較できない、または影響を限定できない範囲は全検証する。結果の再利用は[テスト方針](../testing.md)に従う。
|
|
39
|
+
- **変更記録**: Local Agent QAの後の各修正・各コミットについて、QAに関わる項目(変更内容・影響範囲・既存QA結果との差分・実施した検証とレビュー・単位案と予定差分の更新)を `fix-log.md` に残したもの。
|
|
40
|
+
- **最終QA**: 比較元からのコミット済み差分が、控え(Local Agent QAに合格した時点の比較元と全体差分。[担当と工程](workflow.md)の「単位案からコミット完了まで」で記録する)と一致すれば、根拠を記録して結果を再利用し、一致を確かめたHEADのSHAを最終合格の対象とする。控えは、更新後の全体期待差分(`commit` の照合基準)とは別に扱い、全体期待差分を更新しても書き換えない。一致しなければ、最終的なコミット済み状態を対象にし、変更記録から影響範囲を決めてQAする。比較できなければ全検証にする。Local Agent QAの後に修正サイクルがあれば、報告された体制をLocal Agent QAと同じ基準で照合する。
|
|
41
|
+
- **不合格**: devの修正サイクル([工程](../dev/workflow.md)の「役割と継続」。[UIの微調整](workflow.md#codexによるuiの微調整)の範囲ならCodexの微調整)、必要なレビュー、既存の承認条件でのコミット、影響範囲の再QAを経て、最終状態での合格を確かめる。
|
|
42
|
+
- **push**: pushするHEADのSHAが最終合格の対象のSHAと一致することを記録してからpushする。一致しない、または確かめられないならpushしない。
|
|
43
|
+
|
|
25
44
|
## QAコメントの書式と更新
|
|
26
45
|
|
|
27
46
|
Codexは各工程のQA結果を、対応するIssueのコメントへ残す。初回と再検証、Local・Staging・Productionを区別する。
|
|
28
47
|
|
|
29
48
|
```markdown
|
|
30
49
|
### <工程・環境> Agent QA — <確認日>
|
|
31
|
-
対象: <Issue
|
|
50
|
+
対象: <Issue・比較元・差分またはコミットSHA>
|
|
32
51
|
環境: <URL・配備版・端末/ブラウザ・ビルド番号>
|
|
33
52
|
|
|
34
53
|
| 受入条件 | 確認方法・期待結果 | 実際の結果 | 判定・証拠 |
|
|
@@ -4,15 +4,16 @@
|
|
|
4
4
|
|
|
5
5
|
| 担当 | 責務 |
|
|
6
6
|
| --- | --- |
|
|
7
|
-
| Codex(進行役) | Issueの作成・整理、仕様相談、Ready判定、依存・Cycle管理、進行判断、作業先設定からの経路と許可の確定(ask
|
|
8
|
-
| Claude(実装担当・Claude Code) |
|
|
9
|
-
| 人 | 未合意の仕様・権限の判断、manualのWebStorm
|
|
7
|
+
| Codex(進行役) | Issueの作成・整理、仕様相談、Ready判定、依存・Cycle管理、進行判断、作業先設定からの経路と許可の確定(askなら人へ一問で確認)、メインのモデル(manualのみ)と体制の確認と記録、体制判断の材料(受入条件・関連範囲・既存検証・リスク)の提示、Claudeへの依頼(auto: CLI、manual: Bridge)、境界内の[UIの微調整](#codexによるuiの微調整)、Local・Staging・ProductionのAgent QA、単位・全体の照合、許可されたpush・PR・merge・配備・公開、Issueへの記録、人への依頼 |
|
|
8
|
+
| Claude(実装担当・Claude Code) | 追加の担当の判断と途中の増員(BASIC・ULTRA)、`shinaps:dev-claude` による技術調査・計画・実装・検証・独立レビュー、QA指摘の修正、`shinaps:commit`(auto: 独立レビュー後にcommit、manual: 人の開始依頼で分割案、人が依頼した単位ごとにcommit)、結果の報告。実装を伴わない文書整理は、作業先リポジトリの規約に従いdevの入口の対象外にできる。スキル・コードの変更は文書の形でも実装としてdevの入口を使う |
|
|
9
|
+
| 人 | 未合意の仕様・権限の判断、manualのWebStormでの差分レビュー・修正相談・修正開始の明示・コミットの開始と単位ごとの依頼、本人の操作が必要な認証等、必要なHuman QA |
|
|
10
10
|
|
|
11
11
|
経路は着手時に通常設定の `review_flow.mode` で決まり、askでは着手時の人の回答で決まる([経路](configuration.md#経路))。autoはCodexが[ローカルClaude CLI](claude-cli.md)の同じsessionをresumeし、manualはWebStorm内の対話Claude Codeセッションへ[Bridge](bridge.md)で依頼する。どちらでもClaudeはdev内レビューと検証を終えて結果を返し、CodexがLocal Agent QAを行う。Claudeの報告をQA合格の根拠にせず、この引き渡しを進行全体の終了と扱わない。
|
|
12
12
|
|
|
13
13
|
- Issueに関わる人への質問・依頼はCodexが窓口になる。manualでは人がWebStormの対話セッションで直接Claudeと相談する。Claudeは決定事項を報告に含め、CodexがIssueへ記録する。
|
|
14
|
-
- manualで人とClaudeが作業している間、Codexは同じIssue
|
|
15
|
-
- Codex
|
|
14
|
+
- manualで人とClaudeが作業している間、Codexは同じIssueへ追加の指示を送らず(Claudeが依頼した途中確認への応答と、[UIの微調整](#codexによるuiの微調整)の人と調整したうえでの一時停止の依頼・返却を除く)、ゴールを `active` のままClaudeの報告を待つ。Claudeの報告の後のCodexのQA中と、Claudeが依頼した途中確認の間は、人とClaudeが作業ツリーを編集しない。
|
|
15
|
+
- 人の指摘は、Codexが窓口としてIssueへ記録する。manualでは、Claudeの報告が台帳([人のレビュー](../human-review.md)の `human-findings.md`)の未対応・見送りの指摘を伝える。autoでは修正開始の明示を受けたら、未対応の指摘をまとめて同じsessionへ渡す。経路によらず、未対応の指摘があるまま差分確定・pushへ進む前に、人へ一問で確認する。
|
|
16
|
+
- CodexはQAで見つけた不具合を修正せず([UIの微調整](#codexによるuiの微調整)を除く)、再現条件と証拠を同じClaude sessionへ返す。同じ作業ツリーを同時に編集せず、人や他のAIの変更を保持する。
|
|
16
17
|
|
|
17
18
|
Linear MCPで扱えない画面操作(添付、並べ替え、Cycleへの紐付けなど)は、Codexが利用可能なブラウザで行う。MCPが対応していないという理由だけで人へ回さない。人の認証や権限が必要な場合だけ人へ依頼する。
|
|
18
19
|
|
|
@@ -22,10 +23,10 @@ Linear MCPで扱えない画面操作(添付、並べ替え、Cycleへの紐
|
|
|
22
23
|
|
|
23
24
|
| 工程 | 状態キー | 内容と次へ進む条件 |
|
|
24
25
|
| --- | --- | --- |
|
|
25
|
-
| 着手 | `ready` | Readyと依存を確認し、作業先設定を読み、通常設定の `review_flow` から経路と必要な許可(auto: `claude_cli`、manual: `bridge_request`)を確定する。通常設定がaskなら、Claudeへの依頼前に作業内容と推奨理由を添えてautoかmanualかを人へ一問で確認し、回答まで着手しない。回答と根拠を作業記録に残し、同じIssue
|
|
26
|
-
| 実装 | `coding`, `local_agent_qa` | Claude
|
|
27
|
-
| 差分確定 | `code_review` | QA合格後、Codexが実効flow・判定記録・QA結果を同じsessionへ渡し、Claudeが `shinaps:commit` を行う。autoは単位ごとに独立レビュー後にcommitする。manualではCodexはcommitを依頼せず、渡した後は報告を待つ。人のコミット開始依頼でClaudeが分割案を示し、人が単位ごとに依頼したcommitを行う。Codex
|
|
28
|
-
| 公開確認 | `post_commit`, `staging_agent_qa`, `staging_human_qa`, `release`, `production_agent_qa`, `production_human_qa` | 受入条件と許可に応じて必要なものだけ行う: push前の最終Agent QA
|
|
26
|
+
| 着手 | `ready` | Readyと依存を確認し、作業先設定を読み、通常設定の `review_flow` から経路と必要な許可(auto: `claude_cli`、manual: `bridge_request`)を確定する。通常設定がaskなら、Claudeへの依頼前に作業内容と推奨理由を添えてautoかmanualかを人へ一問で確認し、回答まで着手しない。回答と根拠を作業記録に残し、同じIssueでは再質問しない。依頼の前に `dev_delegation`(または今回の明示依頼)があるかを確かめ、無ければ人へ一問で確認する。経路・メインのモデル(manualのみ。[経路](configuration.md#経路))・体制([体制の選択](../dev/staffing.md))は別の項目とし、指定されていないものだけを推奨とともに一問ずつ確認して記録する。体制は依頼にも書く。checkout・branch・HEAD・既存差分を固定し、体制判断の材料を添えてClaudeへ依頼する。経路がautoでmanualのパス別ルールがあれば、起こり得る停止([経路](configuration.md#経路))を依頼に書く |
|
|
27
|
+
| 実装 | `coding`, `local_agent_qa` | Claudeのメインが依頼の体制の担当(BASIC・ULTRAでは追加の担当を含む)を決めて報告し、`shinaps:dev-claude` で実装・検証・独立レビューを行い、未コミット差分・単位案・予定差分・判定記録を返す。manualでは人へユーザーのレビュー待ちと明示する。CodexがLocal Agent QA(判定記録と経路の整合、必須担当の照合を含む)を行う。依頼に書いた体制の必須担当([実装体制の判断](../dev/staffing.md))は、完了または合意の記録付きの未実施を合格とする。不合格(必須担当のそれ以外の未完了や代替を含む)なら同じsessionへ戻し、再QAは[初回QAの一部](qa.md#qaの時点対象最終qa)として合格まで続ける |
|
|
28
|
+
| 差分確定 | `code_review` | QA合格後、Codexが実効flow・判定記録・QA結果を同じsessionへ渡し、Claudeが `shinaps:commit` を行う。autoは単位ごとに独立レビュー後にcommitする。manualではCodexはcommitを依頼せず、渡した後は報告を待つ。人のコミット開始依頼でClaudeが分割案を示し、人が単位ごとに依頼したcommitを行う。Codexは各コミットの単位照合と全体照合を行う。差分確定中の実装の修正は、devの修正サイクル([工程](../dev/workflow.md)の「役割と継続」)で行い、ステータスは `code_review` のままにする。修正やコミットのたびにCodexのQAへ戻さない([最終QA](qa.md#qaの時点対象最終qa)) |
|
|
29
|
+
| 公開確認 | `post_commit`, `staging_agent_qa`, `staging_human_qa`, `release`, `production_agent_qa`, `production_human_qa` | 受入条件と許可に応じて必要なものだけ行う: push前の最終Agent QAとpushするHEADの照合([最終QA](qa.md#qaの時点対象最終qa))、push・PR作成、環境配備とStaging/ProductionのAgent QA、必要なHuman QA、merge・配備・公開。適用しない項目は理由を記録する |
|
|
29
30
|
| 結果報告 | (状態キーなし) | 結果・証拠・省略した工程と理由・残項目をIssueへ記録し、終了地点に到達する。必須受入条件をすべて満たしたIssueは `done` にする |
|
|
30
31
|
|
|
31
32
|
- `todo`(未着手)・`refinement`(`linear-plan` による仕様整理)・`human_input`(外部対応の待ち)は5工程の外の状態を表す。
|
|
@@ -47,7 +48,7 @@ Linear MCPで扱えない画面操作(添付、並べ替え、Cycleへの紐
|
|
|
47
48
|
|
|
48
49
|
全工程に共通する。
|
|
49
50
|
|
|
50
|
-
- **戻し先**: 検証失敗・レビュー指摘・QA
|
|
51
|
+
- **戻し先**: 検証失敗・レビュー指摘・QA不合格・単位照合の不一致は、見つけた担当が直さず原因の担当へ戻す。実装・修正は同じClaude session(autoは同じCLI sessionのresume、manualは同じ対話セッション)で行い([UIの微調整](#codexによるuiの微調整)を除く)、Codexは[QAの時点](qa.md#qaの時点対象最終qa)に従って再検証だけを行う。
|
|
51
52
|
- **許可**: 操作の前に `permissions`・実効 `review_flow`・今回の明示指示を照合する。許可がなければ許可待ちで止める。これは終了地点への到達ではない。設定の存在だけを合意と扱わない。
|
|
52
53
|
- **Issueの範囲**: 範囲はIssueの目的・変更内容・受入条件から判断する。記載のない作業でも、目的の実現に必要な手段は範囲に含む。仕様や範囲の拡大が必要になったら、進める前に次の「停止と人への確認」に従って確認する。
|
|
53
54
|
- **停止と人への確認**: 設定不備、経路と単位modeの競合、照合の不一致、目的・仕様・受入条件・許可範囲の変更、本人にしかできない操作、根拠を確認しても解消できない報告の矛盾では、安全な状態で止める。確認の担当は経路で決まる。auto経路と、manualで人がセッションにいない間は、Codexが人へ一問で確認する。manualの作業中は対話セッションのClaudeが人へ一問で確認し、決定を報告に含める。新しい許可が要る決定や許可範囲を広げる決定(push・PR・merge・配備・公開・破壊的操作など)は報告では成立させず、Codexが人へ一問で確認する。
|
|
@@ -59,8 +60,8 @@ Linear MCPで扱えない画面操作(添付、並べ替え、Cycleへの紐
|
|
|
59
60
|
| 状況 | 必要な行動 |
|
|
60
61
|
| --- | --- |
|
|
61
62
|
| Codexから許可範囲と受入条件を伴う実装・修正の依頼を受けた | Claudeは人へ着手を再確認せず、指定されたスキルで実行する |
|
|
62
|
-
| devの入口の中で計画上の判断が必要になった | autoはClaudeがresultでCodexへ相談し、Codexは既存の合意で判断できれば回答する。manualはClaude
|
|
63
|
-
| QAで受入条件の範囲内の不具合が見つかった | Codexが同じClaude session
|
|
63
|
+
| devの入口の中で計画上の判断が必要になった | autoはClaudeがresultでCodexへ相談し、Codexは既存の合意で判断できれば回答する。manualはClaudeが人へ直接確認し、決定を報告する。[途中確認](qa.md#qaの時点対象最終qa)はこの相談の一種で、autoはresult、manualはBridgeで依頼する |
|
|
64
|
+
| QAで受入条件の範囲内の不具合が見つかった | Codexが同じClaude sessionへ修正を依頼し([UIの微調整](#codexによるuiの微調整)の範囲ならCodexが直せる)、Claudeは人の着手許可を改めて取らずに修正する。Codexは[QAの時点](qa.md#qaの時点対象最終qa)に従って再検証する |
|
|
64
65
|
| ClaudeがCLIのresultでcommitの完了を、またはBridgeで人の依頼によるcommitの完了を報告した | Codexは人に同じ事実を聞き直さず、報告の対象とGitの状態を照合して次の工程へ進む |
|
|
65
66
|
| 通常設定がaskで、同じIssueの経路を着手時に選んでいる | Codexは修正・再開・QA・差分確定で経路を再質問せず、記録した選択を使う |
|
|
66
67
|
| 次の操作の継続的な許可があり、必要な工程の結果が揃った | Codexは「進めてもよいか」を再質問せずに実行する |
|
|
@@ -72,12 +73,27 @@ Linear MCPで扱えない画面操作(添付、並べ替え、Cycleへの紐
|
|
|
72
73
|
|
|
73
74
|
単位計画の作成・確認にはコミット許可を要求しない。
|
|
74
75
|
|
|
75
|
-
1. Claudeは成果引き渡しに、モードによらず自然な責務で決めたコミット単位案と予定差分を含める。CodexはLocal Agent QAで対象を検証し、単位案が依頼全体を漏れなく覆い対象外変更を含まないことと、各単位の[判定記録](configuration.md#判定記録と変更時の扱い)
|
|
76
|
+
1. Claudeは成果引き渡しに、モードによらず自然な責務で決めたコミット単位案と予定差分を含める。CodexはLocal Agent QAで対象を検証し、単位案が依頼全体を漏れなく覆い対象外変更を含まないことと、各単位の[判定記録](configuration.md#判定記録と変更時の扱い)を確認する。合格したLocal Agent QAの比較元と全体差分を、最終照合と[最終QA](qa.md#qaの時点対象最終qa)の控えとして記録する。再QAで合格したら記録し直し、全体期待差分の更新では書き換えない。判定記録に経路と異なるmanual単位があれば、差分確定の依頼前に[経路](configuration.md#経路)に従って人へ確認する。
|
|
76
77
|
2. QA合格後、Codexは実効flow・単位の判定記録・QA結果を同じClaude sessionへ渡す。Claudeは設定・予定差分・合意根拠を照合する。
|
|
77
78
|
3. Claudeは `commit` に従う。autoでは独立レビュー後にClaudeがstage・commitする。manualでは人のコミット開始依頼で分割案を示し、人がその単位のコミットを依頼したら単位外を安全に退避して単位をstage・検証し、Claudeがcommitする。各コミット直前・作成後の実差分と確定した予定単位を照合し、予定単位・SHA・検証・レビュー・依頼記録・復元結果をCodexへ返す。
|
|
78
|
-
4. 全単位完了後、Codexは各コミットの単位照合結果を実差分で独立確認したうえで、依頼の比較元からの全体差分が、`commit`
|
|
79
|
+
4. 全単位完了後、Codexは各コミットの単位照合結果を実差分で独立確認したうえで、依頼の比較元からの全体差分が、`commit` の手順で正当な人の修正とdevの修正サイクルで確定した変更を反映した確定済みの全体期待差分と一致し、対象の未コミット変更が残っていないことを照合する。最終差分だけでは途中で混入し後で相殺された対象外変更を検出できないため、単位照合を省かない。人レビューを省略した単位は、上の省略記録を完成させる。
|
|
79
80
|
5. 単位の組み替え・内容・設定の変更は[変更時の扱い](configuration.md#判定記録と変更時の扱い)に従って再判定し、必要なレビュー・許可確認・検証へ戻す。人の依頼によるcommit(または人自身のcommit)の後は、`commit` に従って正当な修正と元の予定差分の対応を記録し、確定単位に更新する。確定単位と実コミットに不一致があれば次工程を止め、SHA・予定差分・実差分の違いを記録して人に確認する。履歴を無断で書き換えない。
|
|
80
81
|
|
|
82
|
+
## CodexによるUIの微調整
|
|
83
|
+
|
|
84
|
+
本書と経路の手順にある「Claudeが実装・修正する」規定(戻し先を含む)の例外として、Linear進行に限って、CodexのメインセッションがUIを直接微調整できる範囲をここにだけ定める。Managedには適用しない(作業先が共有されないremote checkoutで、Codexは直接編集できないため)。
|
|
85
|
+
|
|
86
|
+
- **対象**: iOS・フロントエンドで、画面を見ながら行う方が速いUIの微調整。合意済みの仕様と許可の範囲の内側で、進行役が選ぶ。仕様・アーキテクチャ・データ・契約に関わる変更は対象外とし、通常の相談(Claudeへの修正依頼、または人への確認)へ戻す。
|
|
87
|
+
- **許可**: 依頼・会話・合意済みの設定の対象・操作・範囲で、Codexによる微調整が既に許可されていれば、再確認せず進める。許可が無い場合だけ、必要になった時点で推奨と理由を添えて人へ一問で確認し、回答は同じIssueの中で引き継ぐ。`development_operations` だけから編集の主体の変更を推測しない。別のプロジェクトへ許可を広げない。新しい包括的な権限を加えない。
|
|
88
|
+
- **編集の前**: Claudeのメインと編集中の担当を安全な区切りで待たせる。差分確定中は、単位の退避・stageが無い時点に限る。停止は次の2つで確かめ、auto・manualとも同じに扱う。
|
|
89
|
+
- Claudeのメインが、実行中の担当(実装担当を含む)が無いことを確かめ、その時点のHEADと変更パスを添えて報告している。autoでは、CLIのprocessが終了してresultを受け取っている。
|
|
90
|
+
- Codexが編集の前に、報告の状態と現物の `git status` が一致することを確かめる。
|
|
91
|
+
|
|
92
|
+
実行中のCLIは終了を待つ。止める必要があるときは、session ID・差分・作業記録を保持し、再開する工程を記録してから止める。manualで人が作業中なら、無断で介入せず人と調整する。同時に編集しない。
|
|
93
|
+
- **編集**: 画面を確認しながら、対象のUIファイルだけを編集する。stage・commit・indexの操作はしない。Codex独自の設計体制や独立レビューは置かない。
|
|
94
|
+
- **返却**: 変更したパスと差分、理由、視覚確認の結果(証拠の所在)、未確認事項を、同じClaudeセッションへ返し(autoは終了したprocessのsessionのresume、manualはBridge)、Issueにも記録する。
|
|
95
|
+
- **Claude側**: 現在の工程の差分として取り込み(実装担当が読み直して `fix-log.md` に記録する)、必要な検証を行って既存のレビューを続ける([工程](../dev/workflow.md)の「役割と継続」)。全体レビューの回数はリセットしない。Local Agent QAより前の変更はそのQAの対象に含め、QAより後の変更は[変更記録](qa.md#qaの時点対象最終qa)として最終QAへ集約する。QAを追加で起動しない。
|
|
96
|
+
|
|
81
97
|
## 待ち状態
|
|
82
98
|
|
|
83
99
|
その場の質問と、本人が対応できるレビュー・作業の待ちは、元の工程を維持する。外部の資料提供・権限付与・審査など、自分たちでは解消できない対応の待ちだけを `human_input` で表す。別Issueの待ちは依存関係、Claudeの作業待ちはAI間の待機として扱う。
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# Managed Agents への依頼と観測
|
|
2
2
|
|
|
3
|
-
作業先の設定を読み、Claude Managed Agents の lead `shinaps-dev-managed-cc` へ dev を依頼し、進み具合の観測・質問の取り次ぎ・成果物と draft PR
|
|
3
|
+
作業先の設定を読み、Claude Managed Agents の lead `shinaps-dev-managed-cc` へ dev を依頼し、進み具合の観測・質問の取り次ぎ・成果物と draft PR の確認を行う手順。体制は合意する入力として渡す。計画・実装・レビューの工程と追加の担当は lead が [skill `dev-managed-cc`](../../managed-agents/skills/dev-managed-cc/SKILL.md) に従って決めるので、ここでは指示しない。
|
|
4
4
|
|
|
5
5
|
## 呼び出し時に合意する入力
|
|
6
6
|
|
|
7
7
|
設定からは読まず、依頼のたびに利用者と合意する。
|
|
8
8
|
|
|
9
|
-
- 必須: base ブランチとその SHA、head
|
|
9
|
+
- 必須: base ブランチとその SHA、head ブランチ、範囲と受入条件、体制(LITE・BASIC・ULTRA。[体制の選択](../dev/staffing.md)に従い推奨を添えて確認する)、許可(commit・head への push・draft PR の作成のうち明示されたもの)、予算(USD のセント単位)
|
|
10
10
|
- 任意: 必須検証のコマンド、コミットの author、利用者 CLAUDE.md の添付
|
|
11
11
|
|
|
12
12
|
設定から読むのは `definitions`(lock の場所)・`repository`・`vault_id` だけで、lead と環境の ID は lock から読む([設定](configuration.md))。許可と予算は合意した内容だけで、会話の途中で増やさない。
|
|
@@ -52,6 +52,7 @@ initial_events:
|
|
|
52
52
|
base: <ブランチ> @ <SHA>
|
|
53
53
|
head: <ブランチ名>
|
|
54
54
|
範囲と受入条件: <内容>
|
|
55
|
+
体制: <LITE|BASIC|ULTRA>
|
|
55
56
|
許可: <commit・headへのpush・draft PRの作成のうち許可するもの>
|
|
56
57
|
予算: <金額>
|
|
57
58
|
必須検証(任意): <コマンド。省略時はリポジトリの規約に従う>
|
|
@@ -105,7 +106,7 @@ unset GITHUB_TOKEN
|
|
|
105
106
|
|
|
106
107
|
## 6. 終了する
|
|
107
108
|
|
|
108
|
-
状態行、取得した出力ファイル、コミット、push 先、PR の URL、未検証の事項を報告する。merge・deploy・release・Issue の更新・セッションのアーカイブは行わない。QA
|
|
109
|
+
状態行、取得した出力ファイル、コミット、push 先、PR の URL、未検証の事項を報告する。merge・deploy・release・Issue の更新・セッションのアーカイブは行わない。QA は呼び出し元が別に行う。完了後に修正する場合は、新しい依頼として、体制を含めて合意し直す。
|
|
109
110
|
|
|
110
111
|
## 未検証の境界
|
|
111
112
|
|
|
@@ -114,3 +115,4 @@ unset GITHUB_TOKEN
|
|
|
114
115
|
- GitHub MCP で draft PR を作れるか。`draft: true` は lead への指示でしか担保されない。
|
|
115
116
|
- vault に資格情報を登録できたことは、上の3点の確認にならない。
|
|
116
117
|
- `events send` による回答の送信は、本文の構造を API 仕様で確かめただけで、実際のセッションではまだ送っていない。出力ファイルの一覧と取得は既存のセッションで確かめた。
|
|
118
|
+
- 完了したスレッドが同時実行の枠(25本)を空けるか。ULTRAでは、ラウンドごとに新しく起動する担当を含めて、同時に保つスレッドが多い。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Managed 構成の導入と更新
|
|
2
2
|
|
|
3
|
-
共通の dev 構成(lead `shinaps-dev-managed-cc`、dev の
|
|
3
|
+
共通の dev 構成(lead `shinaps-dev-managed-cc`、dev の7役割、skill `dev-managed-cc`、環境 `shinaps-dev`)を利用者の組織へ導入・更新する手順。既存の lock を使い、同じリソースを重複して作らない。セッションの作成・予定実行は行わない。dev の工程は [skill `dev-managed-cc`](../../managed-agents/skills/dev-managed-cc/SKILL.md) が持つので、ここでは扱わない。
|
|
4
4
|
|
|
5
5
|
## 前提
|
|
6
6
|
|
|
@@ -36,9 +36,11 @@
|
|
|
36
36
|
サブシェルで `<definitions>` に移動してから実行する。lock は実行した場所から上へ探され、キーは lock のディレクトリからの相対パスになるため。
|
|
37
37
|
|
|
38
38
|
- 出力の `Preview` 行が `./claude-lock.json`(`<definitions>` 直下)であることを確かめる。違えば止める。別の場所の lock を `--lock-file` で指定しない。キーの基準がずれて重複作成につながる。
|
|
39
|
-
- lock があれば、計画は定義を変えたリソースの update
|
|
40
|
-
- 次の場合は適用せずに止めて報告する: `This plan cannot be applied`
|
|
41
|
-
-
|
|
39
|
+
- lock があれば、計画は定義を変えたリソースの update、テンプレートに新しく加わったリソースの create、それ以外の unchanged になる。lock にあってソースの無い項目は警告として残る。`--prune` は付けない。
|
|
40
|
+
- 次の場合は適用せずに止めて報告する: `This plan cannot be applied` が出る、意図しない環境の更新がある。
|
|
41
|
+
- create があれば、`ant beta:agents list --beta managed-agents-2026-04-01` と `ant beta:environments list --beta managed-agents-2026-04-01` で、アーカイブされていない同じ名前の lead・役割・環境が既にあるかを確かめる。あれば止める。アーカイブの状態を判定できなければ止める。
|
|
42
|
+
- lock がある場合は、lock を変えずに状況を報告して利用者と相談する。
|
|
43
|
+
- lock が無い場合は、lock を戻す方法を利用者と相談する。同じマシンで同じ組織に導入済みなら、その `<definitions>` を指すよう設定を直してやり直す。別のマシンでは[lock の扱い](configuration.md#lock-の扱い)に従い、バックアップや以前の置き場所から lock を戻し、無ければ相談する。
|
|
42
44
|
|
|
43
45
|
## 5. 適用する
|
|
44
46
|
|
|
@@ -5,17 +5,17 @@ description: 指定したIssue・Cycle・バックログの実装からQA・許
|
|
|
5
5
|
|
|
6
6
|
# Linearを起点に開発を進める
|
|
7
7
|
|
|
8
|
-
Issueの責務・受入条件・ステータスを、実際の成果と一致させる。初版は利用者本人の環境向けで、Codexが進行役として進行・Agent QA・Issueの記録・人への窓口を担当し、実装・修正・コミットはClaude Code
|
|
8
|
+
Issueの責務・受入条件・ステータスを、実際の成果と一致させる。初版は利用者本人の環境向けで、Codexが進行役として進行・Agent QA・Issueの記録・人への窓口を担当し、実装・修正・コミットはClaude Codeが行う(UIの微調整は[担当と工程](../../references/linear/workflow.md#codexによるuiの微調整)の境界の内側でCodexが行える)。Codexに実装の入口はない。主フローは着手・実装・差分確定・公開確認・結果報告の5工程で、担当と工程は[references/workflow.md](../../references/linear/workflow.md)にある。
|
|
9
9
|
|
|
10
10
|
## 経路を先に確定する
|
|
11
11
|
|
|
12
12
|
着手時に作業先設定の通常の `review_flow.mode` で経路を決め、Issueの途中で切り替えない([経路](../../references/linear/configuration.md#経路))。
|
|
13
13
|
|
|
14
14
|
- auto: [ローカルClaude CLI](../../references/linear/claude-cli.md)を起動し、質問への回答・修正・差分確定を同じsessionのresumeで依頼する。許可は `claude_cli`。
|
|
15
|
-
- manual: WebStorm内の対話Claude Codeセッションへ[Bridge](../../references/linear/bridge.md)で依頼する。人とClaudeの作業中は同じIssue
|
|
15
|
+
- manual: WebStorm内の対話Claude Codeセッションへ[Bridge](../../references/linear/bridge.md)で依頼する。人とClaudeの作業中は同じIssueへ指示を送らず(Claudeが依頼した途中確認への応答と、[UIの微調整](../../references/linear/workflow.md#codexによるuiの微調整)の人と調整したうえでの一時停止の依頼・返却を除く)、報告を待つ。QA合格後もcommitを依頼せず、QA結果と判定記録を渡して人の依頼によるcommitの報告を待つ。許可は `bridge_request`。
|
|
16
16
|
- ask: Claudeへ依頼する前に、Issueの作業内容と推奨する経路の理由を添えてautoかmanualかを人へ一問で確認し、回答まで着手しない。記録・再質問しない条件・許可は[経路](../../references/linear/configuration.md#経路)に従う。Claudeへの依頼には解決したmodeと回答の記録を添える。
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
体制判断の材料(受入条件・関連範囲・既存検証・リスク)を依頼に添える。体制は[担当と工程](../../references/linear/workflow.md)の着手で確認して依頼に書き、BASIC・ULTRAでは追加の担当をClaudeのメインが決めて報告する。
|
|
19
19
|
|
|
20
20
|
## 実行範囲を確定する
|
|
21
21
|
|
|
@@ -11,8 +11,8 @@ description: 作業先の Managed 設定を読み、Claude Managed Agents の le
|
|
|
11
11
|
|
|
12
12
|
[設定](../../references/managed/configuration.md)と[依頼と観測の手順](../../references/managed/execute.md)を読んで進める。
|
|
13
13
|
|
|
14
|
-
- 呼び出しのたびに base ブランチと SHA・head
|
|
14
|
+
- 呼び出しのたびに base ブランチと SHA・head ブランチ・範囲と受入条件・体制(LITE・BASIC・ULTRA)・許可・予算を利用者と合意する。設定・lock・過去の作業から推定しない。
|
|
15
15
|
- 設定から読むのは `definitions`(lock の場所)・`repository`・`vault_id` だけで、lead と環境の ID は lock から読む。lock が無ければ止め、導入は managed-setup で行う。
|
|
16
|
-
-
|
|
16
|
+
- 計画・実装・レビューの工程と追加の担当は lead に任せ、ここでは指示しない。
|
|
17
17
|
- Linear の進行とは独立した入口である。merge・deploy・release・Issue の更新・セッションのアーカイブは行わない。
|
|
18
18
|
- 秘密値を表示・記録しない。
|