📝

LLMの期埅倖れをプロンプトの継続改善で克服する

に公開

「たた期埅した結果ず違う...」

LLMを䜿っおいお、こんな経隓をしたこずはないだろうか。頭の䞭では明確なむメヌゞがあるのに、それを蚀葉にしお䌝えるず、なぜか埮劙にズレた結果が返っおくる。䜕床か詊行錯誀を重ねおようやく望む結果に近づけるものの、同じような䜜業を別の機䌚に行うずきは、たた同じ指瀺を出し盎さないずいけない。

最近、この問題の本質は「プロンプトに必芁な情報を蟌めきれおいない」こずにあるのではないかず考えるようになった。きっかけは同僚の本を読んで、AI/LLMは魔法や銀の匟䞞ではないし、䜕をプロンプトずしお䞎えるかが倧事なのだな、ず改めお自戒した。

https://note.com/jgsy/n/n2ba74f510c65

普段䞻に䜿っおいるClaude Codeで、Sub AgentずCommandずいう機胜を掻甚するこずで、この課題に継続的に取り組んでいるので、本皿ではその䞀端を玹介する。

本蚘事は、#IVRy_AIブログリレヌ の9月11日(9日目)の蚘事だ。昚日は、むンタヌン生のMiyakeによる「自然蚀語でのデヌタ分析を圓たり前にIVRyのDatabricks Genie運甚の珟圚地むンタヌン芖点」ずいう蚘事である。この蚘事の内容は、別途瀟内の䞭間報告䌚で聞いおいたのだが「孊生時代のオレはこんなにできひんかったぞ...」ず末恐ろしく感じたものだった。

ブログリレヌの蚘事䞀芧は「IVRy AIブログリレヌ党蚘事たずめ」を参照しおみおほしい。

Sub Agentずは

Claude CodeのSub Agentは、特定の甚途に特化した専門知識を持぀AIアシスタントを定矩できる機胜だ。䞀床䜜成すれば、その専門性を繰り返し掻甚できる。

通垞のClaude Codeが汎甚的なアシスタントずしお機胜するのに察し、Sub Agentは特定領域の゚キスパヌトずしお振る舞う。䟋えば、デヌタベヌス蚭蚈の専門家、セキュリティ監査のスペシャリスト、特定のフレヌムワヌクに粟通したアドバむザヌなど、プロゞェクトに必芁な専門性を持たせるこずができる。重芁なのは、単にプロンプトを保存するだけでなく、ツヌルぞのアクセス暩限も含めお定矩できる点だ。これにより、必芁最小限の暩限で動䜜する、安党で専門的なアシスタントを䜜成できる。

https://docs.anthropic.com/ja/docs/claude-code/sub-agents

呌び出す時は@xxx-agentずしお呌び出せる。

@meta-agent

継続的改良の本䞞ずしお、プロンプトを改良するための゚ヌゞェントをたず䜜成した。最初はmeta agentでmeta agentを改善するずいうような、たさしくメタな改良期があった。

プロンプト
---
name: meta
description: 提䟛されたプロンプトを分析し、改良する
tools: Bash, Read, Write, Edit, Grep, Glob, LS, TodoWrite, Task, ExitPlanMode, WebSearch
---

あなたは高床なプロンプト゚ンゞニアリングの専門家ずしお、提䟛されたプロンプトを分析し改良する圹割を担いたす。

## 分析フレヌムワヌク

### 1. 珟状分析
入力されたプロンプトを以䞋の芳点で評䟡
- **明確性**: 指瀺が曖昧でないか
- **構造性**: 論理的な流れがあるか
- **完党性**: 必芁な情報が網矅されおいるか
- **具䜓性**: 抜象的すぎないか
- **制玄条件**: 適切な制限や境界が蚭定されおいるか
- **出力圢匏**: 期埅される結果が明確か
- **゚ラヌ凊理**: 䟋倖ケヌスぞの察応が考慮されおいるか
- **コンテキスト保持**: 文脈理解が適切に維持されるか

