cpersona 2.4.34__tar.gz
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.
- cpersona-2.4.34/.agents/README.md +66 -0
- cpersona-2.4.34/.agents/agents.md +82 -0
- cpersona-2.4.34/.agents/skills/aggregate.md +37 -0
- cpersona-2.4.34/.agents/skills/dispatch.md +52 -0
- cpersona-2.4.34/.agents/skills/handoff_to_claude.md +22 -0
- cpersona-2.4.34/.agents/skills/plan_task.md +27 -0
- cpersona-2.4.34/.agents/skills/research.md +84 -0
- cpersona-2.4.34/.agents/skills/review_diff.md +22 -0
- cpersona-2.4.34/.agents/skills/update_cpersona.md +23 -0
- cpersona-2.4.34/.agents/workflows/cross-repo.md +20 -0
- cpersona-2.4.34/.agents/workflows/handoff.md +27 -0
- cpersona-2.4.34/.agents/workflows/implement.md +16 -0
- cpersona-2.4.34/.agents/workflows/plan.md +17 -0
- cpersona-2.4.34/.agents-artifacts/.processed.log +3 -0
- cpersona-2.4.34/.agents-artifacts/changes/20260419-1858-summary.md +7 -0
- cpersona-2.4.34/.agents-artifacts/changes/20260419-2014-linecount.md +5 -0
- cpersona-2.4.34/.agents-artifacts/changes/20260419-2017-parallel.md +5 -0
- cpersona-2.4.34/.agents-artifacts/changes/20260419-2032-v021.md +6 -0
- cpersona-2.4.34/.agents-artifacts/tasks/20260419-1858-readme-summary.md +45 -0
- cpersona-2.4.34/.agents-artifacts/tasks/20260419-1945-linecount.md +27 -0
- cpersona-2.4.34/.agents-artifacts/tasks/20260419-1950-linecount.md +27 -0
- cpersona-2.4.34/.agents-artifacts/tasks/20260419-1954-linecount.md +27 -0
- cpersona-2.4.34/.agents-artifacts/tasks/20260419-2014-linecount.md +27 -0
- cpersona-2.4.34/.agents-artifacts/tasks/20260419-2017-parallel.md +26 -0
- cpersona-2.4.34/.agents-artifacts/tasks/20260419-2032-v021.md +28 -0
- cpersona-2.4.34/.agents-artifacts/tasks/20260421-2114-smoke-v041.md +8 -0
- cpersona-2.4.34/.agents-artifacts/tasks/20260501-1200-drift-docs.md +20 -0
- cpersona-2.4.34/.gitignore +11 -0
- cpersona-2.4.34/Dockerfile +17 -0
- cpersona-2.4.34/LICENSE +21 -0
- cpersona-2.4.34/PKG-INFO +13 -0
- cpersona-2.4.34/README.md +299 -0
- cpersona-2.4.34/cloto-connector.json +73 -0
- cpersona-2.4.34/cpersona/__init__.py +1 -0
- cpersona-2.4.34/cpersona/__main__.py +6 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/__init__.py +64 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/embedding_client.py +183 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/isolation.py +113 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/llm_provider.py +1609 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/mcp_stream_interceptor.py +233 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/mcp_utils.py +180 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/mgp_utils.py +234 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/no_persist.py +185 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/search.py +257 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/semantic_cache.py +146 -0
- cpersona-2.4.34/cpersona/_vendored_mcp_common/validation.py +65 -0
- cpersona-2.4.34/cpersona/admin_handlers.py +1442 -0
- cpersona-2.4.34/cpersona/config.py +126 -0
- cpersona-2.4.34/cpersona/database.py +289 -0
- cpersona-2.4.34/cpersona/health.py +205 -0
- cpersona-2.4.34/cpersona/maintenance_handlers.py +634 -0
- cpersona-2.4.34/cpersona/memory_handlers.py +1112 -0
- cpersona-2.4.34/cpersona/proxy_stdio.py +122 -0
- cpersona-2.4.34/cpersona/server.py +1019 -0
- cpersona-2.4.34/cpersona/tasks.py +159 -0
- cpersona-2.4.34/cpersona/utils.py +179 -0
- cpersona-2.4.34/cpersona/vector.py +332 -0
- cpersona-2.4.34/docs/DEGRADED_ADVISORY_DESIGN.md +296 -0
- cpersona-2.4.34/glama.json +6 -0
- cpersona-2.4.34/pyproject.toml +30 -0
- cpersona-2.4.34/qa/issue-registry.json +33 -0
- cpersona-2.4.34/scripts/sync-vendored-mcp-common.sh +31 -0
- cpersona-2.4.34/scripts/verify-issues.sh +178 -0
- cpersona-2.4.34/server.py +16 -0
- cpersona-2.4.34/skills/cpersona-memory/SKILL.md +235 -0
- cpersona-2.4.34/test_calibration_formula.py +157 -0
- cpersona-2.4.34/test_channel_axis_migration.py +198 -0
- cpersona-2.4.34/test_do_recall_response.py +237 -0
- cpersona-2.4.34/test_episode_channel.py +181 -0
- cpersona-2.4.34/test_isolation.py +174 -0
- cpersona-2.4.34/test_no_persist.py +207 -0
- cpersona-2.4.34/test_recall_precision.py +243 -0
- cpersona-2.4.34/test_recall_quality.py +388 -0
- cpersona-2.4.34/test_recall_source_id.py +244 -0
- cpersona-2.4.34/test_schema_v9_migration.py +255 -0
- cpersona-2.4.34/test_task_queue.py +371 -0
- cpersona-2.4.34/test_threshold_calibration.py +260 -0
- cpersona-2.4.34/uv.lock +809 -0
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# .agents-template
|
|
2
|
+
|
|
3
|
+
`/Users/hachiya/Desktop/repos/` 配下の各リポから symlink される Antigravity agent 設定の正本。
|
|
4
|
+
|
|
5
|
+
## 構造
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
.agents-template/
|
|
9
|
+
├── agents.md # 5 役のエージェント定義 (PM / Planner / Implementer / Reviewer / DocWriter)
|
|
10
|
+
├── skills/ # 再利用可能な手順書
|
|
11
|
+
│ ├── aggregate.md
|
|
12
|
+
│ ├── dispatch.md
|
|
13
|
+
│ ├── handoff_to_claude.md
|
|
14
|
+
│ ├── plan_task.md
|
|
15
|
+
│ ├── review_diff.md
|
|
16
|
+
│ └── update_cpersona.md
|
|
17
|
+
└── workflows/ # スラッシュコマンド
|
|
18
|
+
├── cross-repo.md
|
|
19
|
+
├── handoff.md
|
|
20
|
+
├── implement.md
|
|
21
|
+
└── plan.md
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## 同期
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
/Users/hachiya/Desktop/repos/bin/agents-sync.sh
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
各リポに `.agents -> ../.agents-template` の symlink を作成し、
|
|
31
|
+
`.git/info/exclude` に `.agents` と `.agents-artifacts` を追加 (個人設定、team には反映されない)。
|
|
32
|
+
|
|
33
|
+
対象リポ:
|
|
34
|
+
- ClotoCore
|
|
35
|
+
- cloto-mcp-servers
|
|
36
|
+
- cpersona
|
|
37
|
+
- chatty-mouse
|
|
38
|
+
- XPoopers
|
|
39
|
+
- awesome-mcp-servers
|
|
40
|
+
|
|
41
|
+
対象外: zenn-content (記事リポのため)
|
|
42
|
+
|
|
43
|
+
## 運用フロー (パターン A+B)
|
|
44
|
+
|
|
45
|
+
1. Antigravity で対象リポを開く
|
|
46
|
+
2. `/plan` で Gemini が PM + Planner 役で仕様分解 → `.agents-artifacts/plans/`
|
|
47
|
+
3. user 承認
|
|
48
|
+
4. `/handoff` で Claude Code に引き渡す or `/implement` で Antigravity 内 Claude 実装
|
|
49
|
+
5. Gemini Flash Reviewer が diff 検査 → high 0 なら完了
|
|
50
|
+
|
|
51
|
+
## Claude Code からの直接委譲 (Explorer role)
|
|
52
|
+
|
|
53
|
+
調査・探索タスクは Claude Code 側から直接 task file を書くことで Gemini に委譲できる:
|
|
54
|
+
|
|
55
|
+
- PreToolUse hook (`bin/antigravity-hint-hook.sh`) が自動判定し task file 経路を促す
|
|
56
|
+
- task file: `.agents-artifacts/tasks/<YYYYMMDD-HHMM>-<slug>.md` (frontmatter: `role: Explorer, model: gemini-pro`)
|
|
57
|
+
- dispatcher 拡張 `hachiya.agents-dispatcher` (v0.3.1) が Gemini 1M-context agent を自動 spawn
|
|
58
|
+
- 結果は `.agents-artifacts/changes/<slug>.md`
|
|
59
|
+
- 詳細: `/Users/hachiya/Desktop/repos/CLAUDE.md` の "Antigravity Delegation" セクション
|
|
60
|
+
|
|
61
|
+
**実装系タスクは委譲しない** — Claude が自身で実装を行う方針 (feedback_antigravity_usage.md)。
|
|
62
|
+
|
|
63
|
+
## カスタマイズ
|
|
64
|
+
|
|
65
|
+
symlink なのでこのテンプレを編集すれば全リポに即反映。
|
|
66
|
+
リポ固有設定が必要なら該当リポで symlink を解除し実体コピーに切り替える。
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# Team Agents
|
|
2
|
+
|
|
3
|
+
Antigravity 用の 6 役エージェント定義。Claude Code トークン節約のため、
|
|
4
|
+
計画・レビュー・調査・Web リサーチを Gemini 側、実装のみ Claude に寄せる (パターン A+B)。
|
|
5
|
+
|
|
6
|
+
## PM (Product Manager)
|
|
7
|
+
- **Model**: `gemini-3.1-pro`
|
|
8
|
+
- **Goal**: user 要件を仕様に分解し曖昧さを除去
|
|
9
|
+
- **Responsibilities**:
|
|
10
|
+
- 要件ヒアリングとスコープ確定
|
|
11
|
+
- 仕様書 Artifact を `.agents-artifacts/specs/` に出力
|
|
12
|
+
- Planner への橋渡し
|
|
13
|
+
- **Constraints**:
|
|
14
|
+
- 実装コードは書かない
|
|
15
|
+
- 不明点は仮定せず user に確認
|
|
16
|
+
|
|
17
|
+
## Planner
|
|
18
|
+
- **Model**: `gemini-3.1-pro`
|
|
19
|
+
- **Goal**: 仕様からタスク DAG を生成 (最小差分原則)
|
|
20
|
+
- **Responsibilities**:
|
|
21
|
+
- タスク分解とファイル影響範囲特定
|
|
22
|
+
- 実装手順を `.agents-artifacts/plans/` に出力 (Markdown + checklist)
|
|
23
|
+
- Implementer が読める形式で完結させる
|
|
24
|
+
- **Constraints**:
|
|
25
|
+
- 推測でファイルパス・関数名を書かない (`grep` / `glob` で確認)
|
|
26
|
+
- 過剰設計禁止 (YAGNI)
|
|
27
|
+
- 1 plan = 1 目的
|
|
28
|
+
|
|
29
|
+
## Implementer
|
|
30
|
+
|
|
31
|
+
> ⚠️ **現状方針**: Antigravity への実装委譲は行わない(詳細は memory `feedback_antigravity_usage.md`)。このロール定義は将来拡張や限定的な並列 dispatch 用に残しているが、**通常フローでは Claude Code が直接実装する**。
|
|
32
|
+
>
|
|
33
|
+
> **SDK 制約**: 下記 Model 欄で `claude-opus-*` を指定しても、dispatcher の `resolveModel()` が silent に `Models.CLAUDE_SONNET` へ降格する (gotcha #5、`reference_antigravity_failure_modes.md`)。Warning は output channel のみで toast 無し — 実 Sonnet 動作を期待すること。
|
|
34
|
+
|
|
35
|
+
- **Model**: `claude-opus-4-6` (Antigravity 内) または Claude Code へ hand-off
|
|
36
|
+
- **Goal**: 承認済み plan に従い最小変更で実装
|
|
37
|
+
- **Responsibilities**:
|
|
38
|
+
- `.agents-artifacts/plans/` の承認済み plan を読む
|
|
39
|
+
- diff を書き、既存テストが通ることを確認
|
|
40
|
+
- 変更サマリを `.agents-artifacts/changes/` に記録
|
|
41
|
+
- **Constraints**:
|
|
42
|
+
- 承認外の refactor / abstraction 追加禁止
|
|
43
|
+
- 既存ファイル編集を優先、新規作成は必要時のみ
|
|
44
|
+
- emoji 使用禁止 (user preference)
|
|
45
|
+
- 無断 version bump 禁止 (user memory: `feedback_version_bump.md`)
|
|
46
|
+
|
|
47
|
+
## Reviewer
|
|
48
|
+
- **Model**: `gemini-flash-latest`
|
|
49
|
+
- **Goal**: diff の論理バグ・plan 逸脱を検出 (Claude 再投入を最小化)
|
|
50
|
+
- **Responsibilities**:
|
|
51
|
+
- `git diff` 読解と重大度分類 (high / medium / low)
|
|
52
|
+
- high 以上のみ `.agents-artifacts/reviews/` に出力
|
|
53
|
+
- Implementer への差し戻し判定
|
|
54
|
+
- **Constraints**:
|
|
55
|
+
- スタイル nit pick 禁止
|
|
56
|
+
- plan で認められた変更は咎めない
|
|
57
|
+
|
|
58
|
+
## DocWriter
|
|
59
|
+
- **Model**: `gemini-flash-latest`
|
|
60
|
+
- **Goal**: 変更に伴うドキュメント/コミットメッセージ草稿
|
|
61
|
+
- **Responsibilities**:
|
|
62
|
+
- コミットメッセージ案 (1-2 文、why 中心)
|
|
63
|
+
- README / CHANGELOG 差分案
|
|
64
|
+
- **Constraints**:
|
|
65
|
+
- 実装内容を逸脱しない
|
|
66
|
+
- emoji 禁止
|
|
67
|
+
|
|
68
|
+
## Researcher
|
|
69
|
+
|
|
70
|
+
> Web 上の広範調査を Claude Code context の外で完遂するためのロール。Explorer (コード探索) のパラレルとして Web 調査を担う。PreToolUse hook (`bin/antigravity-hint-hook.sh`) が WebSearch 呼び出し時に発火条件を満たすと task file 経路を促す。
|
|
71
|
+
|
|
72
|
+
- **Model**: `gemini-pro` (Antigravity の browsing tool が Pro 側にあるため Flash 不可)
|
|
73
|
+
- **Goal**: 複数ソース比較・landscape 調査・best practices 収集を `.agents-artifacts/changes/` に要約のみ戻す
|
|
74
|
+
- **Responsibilities**:
|
|
75
|
+
- 横断 Web 調査 (比較 / survey / alternatives / best practices / ecosystem)
|
|
76
|
+
- 引用 URL と出典日付を必ず明記
|
|
77
|
+
- task 本文に列挙された判定基準に沿って採用 / 不採用を明確化
|
|
78
|
+
- **Constraints**:
|
|
79
|
+
- コード変更は行わない (Explorer と同じく Claude 側実装)
|
|
80
|
+
- 推測で URL を書かない — browsing tool の fetch 結果を根拠とする
|
|
81
|
+
- 2 年以上前のソースは「古い可能性あり」とラベル
|
|
82
|
+
- version bump を含む提案禁止 (`feedback_version_bump.md`)
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Skill: aggregate
|
|
2
|
+
|
|
3
|
+
Antigravity 並列 agent 実行後、各リポの `.agents-artifacts/changes/` を集約して最終レポート生成。
|
|
4
|
+
|
|
5
|
+
## 手順
|
|
6
|
+
|
|
7
|
+
1. dispatch 時に記録した task id / 対象リポ一覧を取得 (`.agents-artifacts/tasks/<id>/`)
|
|
8
|
+
2. 各リポの `.agents-artifacts/changes/<slug>.md` を読む
|
|
9
|
+
3. リポ別に以下を抽出:
|
|
10
|
+
- 完了 / 未完了 / エラー状態
|
|
11
|
+
- 変更ファイル数
|
|
12
|
+
- Acceptance Criteria の達成状況
|
|
13
|
+
4. 集約レポートを `.agents-artifacts/reports/<YYYYMMDD-HHMM>-aggregate.md` に出力:
|
|
14
|
+
```markdown
|
|
15
|
+
# 並列実行レポート <timestamp>
|
|
16
|
+
|
|
17
|
+
## Summary
|
|
18
|
+
- 対象: <N> リポ
|
|
19
|
+
- 完了: <M>
|
|
20
|
+
- 未完了: <X>
|
|
21
|
+
- エラー: <Y>
|
|
22
|
+
|
|
23
|
+
## Per-repo
|
|
24
|
+
| Repo | Status | Files | Note |
|
|
25
|
+
|---|---|---|---|
|
|
26
|
+
...
|
|
27
|
+
|
|
28
|
+
## Next Actions
|
|
29
|
+
- <未完了タスクの再投入提案>
|
|
30
|
+
- <エラーの原因分類>
|
|
31
|
+
```
|
|
32
|
+
5. user に提示、未完了分は `dispatch` で再投入するか判断仰ぐ
|
|
33
|
+
|
|
34
|
+
## 禁止事項
|
|
35
|
+
|
|
36
|
+
- `changes/` がまだ存在しないリポを「エラー」扱いしない (実行中の可能性)
|
|
37
|
+
- 独断で再投入しない (必ず user 承認を取る)
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Skill: dispatch
|
|
2
|
+
|
|
3
|
+
> ⚠️ **このスキルは並列 Implementer dispatch 用。現在のデフォルトワークフローではない。**
|
|
4
|
+
>
|
|
5
|
+
> - **調査・探索タスク** (デフォルト) → Explorer role + `model: gemini-pro`。CLAUDE.md "Antigravity Delegation" セクションおよび PreToolUse hook (`bin/antigravity-hint-hook.sh`) が誘導する
|
|
6
|
+
> - **実装系 dispatch** (このスキル) → `feedback_antigravity_usage.md` の方針で原則やらない。user 明示指示があるときのみ
|
|
7
|
+
> - **Opus 指定は Sonnet 降格**: `claude-opus-4-6` と書いても dispatcher の `resolveModel()` が silent に CLAUDE_SONNET に降格する (gotcha #5)
|
|
8
|
+
|
|
9
|
+
高レベル目標を Antigravity Manager View 用の並列 task file 群に分解する。
|
|
10
|
+
|
|
11
|
+
## 手順
|
|
12
|
+
|
|
13
|
+
1. user から目標文を受ける (例: 「6リポの README 表記揺れを統一」)
|
|
14
|
+
2. 対象リポ範囲を特定:
|
|
15
|
+
- 明示されていれば user 指定通り
|
|
16
|
+
- 「全リポ」なら `/Users/hachiya/Desktop/repos/bin/agents-sync.sh` の TARGETS 配列参照
|
|
17
|
+
3. 各リポに対し以下を `.agents-artifacts/tasks/<YYYYMMDD-HHMM>-<slug>.md` として生成:
|
|
18
|
+
```markdown
|
|
19
|
+
---
|
|
20
|
+
role: Implementer
|
|
21
|
+
model: claude-opus-4-6
|
|
22
|
+
repo: <repo-name>
|
|
23
|
+
goal: <具体的なサブゴール>
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Context
|
|
27
|
+
<リポ固有の context, CLAUDE.md 抜粋など>
|
|
28
|
+
|
|
29
|
+
## Task
|
|
30
|
+
<具体的な作業指示>
|
|
31
|
+
|
|
32
|
+
## Acceptance Criteria
|
|
33
|
+
- [ ] <検証項目1>
|
|
34
|
+
- [ ] <検証項目2>
|
|
35
|
+
|
|
36
|
+
## Output
|
|
37
|
+
- 完了後 `.agents-artifacts/changes/<slug>.md` に変更サマリを記録
|
|
38
|
+
```
|
|
39
|
+
4. user に task file 一覧を提示、承認を得る
|
|
40
|
+
5. 承認後、`launch.sh <repos>` で Antigravity を並列起動
|
|
41
|
+
|
|
42
|
+
## モデル選定指針
|
|
43
|
+
|
|
44
|
+
- 調査・分析系 → `gemini-3.1-pro`
|
|
45
|
+
- コード実装 → `claude-opus-4-6`
|
|
46
|
+
- ドキュメント修正 → `gemini-flash-latest`
|
|
47
|
+
- レビュー → `gemini-flash-latest`
|
|
48
|
+
|
|
49
|
+
## 禁止事項
|
|
50
|
+
|
|
51
|
+
- 各 task は独立実行可能であること (並列性担保)
|
|
52
|
+
- task 間依存がある場合は順序を明記し、並列不可を警告
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Skill: handoff_to_claude
|
|
2
|
+
|
|
3
|
+
Antigravity Planner 成果物を Claude Code へ引き渡す手順。
|
|
4
|
+
|
|
5
|
+
## 手順
|
|
6
|
+
|
|
7
|
+
1. `.agents-artifacts/plans/` から最新の**承認済み** plan を特定
|
|
8
|
+
2. user に以下テンプレを提示:
|
|
9
|
+
```
|
|
10
|
+
Claude Code で当該リポを開き次を入力:
|
|
11
|
+
|
|
12
|
+
`.agents-artifacts/plans/<filename>.md に従って実装してください。
|
|
13
|
+
Plan外の refactor / 抽象化は行わないでください。
|
|
14
|
+
完了したら .agents-artifacts/changes/<timestamp>.md に変更サマリを残してください。`
|
|
15
|
+
```
|
|
16
|
+
3. Claude Code 実装完了後、Antigravity に戻り Reviewer (Gemini Flash) で diff 確認
|
|
17
|
+
|
|
18
|
+
## トークン節約ポイント
|
|
19
|
+
|
|
20
|
+
- plan は Markdown 化済み → Claude は再設計不要
|
|
21
|
+
- Claude には plan パスのみ渡し自力で読ませる (プロンプト短縮)
|
|
22
|
+
- 計画系探索は Gemini 1M context で完結 → Claude の 200K を実装に集中
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Skill: plan_task
|
|
2
|
+
|
|
3
|
+
要件から実装タスク DAG を生成する Planner 手順。
|
|
4
|
+
|
|
5
|
+
## 手順
|
|
6
|
+
|
|
7
|
+
1. リポジトリ context 把握:
|
|
8
|
+
- `README.md`, `CLAUDE.md`, 親 `../CLAUDE.md` を読む
|
|
9
|
+
- `git log -n 20 --oneline` で直近の方向性確認
|
|
10
|
+
2. 要件を 3 視点で要約:
|
|
11
|
+
- What — 何を変えるか
|
|
12
|
+
- Why — なぜ変えるか
|
|
13
|
+
- Where — 影響ファイル (`grep` / `glob` で存在確認)
|
|
14
|
+
3. タスクを 30〜90 分粒度に分割
|
|
15
|
+
4. 各タスクに記載:
|
|
16
|
+
- 変更対象 `path:line`
|
|
17
|
+
- 期待挙動と検証手段 (test / manual check)
|
|
18
|
+
- 依存タスク (DAG)
|
|
19
|
+
5. 出力先: `.agents-artifacts/plans/<YYYYMMDD-HHMM>-<slug>.md`
|
|
20
|
+
6. user 承認を待つ。承認なしに Implementer 起動禁止
|
|
21
|
+
|
|
22
|
+
## 禁止事項
|
|
23
|
+
|
|
24
|
+
- 推測でファイル名/関数名を書く (存在確認必須)
|
|
25
|
+
- plan 内に実装コードを含める (擬似コードも最小限)
|
|
26
|
+
- 複数機能を 1 タスクに詰め込む
|
|
27
|
+
- 仕様漏れを「後で直す」で先送り — PM に差し戻す
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# Skill: research
|
|
2
|
+
|
|
3
|
+
> Explorer (コード探索) のパラレルで、**Web 横断調査を Antigravity / Gemini Pro に委譲する**手順。PreToolUse hook (`bin/antigravity-hint-hook.sh`) が WebSearch 呼び出し時に閾値を超えると task file 経路を促す。
|
|
4
|
+
|
|
5
|
+
## 用途 (when to use)
|
|
6
|
+
|
|
7
|
+
- 複数ソース比較 (例: "compare ONNX runtime vs candle vs mistral.rs")
|
|
8
|
+
- landscape / ecosystem survey (例: "2026 年のローカル LLM inference engine")
|
|
9
|
+
- best practices / alternatives 収集
|
|
10
|
+
- 結果を context に 3,000 tokens 以上戻す見込みがある調査
|
|
11
|
+
- Claude が要約を使って実装判断するケース
|
|
12
|
+
|
|
13
|
+
## 非対象 (when NOT to use)
|
|
14
|
+
|
|
15
|
+
- 特定単一 URL の fetch (github.com / docs.rs / MDN / 既知ブログ) — 通常 WebFetch
|
|
16
|
+
- 固有名詞 1 件の確認 (例: "Tauri 2.0 release notes") — 通常 WebSearch
|
|
17
|
+
- ユーザーが直前に URL を明示したケース — 指示された URL をそのまま読む
|
|
18
|
+
- 単語数が少なく結果が 1 位で完結するクエリ
|
|
19
|
+
|
|
20
|
+
Antigravity 往復レイテンシは 9 秒〜。浅い query に使うと純損失。
|
|
21
|
+
|
|
22
|
+
## 手順
|
|
23
|
+
|
|
24
|
+
1. `<repo>/.agents-artifacts/tasks/<YYYYMMDD-HHMM>-<slug>.md` を Write:
|
|
25
|
+
|
|
26
|
+
```markdown
|
|
27
|
+
---
|
|
28
|
+
role: Researcher
|
|
29
|
+
model: gemini-pro
|
|
30
|
+
repo: <repo-name>
|
|
31
|
+
goal: <1 行で調査目的>
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Context
|
|
35
|
+
<既知事項を簡潔に — context 節約のため>
|
|
36
|
+
<調査対象の候補ドメイン / 検索キーワード案があれば列挙>
|
|
37
|
+
|
|
38
|
+
## Task
|
|
39
|
+
- 調べる質問を箇条書きで
|
|
40
|
+
- 判定基準 (採用 / 不採用の線引き) を明示
|
|
41
|
+
|
|
42
|
+
## Output
|
|
43
|
+
`.agents-artifacts/changes/<slug>.md` に以下を記録:
|
|
44
|
+
- 要約 (3-5 bullet)
|
|
45
|
+
- 引用 URL と出典日付 (必須)
|
|
46
|
+
- 判定基準に沿った採用/不採用の表
|
|
47
|
+
- 不確実性 / 古いソースの注記
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
2. dispatcher が数秒以内に cascade 生成 (Gemini 3.1 Pro + browsing)
|
|
51
|
+
3. `.agents-artifacts/changes/<slug>.md` を Read で取得
|
|
52
|
+
4. 失敗時は `.agents-artifacts/tasks/.failed/` に退避 → 内容確認して fallback
|
|
53
|
+
|
|
54
|
+
## 発火条件 (hook が自動判定)
|
|
55
|
+
|
|
56
|
+
hook (`bin/antigravity-hint-hook.sh` の `should_delegate_websearch`) は以下のいずれかで発火:
|
|
57
|
+
|
|
58
|
+
- query 語数 ≥ 8
|
|
59
|
+
- query が探索語を含む: `compare|comparison|vs.|survey|landscape|best practices|alternatives|overview|state of|ecosystem|benchmark|pros and cons|tradeoffs`
|
|
60
|
+
|
|
61
|
+
閾値未満や WebFetch (単一 URL) は silent skip — 通常の in-process tool 呼び出しでよい。
|
|
62
|
+
|
|
63
|
+
## モデル選定
|
|
64
|
+
|
|
65
|
+
- **必ず `gemini-pro`** — browsing tool は Pro 側にしかない。`gemini-flash-latest` を指定すると `resolveModel()` で GEMINI_FLASH に落ちて browsing が無効化される (結果が薄くなる)
|
|
66
|
+
|
|
67
|
+
## fallback
|
|
68
|
+
|
|
69
|
+
- Antigravity 未起動 → 通常 WebSearch を使う (hook は silent)
|
|
70
|
+
- Antigravity 内で browsing が起動しない / 結果が薄い → task 本文の Context に URL 候補を具体的に列挙してから再投下
|
|
71
|
+
- 結果が明らかに古いデータに寄っている → フォローアップ task で「2025 年以降のソースに限定」と指定して再投下
|
|
72
|
+
|
|
73
|
+
## 禁止事項
|
|
74
|
+
|
|
75
|
+
- 実装委譲しない (Claude が code / PR / commit を書く — feedback_antigravity_usage.md)
|
|
76
|
+
- version bump を含む判断を依頼しない (feedback_version_bump.md)
|
|
77
|
+
- ユーザーの秘密情報 (API キー / webhook secret 等) を task file に書かない
|
|
78
|
+
|
|
79
|
+
## 既知の落とし穴
|
|
80
|
+
|
|
81
|
+
- **browsing tool 未起動**: dispatcher 経由 cascade で browsing が自動 ON になるのは UI 仕様依存。結果が要約ではなく「調べられませんでした」系なら task 本文に URL を明示し再実行
|
|
82
|
+
- **role 表記ゆれ**: frontmatter は `Researcher` (大文字 R) で統一。dispatcher は任意文字列受理するが文書整合のため固定
|
|
83
|
+
- **Explorer との混同**: コード読解は Explorer (`dispatch.md`)、Web 調査は Researcher (本 skill)。混ぜない
|
|
84
|
+
- **出典日付欠落**: 要約だけ戻って URL / 日付が抜けていると Claude 側で再検証が必要になり往復コストが倍になる。Output 要件で必ず明示する
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Skill: review_diff
|
|
2
|
+
|
|
3
|
+
Gemini Flash による軽量 diff レビュー。Claude への再投入を最小化。
|
|
4
|
+
|
|
5
|
+
## 手順
|
|
6
|
+
|
|
7
|
+
1. `git diff <base>..HEAD` または `git diff --cached` を取得
|
|
8
|
+
2. 観点:
|
|
9
|
+
- **plan 逸脱** — 承認外の変更・無関係な refactor
|
|
10
|
+
- **既知の落とし穴** — null check 漏れ、invariant 違反、未使用変数増加
|
|
11
|
+
- **user feedback 違反** — emoji、不要コメント、無断 version bump、`--no-verify` 等
|
|
12
|
+
3. 重大度分類: high / medium / low
|
|
13
|
+
4. high 以上のみ `.agents-artifacts/reviews/<YYYYMMDD-HHMM>.md` に出力
|
|
14
|
+
5. 判定:
|
|
15
|
+
- high 0 件 → OK サイン
|
|
16
|
+
- high ≥ 1 件 → Implementer に差し戻し
|
|
17
|
+
|
|
18
|
+
## 禁止事項
|
|
19
|
+
|
|
20
|
+
- スタイルの好みで指摘しない
|
|
21
|
+
- plan で認められた変更を咎めない
|
|
22
|
+
- Claude Opus にエスカレーションする前に必ず Flash で絞り込む
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Skill: update_cpersona
|
|
2
|
+
|
|
3
|
+
CPersona MCP 統合リポ (`ClotoCore`, `cloto-mcp-servers`, `cpersona`) 用。
|
|
4
|
+
他リポでは無効化。
|
|
5
|
+
|
|
6
|
+
## 実行条件
|
|
7
|
+
|
|
8
|
+
- 重要な設計判断が発生
|
|
9
|
+
- バグ発見と修正が完了
|
|
10
|
+
- セッション終了時
|
|
11
|
+
|
|
12
|
+
## 手順
|
|
13
|
+
|
|
14
|
+
1. `mcp__cpersona__store` で要約保存
|
|
15
|
+
- `agent_id`: `claude-code` (Claude Code) / `agent.sapphy` (ClotoCore 側)
|
|
16
|
+
- `channel`: プロジェクト別に分ける場合 `clotocore` など
|
|
17
|
+
2. 絶対に失いたくないルールは続けて `lock_memory`
|
|
18
|
+
3. ルール更新時は `delete + store` でなく `update_memory` 使用
|
|
19
|
+
4. セッション終了時:
|
|
20
|
+
- Sonnet サブエージェントで summary / keywords を pre-compute
|
|
21
|
+
- `archive_episode` に history (実会話履歴) / summary / keywords / resolved を渡す
|
|
22
|
+
|
|
23
|
+
詳細は `/Users/hachiya/Desktop/repos/CLAUDE.md` 参照。
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Workflow: cross-repo
|
|
2
|
+
|
|
3
|
+
複数リポに同種の変更を並列適用する。Claude Code が dispatcher、Antigravity が parallel worker、Claude Code が aggregator。
|
|
4
|
+
|
|
5
|
+
## ステップ
|
|
6
|
+
|
|
7
|
+
1. **[Claude Code]** user から目標受理
|
|
8
|
+
2. **[Claude Code]** `dispatch` skill で task file 群を `.agents-artifacts/tasks/` に生成
|
|
9
|
+
3. **[Claude Code]** user 承認待ち
|
|
10
|
+
4. **[Claude Code]** `launch.sh <repos>` で Antigravity を対象リポ分並列起動
|
|
11
|
+
5. **[user]** 各 Antigravity window で Manager View 起動 → task file を Implementer に与える
|
|
12
|
+
6. **[Antigravity 各 agent]** 実装 → `.agents-artifacts/changes/` へサマリ出力
|
|
13
|
+
7. **[Claude Code]** `watch-changes.sh` が完了検知 → `aggregate` skill 起動
|
|
14
|
+
8. **[Claude Code]** 集約レポートを user に提示
|
|
15
|
+
|
|
16
|
+
## モデル分担
|
|
17
|
+
|
|
18
|
+
- dispatch (task 分解) → Claude Code 本体
|
|
19
|
+
- 実装 → Antigravity 内 Claude Opus 4.6 (並列 5)
|
|
20
|
+
- aggregate → Claude Code 本体 + 必要なら Gemini Flash でレポート整形
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Workflow: /handoff
|
|
2
|
+
|
|
3
|
+
Antigravity で計画した plan を Claude Code (CLI) に引き渡す。
|
|
4
|
+
|
|
5
|
+
## ステップ
|
|
6
|
+
|
|
7
|
+
1. `.agents-artifacts/plans/` の最新承認済み plan ファイルを取得
|
|
8
|
+
2. user に下記を提示:
|
|
9
|
+
```
|
|
10
|
+
Claude Code で当該リポを開き次を入力:
|
|
11
|
+
|
|
12
|
+
`.agents-artifacts/plans/<filename>.md に従って実装してください。
|
|
13
|
+
Plan外の refactor / 抽象化は行わないでください。
|
|
14
|
+
完了後 .agents-artifacts/changes/<timestamp>.md に変更サマリを残してください。`
|
|
15
|
+
```
|
|
16
|
+
3. Claude Code 完了後、Antigravity に戻り `git diff` を Reviewer (Gemini Flash) で検査
|
|
17
|
+
|
|
18
|
+
## トークン収支
|
|
19
|
+
|
|
20
|
+
| フェーズ | モデル | 出所 |
|
|
21
|
+
|---|---|---|
|
|
22
|
+
| 計画 | Gemini 3.1 Pro | Antigravity (無料 public preview) |
|
|
23
|
+
| 実装 | Claude | ユーザの Claude Code サブスク |
|
|
24
|
+
| レビュー | Gemini Flash | Antigravity (無料) |
|
|
25
|
+
| ドキュメント | Gemini Flash | Antigravity (無料) |
|
|
26
|
+
|
|
27
|
+
→ Claude 消費は実装フェーズのみに集中
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Workflow: /implement
|
|
2
|
+
|
|
3
|
+
承認済み plan を Antigravity 内で直接実装する。
|
|
4
|
+
|
|
5
|
+
## ステップ
|
|
6
|
+
|
|
7
|
+
1. `.agents-artifacts/plans/` の最新承認済み plan を特定
|
|
8
|
+
2. **Implementer** (Claude Opus 4.6) 起動、plan に従い実装
|
|
9
|
+
3. **Reviewer** (Gemini Flash) で `review_diff` skill 実行
|
|
10
|
+
4. high issue 0 → user に完了報告 / high ≥ 1 → Implementer 差し戻し
|
|
11
|
+
5. **DocWriter** (Gemini Flash) でコミットメッセージ草稿
|
|
12
|
+
|
|
13
|
+
## Claude Code へ委譲する場合
|
|
14
|
+
|
|
15
|
+
Antigravity 内 Claude は Antigravity 経由で消費される。
|
|
16
|
+
自分の Claude Code サブスク / API クレジットを使いたい場合は `/handoff` を使う。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# Workflow: /plan
|
|
2
|
+
|
|
3
|
+
PM → Planner で仕様分解 → タスク DAG 生成 → user 承認待ち。
|
|
4
|
+
|
|
5
|
+
## ステップ
|
|
6
|
+
|
|
7
|
+
1. **PM** (Gemini 3.1 Pro): 要件ヒアリング、仕様書 Artifact → `.agents-artifacts/specs/`
|
|
8
|
+
2. **Planner** (Gemini 3.1 Pro): `plan_task` skill 実行 → `.agents-artifacts/plans/`
|
|
9
|
+
3. user 承認待ち
|
|
10
|
+
4. 承認後、`/handoff` (Claude Code) または `/implement` (Antigravity 内) へ
|
|
11
|
+
|
|
12
|
+
## トリガー
|
|
13
|
+
|
|
14
|
+
user 入力に「計画して」「仕様化」「タスク分解」「設計」等が含まれる場合
|
|
15
|
+
|
|
16
|
+
## モデル
|
|
17
|
+
- 全て Gemini 系で完結 → Claude トークン消費 0
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# cpersona — Summary
|
|
2
|
+
|
|
3
|
+
- Purpose: Give Claude and MCP clients persistent memory across sessions using a local SQLite-based storage system.
|
|
4
|
+
- Stack: Python 3.10+, SQLite (FTS5/Trigram), MCP (Model Context Protocol), and optional ONNX-based embedding servers.
|
|
5
|
+
- Users: Developers and users of Claude Desktop, Claude Code, or any MCP-compatible hosts seeking local context persistence.
|
|
6
|
+
- Differentiator: Zero LLM dependency (no API costs), hybrid search with RRF merge, and built-in auto-repair health checks.
|
|
7
|
+
- Status: Production-ready standalone tool with 117+ tests, Schema v8 auto-migration, and MIT license.
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
role: Implementer
|
|
3
|
+
model: gemini-flash-latest
|
|
4
|
+
repo: cpersona
|
|
5
|
+
goal: README を読み 5 行以内で要約
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Context
|
|
9
|
+
|
|
10
|
+
End-to-end オーケストレーションテスト。ソース無改変、出力のみ。
|
|
11
|
+
|
|
12
|
+
- リポ: cpersona
|
|
13
|
+
- 参照ファイル: `README.md`
|
|
14
|
+
|
|
15
|
+
## Task
|
|
16
|
+
|
|
17
|
+
1. `README.md` を読む
|
|
18
|
+
2. 以下を満たす要約を**最大 5 行**で作成:
|
|
19
|
+
- リポジトリの目的 (1 行)
|
|
20
|
+
- 主要技術スタック (1 行)
|
|
21
|
+
- ターゲットユーザ (1 行)
|
|
22
|
+
- 特徴的な差別化点 (1 行)
|
|
23
|
+
- 現在のステータス (1 行)
|
|
24
|
+
3. 出力先: `.agents-artifacts/changes/20260419-1858-summary.md`
|
|
25
|
+
4. 出力フォーマット:
|
|
26
|
+
```markdown
|
|
27
|
+
# cpersona — Summary
|
|
28
|
+
|
|
29
|
+
- Purpose: ...
|
|
30
|
+
- Stack: ...
|
|
31
|
+
- Users: ...
|
|
32
|
+
- Differentiator: ...
|
|
33
|
+
- Status: ...
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Acceptance Criteria
|
|
37
|
+
|
|
38
|
+
- [ ] `.agents-artifacts/changes/20260419-1858-summary.md` が存在する
|
|
39
|
+
- [ ] 5 つの bullet が埋まっている
|
|
40
|
+
- [ ] ソース (README.md, コード, etc) を**一切変更していない**
|
|
41
|
+
|
|
42
|
+
## Output
|
|
43
|
+
|
|
44
|
+
- 変更サマリは不要 (これ自体がサマリ生成タスク)
|
|
45
|
+
- `.agents-artifacts/changes/20260419-1858-summary.md` のみ生成
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
role: Implementer
|
|
3
|
+
model: gemini-flash-latest
|
|
4
|
+
repo: cpersona
|
|
5
|
+
goal: README のラインカウント
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Task
|
|
9
|
+
|
|
10
|
+
1. `README.md` のラインカウントを `wc -l` 相当で取得
|
|
11
|
+
2. 結果を `.agents-artifacts/changes/20260419-1945-linecount.md` に以下形式で出力:
|
|
12
|
+
|
|
13
|
+
```markdown
|
|
14
|
+
# cpersona README line count
|
|
15
|
+
|
|
16
|
+
- file: README.md
|
|
17
|
+
- lines: <数値>
|
|
18
|
+
- counted_at: 2026-04-19 19:45
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
3. ソースファイルは変更しない
|
|
22
|
+
|
|
23
|
+
## Acceptance Criteria
|
|
24
|
+
|
|
25
|
+
- [ ] `.agents-artifacts/changes/20260419-1945-linecount.md` が存在
|
|
26
|
+
- [ ] `lines:` に数値が入っている
|
|
27
|
+
- [ ] README.md を含む既存ファイルは変更されていない
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
role: Implementer
|
|
3
|
+
model: gemini-flash-latest
|
|
4
|
+
repo: cpersona
|
|
5
|
+
goal: README のラインカウント (post-fix 再テスト)
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Task
|
|
9
|
+
|
|
10
|
+
1. `README.md` のラインカウントを取得
|
|
11
|
+
2. 結果を `.agents-artifacts/changes/20260419-1950-linecount.md` に以下形式で出力:
|
|
12
|
+
|
|
13
|
+
```markdown
|
|
14
|
+
# cpersona README line count
|
|
15
|
+
|
|
16
|
+
- file: README.md
|
|
17
|
+
- lines: <数値>
|
|
18
|
+
- counted_at: 2026-04-19 19:50
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
3. ソースファイルは変更しない
|
|
22
|
+
|
|
23
|
+
## Acceptance Criteria
|
|
24
|
+
|
|
25
|
+
- [ ] `.agents-artifacts/changes/20260419-1950-linecount.md` が存在
|
|
26
|
+
- [ ] `lines:` に数値が入っている
|
|
27
|
+
- [ ] 既存ファイルは変更されていない
|