57 lines
4.4 KiB
Markdown
57 lines
4.4 KiB
Markdown
---
|
|
title: 'LLM向けプロンプト直書きを廃止してresources/promptsへ集約する'
|
|
state: 'queued'
|
|
created_at: '2026-06-10T07:29:13Z'
|
|
updated_at: '2026-06-10T07:49:23Z'
|
|
assignee: null
|
|
queued_by: 'workspace-panel'
|
|
queued_at: '2026-06-10T07:49:23Z'
|
|
---
|
|
|
|
## 背景
|
|
|
|
この repository の設計要旨では、プロンプトはすべて `resources/prompts` に集約することになっている。管理効率・override 可能性・レビュー容易性のため、Rust code や workflow 起動処理に LLM-facing prompt 文言を直書きしてはいけない。
|
|
|
|
現在、少なくとも Ticket role launch / Intake handoff 周辺では、LLM に渡る generated launch prompt が `crates/client/src/ticket_role.rs` に直書きされている。例として `build_launch_prompt`、`TicketIntakeHandoff::append_prompt_lines`、role-specific execution guidance などが該当する。これらは UI label / notice ではなく model context に入る prompt なので、`resources/prompts` 管理へ移す必要がある。
|
|
|
|
この Ticket は Intake 文言だけでなく、LLM に渡る hardcoded prompt prose 全体を audit し、`resources/prompts` 経由に移すためのものとする。
|
|
|
|
## 要件
|
|
|
|
- LLM-facing prompt 文言を Rust code に直書きしない。
|
|
- Ticket role launch prompt の固定文言を `resources/prompts` 配下へ移す。
|
|
- `# Ticket role launch` から始まる launch context guidance。
|
|
- Ticket id / language / user instruction / handoff / intent packet / worktree / validation / report expectation の説明文。
|
|
- Intake handoff guidance。
|
|
- Orchestrator / coder / reviewer 向け role execution guidance。
|
|
- Intake workflow の本体文言は引き続き `.yoi/workflow/ticket-intake-workflow.md` を正とし、launch prompt 側には必要最小限の runtime context と参照関係だけを載せる。
|
|
- `resources/prompts` に追加する prompt resource は、用途・入力変数・出力境界が分かる単位に分割する。
|
|
- Rust 側は prompt resource を読み込み、必要な runtime 値を安全に埋め込むだけにする。
|
|
- prompt resource の読み込みは既存の prompt/resource 管理方針に合わせる。
|
|
- bundled resource として扱うべきものは compile-time embedded resource に含める。
|
|
- user override 可能性を壊さない。
|
|
- repository 内の hardcoded LLM-facing prompt prose を audit し、少なくとも既知の Ticket role launch 系はこの Ticket で解消する。
|
|
- 残す文言がある場合は、UI 表示文言・diagnostic・protocol literal など、LLM prompt ではない理由を明確にする。
|
|
- 将来の再発を防ぐため、可能なら grep しやすい境界・テスト・lint 的な確認を追加する。
|
|
|
|
## 受け入れ条件
|
|
|
|
- `crates/client/src/ticket_role.rs` から LLM-facing prompt prose の大きな直書きがなくなっている。
|
|
- Ticket role launch で LLM に渡る固定 guidance は `resources/prompts` の prompt resource から組み立てられる。
|
|
- Intake handoff の LLM-facing guidance が Rust 直書きではなく prompt resource 管理になっている。
|
|
- Orchestrator / coder / reviewer role execution guidance が Rust 直書きではなく prompt resource 管理になっている。
|
|
- runtime 値の埋め込みは prompt injection を広げない形で bounded / escaped / sectioned に維持される。
|
|
- 既存の Ticket role launch behavior は semantic に維持される。
|
|
- `resources/prompts` 側の resource 名・責務が明確で、後続の文言修正を code edit なしで行える。
|
|
- targeted tests が追加・更新され、launch prompt が resource 経由で生成されることを確認している。
|
|
- repository audit の結果が Ticket thread または implementation report に記録され、残存する hardcoded LLM-facing prose がない、または非対象理由が明示されている。
|
|
- `cargo test -p client ticket_role` または該当する targeted test が通る。
|
|
- `target/debug/yoi ticket doctor` が通る。
|
|
|
|
## 非目標
|
|
|
|
- TUI の表示ラベル、status line、notice、error diagnostic など、LLM に渡らない UI 文言を `resources/prompts` に移すこと。
|
|
- workflow markdown 本体を `resources/prompts` に移すこと。project-authored workflow は `.yoi/workflow` が正である。
|
|
- protocol literal、tool name、field name、file path、command name を翻訳・抽象化すること。
|
|
- prompt resource system 全体の大規模再設計。
|