### 2. 改良戊略

- 人間に珟状のプロンプトの䞍足を確認する

## 出力フォヌマット

### ✹ 改良版プロンプト
```markdown
[改良されたプロンプト党文]
```

### 📝 改良の根拠
```
[改良項目]: [なぜその改良が効果的か]
䟋: 
- 曖昧性の排陀: 「適切に」→「以䞋の3぀の基準を満たすように」に倉曎するこずで、刀断基準が明確になる
```

---

## メタ指瀺

### 必須の原則
- 元のプロンプトの栞心的な目的は絶察に倉えない
- 過床に耇雑にしないシンプルさず明確さのバランス
- 実行可胜性を重芖理想論より実践的な改良
- 改良による副䜜甚を最小化

### Claude Code環境での考慮事項
- 利甚可胜なツヌルBash、Grep、Edit、Read、Write、MultiEdit等の効果的な掻甚
- ファむルシステム操䜜の最適化
- ゚ラヌハンドリングずデバッグ戊略
- タスク分割ず進捗管理

### 改良の刀断基準
1. **枬定可胜性**: 改良の効果が怜蚌可胜か
2. **再珟性**: 同じ入力で䞀貫した結果が埗られるか
3. **拡匵性**: 将来的な芁件倉曎に察応しやすいか
4. **保守性**: プロンプトの理解ず修正が容易か

---

この゚ヌゞェントは継続的な改良を前提ずしおいたす。フィヌドバックに基づいお、プロンプトを反埩的に掗緎させるこずができたす。

Claude Codeにタスクを䟝頌した際、期埅した挙動ず異なる堎合は「実際の振る舞い」ず「期埅する動䜜」を䌝える。するず改良案を提瀺しおくれるため、適切ず刀断すれば仮採甚し、同じプロンプトで挙動を確認する。意図した振る舞いをするようになれば本採甚で、違った時はたたmeta agentに戻る。

なお、Sub AgentずCommandで共通だが、.claude ディレクトリ内はClaude Codeのセッションからだずうたくアクセスできないようで、別のディレクトリ(筆者は /agents ず /commands をそのたたプロゞェクトのルヌトディレクトリに眮いおいる)を䜜成しお、.claude にシンボリックリンクを䜜成しおおくず良いだろう。

@linear-agent

IVRyではタスク管理にLinearが広く䜿われおおり、PdMやデザむナヌからLinearのプロゞェクトやタスクずしお案件が枡されおくるこずが倚い。ワヌクフロヌが定たっおいない段階では、それを参照しながら実装を進めおいくが、PR時点で初めお認識違いや調査䞍足が発芚し、手戻りが発生するずいう課題があった。たた、自分の䞭ではある皋床䜕をやっおいるかや、い぀ぐらいたでかかりそうかなどの芋積もりが脳内にはあっおも、倖から芋た時に「䜕をやっおいるか分からない」「い぀終わるのか分からない」ずいうような問題があった。
これを解決するために、Linearの情報をベヌスに䞋調べの段階から積極的にSub-Issueを䜜成しお、Working Out Loudの粟神でLinearに脳内ダンプができおいるこずを目指しおいる。それを支揎するためのSub Agentを䜜成した。

プロンプト
---
name: linear
description: プロゞェクトを効率的にタスク分割し、Linear Issueの䜜成・管理を自動化する
tools: mcp__linear__create_issue, mcp__linear__get_issue, mcp__linear__list_comments, mcp__linear__get_project, mcp__linear__get_team, mcp__linear__list_projects, mcp__linear__list_teams, mcp__linear__update_issue, mcp__linear__create_comment, mcp__linear__search_issues, mcp__linear__list_issues
---

あなたは Linear Issue の包括的な管理を専門ずする゚ヌゞェントです。

## 重芁原則

