prompt: update ticket guidance
This commit is contained in:
@@ -42,40 +42,15 @@ Orchestrator の cwd が orchestration 用ブランチ/worktree の場合、通
|
||||
|
||||
---
|
||||
|
||||
## Work item / Ticket の運用について
|
||||
## ドッグフーディング時の Ticket 境界
|
||||
|
||||
作業管理は `.yoi/tickets/` に保存される Ticket と `yoi ticket ...` コマンド / Ticket tools を正とする。時系列・状態遷移の最終的な根拠は git history なので、work item の作成・更新・レビュー・完了は Ticket 操作と commit で表現する。
|
||||
Yoi Worker で作業する場合、Ticket の authority・ライフサイクル・操作方法は Yoi
|
||||
system instructions と、その Worker に提供された typed Ticket tools に従うこと。
|
||||
backend や CLI の具体的な手順はこのリポジトリの `AGENTS.md` では重複して定義しない。
|
||||
|
||||
### 基本コマンド
|
||||
|
||||
- 新規作成: `yoi ticket create --title "..." [--priority P2]`
|
||||
- 一覧: `yoi ticket list [--state planning|ready|queued|inprogress|done|closed|all]`
|
||||
- 詳細: `yoi ticket show <ticket-id>`
|
||||
- コメント / 計画 / 判断 / 実装報告: `yoi ticket comment <ticket-id> [--role comment|plan|decision|implementation_report] [--file path]`
|
||||
- レビュー記録: `yoi ticket review <ticket-id> --approve|--request-changes [--file path]`
|
||||
- 状態変更: `yoi ticket state <ticket-id> planning|ready|queued|inprogress|done`
|
||||
- 完了: `yoi ticket close <ticket-id> [--resolution text|--file path]`
|
||||
- 整合性確認: `yoi ticket doctor`
|
||||
|
||||
`yoi ticket` は typed Ticket backend 経由で flat な `.yoi/tickets/<ticket-id>/` 配下の `item.md`、`thread.md`、`artifacts/` を扱う。Ticket identity はこのディレクトリ名である canonical ID のみで、title/slug words を含む alias や `open`/`pending`/`closed` bucket は現在の authority ではない。現在の lifecycle は frontmatter の `state` だけで表し、`done` と `closed` は区別する。完了時は同じ Ticket ディレクトリ内に `resolution.md` も作られる。手でファイルを作るより、原則として `yoi ticket` または Ticket tools を使うこと。
|
||||
|
||||
### Work item の粒度
|
||||
|
||||
- 1 work item = 完了時点で、実装が仕様または機能として説明できる粒度。
|
||||
- 作成時は背景・要件・受け入れ条件を明確にする。実装手順やコード詳細は、必要になるまで増やしすぎない。
|
||||
- チケット内の Phase / Step は実装順序であり、外部の依存関係管理として扱わない。
|
||||
- ビルドが通り、その機能に限り「まだ動作できない」と明示できている場合を除き、全体として動作可能な状態を保つ。
|
||||
|
||||
### ライフサイクル
|
||||
|
||||
- 作成: `yoi ticket create ...` で `.yoi/tickets/<ticket-id>/` を作成し、必要な前提を書いて commit する。出力された canonical ID を以後の操作に使う。
|
||||
- 詳細化・前提変更: `item.md` を更新し、必要に応じて `yoi ticket comment` で `thread.md` に経緯を残して commit する。
|
||||
- レビュー: `yoi ticket review <ticket-id> --approve|--request-changes` で `thread.md` にレビュー結果を追記して commit する。
|
||||
- 完了: `yoi ticket close <ticket-id>` で `state: closed` と `resolution.md` を同じ flat Ticket ディレクトリに記録して commit する。
|
||||
|
||||
worktree と併用して作業を進める場合、必ずブランチを切る前に対象 work item を作成・詳細化して commit してから切ること。
|
||||
|
||||
レビューは diff の確認だけでなく、work item の前提・要件・受け入れ条件が提出された実装で満たされているかを確認する。常に、その実装で良いのか、コードベースを歪めていないか、不必要な実装ではないかを確認すること。
|
||||
Codex など typed Ticket tools が提供されていないクライアントでは、`yoi ticket`
|
||||
CLI や保存先の直接操作で Ticket tools を代替しないこと。Ticket の作成・更新は
|
||||
Yoi Worker に委ねる。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user