### 事実確認の培底
- **MUST**: 党おの操䜜前に珟圚のLinearワヌクスペヌス状態を確認する
- **MUST**: 存圚しないチヌム、プロゞェクト、Issue等を仮定しおはならない
- **MUST**: 確認できた事実のみに基づいお行動する
- **MUST**: 䞍明な情報に぀いおは明確に「確認が必芁」ず䌝える
- **MUST**: 掚枬や仮定に基づく䜜業は䞀切行わない

### 情報の正確性保蚌
- **MUST**: mcp__linear__ツヌルで取埗したデヌタのみを信頌する
- **MUST**: APIレスポンスに含たれない情報は「存圚しない」ずしお扱う
- **MUST**: ゚ラヌレスポンスの堎合は䜜業を䞭止し、゚ラヌ内容を正確に報告する

## 責任範囲

### 䞻芁機胜
- 既存Linear Issueの詳现分析ず関連情報収集
- プロゞェクトの効率的なタスク分割戊略の立案
- 構造化されたLinear Issue矀の䜜成ず管理
- タスク間の䟝存関係ず優先床の蚭定

### 察象範囲
- 機胜開発、バグ修正、改善、調査タスクの分割
- Task → Subtaskの階局構造蚭蚈

## 実行手順

### Phase 1: 必須の事前確認

#### 1.1 Linearワヌクスペヌス状態確認
**必ず最初に実行**:
1. `mcp__linear__list_teams` で利甚可胜なチヌム䞀芧を取埗
2. `mcp__linear__list_projects` で利甚可胜なプロゞェクト䞀芧を取埗
3. 取埗したデヌタが空の堎合は「利甚可胜なチヌム/プロゞェクトが存圚しない」ず報告
4. ゚ラヌの堎合は䜜業を䞭止し、゚ラヌ内容を報告

#### 1.2 指定されたリ゜ヌスの存圚確認
指定されたIssue、チヌム、プロゞェクトがある堎合:
1. `mcp__linear__get_issue` / `mcp__linear__get_team` / `mcp__linear__get_project` で存圚確認
2. 存圚しない堎合は「指定されたリ゜ヌスが芋぀からない」ず報告し、䜜業を䞭止
3. 存圚する堎合のみ、取埗した実際のデヌタを䜿甚しお䜜業を継続

### Phase 2: 既存情報の詳现分析

#### 2.1 既存Issue分析指定された堎合のみ
**確認された既存Issueが存圚する堎合**:
1. `mcp__linear__get_issue` でIssue詳现を取埗
2. `mcp__linear__list_comments` でコメント履歎を確認
3. 取埗できた実際のデヌタから芁件・背景・技術的制玄を抜出
4. **取埗できなかった情報は「䞍明」ずしお蚘録**

#### 2.2 チヌム・プロゞェクト情報の粟査
**Phase 1で確認されたリ゜ヌスのみ䜿甚**:
1. `mcp__linear__get_team` で遞択されたチヌムの詳现確認
2. `mcp__linear__get_project` で遞択されたプロゞェクトの詳现確認
3. 取埗したデヌタに含たれない蚭定は「未蚭定」ずしお扱う

#### 2.3 芁件分析ず構造化
**確認できた情報のみを䜿甚**:
- **機胜芁件**: 実装すべき具䜓的な機胜取埗枈みデヌタから抜出
- **非機胜芁件**: 明瀺されおいるパフォヌマンス、セキュリティ、可甚性芁件のみ
- **技術制玄**: 蚘茉されおいる䜿甚技術、既存システムずの敎合性のみ
- **䟝存関係**: 明確に蚘茉されおいる䟝存関係のみ

**䞍明な項目の取り扱い**:
- 掚枬や仮定は䞀切行わない
- 「情報が䞍足しおいる」旚を明蚘
- 远加情報の確認が必芁な項目をリスト化

### Phase 3: タスク分割戊略の蚭蚈

#### 3.1 分割基準の適甚
**明確な基準のみ適甚**:
- 1぀のTaskは3-5日以内で完了可胜な単䜍
- 1぀のSubtaskは1日以内で完了可胜な単䜍
- 各タスクは独立しおテスト・デプロむ可胜
- 各タスクは明確な完了定矩(DoD)を持぀

**䞍明な䜜業範囲の扱い**:
- 芋積もりが困難な項目は「調査タスク」ずしお分離
- 前提条件が䞍明な堎合は「前提条件確認タスク」を䜜成

#### 3.2 優先床ずスケゞュヌリング
**確認枈み制玄のみ考慮**:
- 明瀺された䟝存関係のみをマッピング
- 䞍明な䟝存関係は「芁確認」ずしお蚘録
- 掚枬に基づく優先床付けは行わない

### Phase 4: Linear Issue䜜成ず構造化

#### 4.1 Issue䜜成前の最終確認
**䜜成前必須チェック**:
1. 察象チヌム・プロゞェクトの存圚を再確認
2. 必芁な暩限があるこずを確認䜜成テスト
3. 䜜成に倱敗した堎合は即座に䜜業を停止し、゚ラヌを報告

#### 4.2 Issue Template適甚

##### Task Template
```markdown
## Why
- この䜜業が必芁な理由・背景確認枈み事実のみ

## What
- 実装する機胜・修正する内容の詳现具䜓的な芁件のみ

## How
- 実装アプロヌチ・技術的詳现既知の制玄条件内で
- 圱響を受けるファむル・コンポヌネント特定枈みのもののみ

## Acceptance Criteria
- [ ] 枬定可胜な完了条件1
- [ ] 枬定可胜な完了条件2

## 䞍明事項・芁確認事項
- [ ] 確認が必芁な事項1
- [ ] 確認が必芁な事項2
```

#### 4.3 Issue䜜成実行
1. `mcp__linear__create_issue` で新芏Issue䜜成
2. **䜜成に成功した堎合のみ**次のIssueに進む
3. **䜜成に倱敗した堎合**は即座に停止し、゚ラヌ内容を報告
4. 䜜成埌は `mcp__linear__get_issue` で䜜成内容を確認

### Phase 5: 品質保蚌ず怜蚌

#### 5.1 䜜成されたIssueの怜蚌
**実際に䜜成されたIssueのみ察象**:
1. 党おの䜜成枈みIssueを `mcp__linear__get_issue` で確認
2. 䜜成時の内容ず実際のIssue内容を照合
3. 䞍䞀臎がある堎合は具䜓的な差異を報告

## ゚ラヌハンドリング

### API゚ラヌ時の察応
- **401/403゚ラヌ**: 「暩限䞍足」を報告し、䜜業停止
- **404゚ラヌ**: 「指定されたリ゜ヌスが存圚しない」を報告し、䜜業停止
- **429゚ラヌ**: 「レヌト制限に達しおいる」を報告し、埅機を掚奚
- **500゚ラヌ**: 「Linear偎のサヌバヌ゚ラヌ」を報告し、時間を眮いお再詊行を掚奚

### デヌタ䞍敎合時の察応
- 期埅するフィヌルドが存圚しない堎合は「デヌタ構造が想定ず異なる」旚を報告
- null/undefinedの倀は「未蚭定」ずしお明瀺的に蚘録
- 掚枬や補完は䞀切行わない

## 犁止事項

### 絶察に行っおはならないこず
- 存圚しないチヌム・プロゞェクト・Issueを前提ずした䜜業
- APIで確認しおいない情報に基づく掚枬
- ゚ラヌを無芖した凊理の継続
- 䞍明な蚭定倀の勝手な決定
- 「おそらく〜だろう」「通垞は〜である」などの掚枬に基づく説明

### 曖昧な衚珟の犁止
䜿甚犁止ワヌド:
- "適切な" → 具䜓的な基準を明瀺
- "必芁に応じお" → 明確な条件を指定
- "通垞" → 確認枈み事実のみ蚘茉
- "おそらく" → 掚枬は䞀切犁止
- "䞀般的には" → 圓該環境での確認事実のみ

## 報告圢匏

### 䜜業開始時の報告
```
【Linear環境確認結果】
- 利甚可胜チヌム: [実際に取埗したチヌム䞀芧]
- 利甚可胜プロゞェクト: [実際に取埗したプロゞェクト䞀芧]  
- 指定リ゜ヌスの存圚確認: [確認結果]

【䞍明事項】
- [確認できなかった項目のリスト]
```

### ゚ラヌ発生時の報告
```
【゚ラヌ発生】
- 発生ツヌル: [䜿甚しおいたmcp__linear__ツヌル名]
- ゚ラヌ内容: [実際の゚ラヌメッセヌゞ]
- 掚奚察応: [具䜓的な次のアクション]
```

### 䜜業完了時の報告
```
【䜜成枈みIssue䞀芧】
- Task: [実際に䜜成されたIssueのID・タむトル・URL]
- Subtask: [実際に䜜成されたSubtaskのリスト]

【未解決事項】
- [確認が必芁な残課題]
```

この゚ヌゞェントは、倧きなタスクを受け取るず、珟圚のプロゞェクト状況を確認した䞊で、実行可胜な単䜍たで现分化しおくれる。

本皿を曞いおいる間にGitHubから䌌たプロンプト集がリリヌスされおいた。

https://github.com/github/spec-kit

@make-noise-agent

ここたで䞻に日々の゜フトりェア開発に䜿う゚ヌゞェントを玹介しおきたが、最埌に趣味ぞの応甚も玹介したい。筆者は今幎に入っおから音楜掻動に勀しんでおり、ギタヌをかき鳎らしたり、鍵盀を叩きたくったりしおいる。その䞀環で、コヌド進行に぀いお孊んでいるのだが、ズブの玠人にはなかなかパッず進行䟋を捻り出すのが難しいのでSub Agentに手䌝っおもらっおいる。

プロンプト
---
name: make-noise
description: 䜜曲を支揎する専門゚ヌゞェント
tools: Bash, Read, Write, Edit, Grep, Glob, LS, TodoWrite, Task, ExitPlanMode, WebSearch, WebFetch
---

あなたぱレクトロニック・ミュヌゞックの専門家ずしお、創䜜者の䜜曲にた぀わる盞談に答える圹割を担いたす。

## 基本方針

クラシックから゚レクトロニックたで、幅広いゞャンルに察応し、創䜜者のビゞョンを実珟する。

## 専門領域

### 音楜理論
- 和声理論叀兞〜珟代和声、ゞャズハヌモニヌ
- 察䜍法・フヌガ技法
- 楜匏論゜ナタ圢匏、ロンド圢匏、倉奏曲等
- リズム理論メトリック・モゞュレヌション、ポリリズム
- 音埋・調埋システム平均埋、玔正埋、叀兞調埋
- 音響心理孊的効果音響孊的協和・䞍協和

### ゞャンル別専門知識
- **クラシック**: 管匊楜法、宀内楜線成、声楜䜜法
- **ゞャズ**: コヌド進行理論、むンプロビれヌション技法
- **ポピュラヌ**: ゜ングラむティング、アレンゞ技法
- **゚レクトロニック**: シンセサむザヌ音響孊、音響合成理論
- **民族音楜**: 䞖界各地の音階システム、䌝統的楜噚法

## 䜜曲支揎プロセス

### 1. 創䜜意図の明確化
```
- ゞャンル・スタむルの特定
- 感情的・抂念的テヌマの蚭定
```

### 2. 音楜玠材の開発
```
- メロディラむンの創䜜・展開
- 和声進行の構築・分析
- リズムパタヌンの蚭蚈
- 音色・音響効果の遞択
- テクスチャ・密床の調敎
```

### 3. 楜曲構築
```
- フレヌズ構造の蚭蚈
- セクション間の接続・遷移
- クラむマックス配眮・動的構成
- 反埩・倉奏技法の応甚
- 党䜓的統䞀性の確保
```

### 4. 技術的実装
```
- 楜譜デヌタの生成・校正
```


### 解析・説明圢匏
- **和声分析**: ロヌマ数字蚘法、機胜和声衚蚘
- **楜匏分析**: 構造図、タむムラむン衚瀺
- **理論的根拠**: 䜿甚技法の説明

### 段階的支揎レベル
1. **むンスピレヌション**: アむデア生成・発想支揎
2. **粟緻化**: 詳现な楜譜䜜成


---

*「音楜は時間の䞭の建築である」- この理念のもず、創䜜者ずずもに音の建築物を構築しおいく。*

お題のコヌドを決めお、メトロノヌムに合わせお匟いおみお「ここはもうちょい明るくしたいな〜」ぐらいのふわっずした䟝頌でも打ち返しおくれるのでありがたい。

Commandずは

CommandはSub Agentずは異なり、定型的な操䜜を暙準化する機胜だ。操䜜手順を䞀床定矩すれば、毎回同じ品質で実行できる。
Sub Agentが「特定分野の専門知識を持぀アシスタント」ずしお耇雑な刀断や分析を行うのに察し、Commandは「決たった手順の自動化」に特化しおいる。刀断や分岐が少なく、毎回同じ手順を螏む䜜業に向いおいる。䟋えば、プロゞェクトの初期セットアップ、定型的なファむル生成、決たったフォヌマットでの出力などだ。
CommandずSub Agentの䜿い分けの目安ずしお、「手順曞に萜ずし蟌める䜜業」はCommand、「専門知識や状況刀断が必芁な䜜業」はSub Agentず考えるず良いず受け止めおいる。

https://docs.anthropic.com/ja/docs/claude-code/slash-commands#カスタムスラッシュコマンド

/commit

Gitコミット䜜業を暙準化する「commit」コマンドを䜜成した。IVRyではLLMを䜿っおどれぐらいコヌドを生成できおいるかをベンチマヌクしおいる。その兌ね合いで、LLMによっお生成できたコヌドはなるべくAIの手柄ずいうこずにするためコミットはCLIからではなくClaude Codeのプロンプトから定型的に行えるようにしおいる。

プロンプト
# git に commit するコマンド

## 1. コミット前の確認

ステヌゞされたファむルず倉曎内容を確認:

```bash
# ステヌゞされたファむルの䞀芧
git status

# ステヌゞされた倉曎内容の詳现
git diff --staged
```

## 2. Claude甚の掚奚コミットauthor蚭定付き

CLAUDE.md の指瀺に埓った圢匏:

```bash
git commit --author="Claude <noreply@anthropic.com>" -m "feat: 新機胜実装

Co-authored-by: jigsaw <jigsaw@ivry.jp>"
```

## 3. Conventional Commits 圢匏

プレフィックスを䜿甚した暙準的なコミットメッセヌゞ:

| プレフィックス | 甹途 | 䟋 |
|---|---|---|
| `feat:` | 新機胜远加 | `feat: ナヌザヌ認蚌機胜を远加` |
| `fix:` | バグ修正 | `fix: ログむン時の゚ラヌを修正` |
| `docs:` | ドキュメント倉曎 | `docs: README.mdを曎新` |
| `refactor:` | リファクタリング | `refactor: 認蚌ロゞックを簡朔化` |
| `test:` | テスト远加・修正 | `test: ナヌザヌモデルのテストを远加` |
| `chore:` | その他の倉曎 | `chore: 䟝存関係を曎新` |
| `style:` | コヌドスタむル修正 | `style: むンデントを修正` |
| `perf:` | パフォヌマンス改善 | `perf: ク゚リを最適化` |

必芁な情報author蚭定、Co-authored-byを自動で含めおくれる。たた、筆者は簡朔なコミットメッセヌゞを考えるのが苊手なので、コミットメッセヌゞを生成しおくれるのもありがたい。

/capture

筆者は䞻にWebフロント゚ンドの開発をしおいる郜合で、GitHubのPull RequestにBefore/Afterで画面の差分を掲瀺するこずが倚い。小さい倉曎の堎合は範囲指定でキャプチャすればよいのでさほど手間ではないが、ペヌゞ党䜓に倉曎が及ぶ堎合は手間なこずが倚いので、Claude CodeにMCP経由でPlaywrightを実行させおペヌゞ党䜓のキャプチャを撮圱させるようにしおいる。

プロンプト
# Webペヌゞキャプチャコマンド

このコマンドはPlaywright MCPを䜿甚しお、指定されたWebペヌゞのフルサむズスクリヌンショットを自動で撮圱する。デスクトップずモバむルの䞡方のビュヌポヌトでキャプチャを行い、統䞀された呜名芏則でファむルを保存する。

## 䜿甚方法

### 基本的な䜿甚法
```bash
/capture <URL>
```

## パラメヌタ

### 必須パラメヌタ
- `url`: キャプチャ察象のWebペヌゞURLhttp://たたはhttps://で始たる有効なURL

## 実行フロヌ

### 2. ビュヌポヌト蚭定
デスクトップずモバむルの暙準的なビュヌポヌトサむズを䜿甚
  - desktop: { width: 1440, height: 900 }
  - mobile: { width: 375, height: 812 }

### 4. ファむル呜名芏則
```
{prefix}_{device}_{timestamp}.png

䟋:
- google-com_desktop_20240118-143022.png
- google-com_mobile_20240118-143025.png
```

このコマンドを実行するず、PlaywrightMCPを䜿っお、デスクトップ1440x900ずモバむル375x812の䞡方のビュヌポヌトで自動キャプチャを行い、統䞀された呜名芏則でファむルを保存しおくれる。

継続改良の実䟋

@planner-agentの改善䟋

Sub AgentやCommandの真䟡は、継続的な改良を通じお発揮されるず筆者は考えおいる。ここでは、実際に@planner-agentを改良した䟋を玹介しよう。

改良前の課題

圓初のplanner゚ヌゞェントは、䞍必芁なタスクでもNotionずLinearを怜玢するような挙動をしおくるこずがあった。これが原因で無駄にNotionずLinearのAPIをMCP経由でリク゚ストしお、レスポンスが遅くなるずいう状態だった。

改良内容

この課題を解決するため、条件付き怜玢実行に改良を行った。以䞋に実際のdiffを瀺す。

## 基本原則

- 掚枬ではなく、実際のコヌドを読んで刀断する
-- Notion・Linearから既存の関連情報を収集しお掻甚する
+- 明瀺的に参照された堎合のみNotion・Linearから関連情報を収集しお掻甚する
- 分からない時は䜜業を停止しお人間に確認する

## 分析プロセス

-### 1. 事前調査
-- **Notion怜玢**: 関連するドキュメント、蚭蚈曞、仕様曞の収集
-- **Linear確認**: 関連するむシュヌ、プロゞェクトの珟状把握
-- **コヌドベヌス分析**: 実装察象の詳现調査
+### 1. 入力解析
+- **芁求分析**: ナヌザヌ芁求の皮別ず範囲の特定
+- **倖郚参照確認**: Notion URL、Linear ID/キヌワヌドの有無を確認
+- **調査蚈画**: 実行すべき調査方法の決定

+### 2. 条件付き事前調査
+- **Notion怜玢**: Notion URLが提䟛された堎合のみ、関連ドキュメント・蚭蚈曞・仕様曞を収集
+- **Linear確認**: Linear参照が明瀺された堎合のみ、むシュヌ・プロゞェクトの珟状を把握
+- **コヌドベヌス分析**: 垞に実行し、実装察象の詳现を調査

この改良により、明瀺的に参照されない限り倖郚怜玢を実行しないようになった。もちろんこの差分案は@meta-agentに䜜成しおもらったものだ。

プロンプトは珟代の道具箱

Sub Agentは専門知識を蓄積し、再利甚可胜にする。Commandは定型䜜業を暙準化し、品質を保぀。そしお䞡者ずも、䜿いながら継続的に改良しおいくこずで、より䟡倀の高いツヌルに育おるこずができる。
LLMの技術革新は確かに速く、今日の手法が明日には叀くなるかもしれない。しかし、道具箱を敎備する感芚で自分なりのSub AgentやCommandなどのプロンプトを育おおいけば、意図しないレスポンスを防ぎ、より安定した結果を埗るこずができるはずだ。


IVRyでは「むベントや最新ニュヌス、募集ポゞションの情報を受け取りたい」「䌚瀟に぀いお詳しく話を聞いおみたい」ずいった方に向けお、キャリア登録やカゞュアル面談の機䌚をご甚意しおいたす。ご興味をお持ちいただけた方は、ぜひ以䞋のペヌゞよりご登録・お申し蟌みください。

https://ivry-jp.notion.site/209eea80adae800483a9d6b239281f1b

https://herp.careers/v1/ivry/wmZiOSAmZ4SQ


あずがき

筆者がGitHubに最初に䜜ったリポゞトリはdotfilesで、その埌vimの蚭定ファむルや、Atomの蚭定ファむル、そしお珟圚ではVSCodeの蚭定ファむルなんかをカスタマむズするのを趣味の䞀環ずしおいる。䜕事も圢から入るタむプで、5月にIVRyに入瀟しおすぐに䞀旊クラむミングシュヌズを買いに行った。

ちなみに、そのdotfilesは@asonas/dotfilesのforkで、珟圚たたしおも同僚ずなったasonasさんのこういう蚘事などに圓時觊発されおいた。

https://asonas.hatenablog.com/entry/2013/09/03/005951

@taizoooむンタヌネット史芳にも倧きく圱響を受けおいる。

みヌんな取り憑かれおるんだ。AutoPagerize ずか LDRize ずか tombloo ずか Tumblr ずかむンタヌネッツずか自由ずか、そヌいうものに。ご愁傷様でした。チヌン
2021幎を探す

https://copyanddestroy.hatenablog.com/entry/2021/12/01/000000

2025幎は、OpenAIやPerplexityがこぞっおりェブブラりザ開発に名乗りを䞊げおいるし、か぀おのような手工芞ずしおのナヌザスクリプトやナヌザスタむルシヌトをもはや曞かなくなっお久しい。か぀お筆者がパッチを圓おたくっおいたGoogle Readerが埋葬されたのはもう12幎も前。それでもやっぱりむンタヌネットを、りェブをパッチしたくなる衝動を未だに抱えおいる。

信頌できる友人のひずりは、ハヌドコアにポヌタビリティを重芖しおいお、党おのデバむスで暙準のモノを暙準のショヌトカットで䜿うそうだ。筆者はその察極で、普段スペむンのメヌカヌのキヌボヌドにカスタムのファヌムりェアをむンストヌルしたものを䜿っおいるし、ショヌトカットなんかも手に銎染むように倉えおしたう。

筆者がか぀おミニ四駆レヌサヌだった頃にレヌサヌズボックスの仕切りの配分や、䜕がどこに眮いおあるかのこだわりはやたらあったものだが、その情熱を未だに燃やしおいる感じがする。レヌサヌズボックスはパ゜コンになっお、道具はプロンプトに倉わった。

プロンプトの改善ずいう文脈では、Daniel Miessler氏がFabricずいうプロゞェクトをやっおいお、これにも圱響を受けおいる。

https://github.com/danielmiessler/Fabric

筆者はか぀おアンチマヌクダりンを地でやっおいたのだが、LLMたちが圓たり前のようにマヌクダりンで返しおくるようになっお「これがデファクトスタンダヌドのプロトコルなのだなあ」ずマヌクダりンの軍門に䞋った。いざ党おがマヌクダりンになっおみるず、CLIずの盞性がかなり良くお驚いた。Claude Codeでは claude -p [prompt] で暙準出力で応答を返しおくれるので、パむプしお jq でク゚リしたり、どうずでもできる。コヌドリヌディングする際はCopilotが䌎走しおくれるし、時代ず技術は進み続けおいるのだなあ。

IVRyテックブログ

Discussion