@infodb/p3 0.0.0-stage → 0.1.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/LICENSE +21 -0
- package/README.md +56 -2
- package/bin/p3.mjs +18 -0
- package/dist/web/apple-touch-icon.png +0 -0
- package/dist/web/assets/Outputs-Ni3pNuGU.js +1 -0
- package/dist/web/assets/RequestStatus-K8TZwpur.js +1 -0
- package/dist/web/assets/TagInput-BICKVH2x.js +1 -0
- package/dist/web/assets/TaskDrawer-BkDIstIN.js +3 -0
- package/dist/web/assets/_requestId-B5O_ytaq.js +1 -0
- package/dist/web/assets/_requestId-C66puEMO.js +30 -0
- package/dist/web/assets/action-CMjATXqv.js +1 -0
- package/dist/web/assets/board-CbfDjkls.js +1 -0
- package/dist/web/assets/copy-B1ZbihKL.js +2 -0
- package/dist/web/assets/done-CPQbCFHg.js +1 -0
- package/dist/web/assets/draft-dT3gLDIt.js +1 -0
- package/dist/web/assets/format-DuK6P1hb.js +1 -0
- package/dist/web/assets/index-BUcs2J6N.js +12 -0
- package/dist/web/assets/index-C3DkqwJ9.css +2 -0
- package/dist/web/assets/link-_s8ndNKS.js +1 -0
- package/dist/web/assets/new-T60RB7de.js +1 -0
- package/dist/web/assets/preload-helper-dXqN7N-I.js +1 -0
- package/dist/web/assets/release-notes-DxrPhDbt.js +3 -0
- package/dist/web/assets/requestData-D8ZiSZss.js +1 -0
- package/dist/web/assets/rolldown-runtime-hePW80VL.js +1 -0
- package/dist/web/assets/routes-D9ZxXoLk.js +2 -0
- package/dist/web/assets/search-CJ8MBKTz.js +1 -0
- package/dist/web/assets/settings-DsHVyqzJ.js +1 -0
- package/dist/web/assets/supersede-CLXlhCq0.js +1 -0
- package/dist/web/assets/ui-Cvke4y4X.js +1 -0
- package/dist/web/favicon.ico +0 -0
- package/dist/web/favicon.svg +12 -0
- package/dist/web/index.html +23 -0
- package/docs/architecture.md +588 -0
- package/docs/chatgpt-sign-in.md +163 -0
- package/docs/development.md +194 -0
- package/docs/how-to-use.md +524 -0
- package/docs/installation.md +275 -0
- package/docs/publishing.md +65 -0
- package/package.json +86 -3
- package/skills/p3/SKILL.md +95 -0
- package/src/cli/args.ts +179 -0
- package/src/cli/chatgpt.ts +74 -0
- package/src/cli/codex.ts +28 -0
- package/src/cli/format.ts +9 -0
- package/src/cli/help.ts +99 -0
- package/src/cli/main.ts +267 -0
- package/src/cli/output.ts +99 -0
- package/src/cli/preflightCommands.ts +237 -0
- package/src/cli/project.ts +501 -0
- package/src/cli/readOnly.ts +36 -0
- package/src/cli/releaseNotesCommands.ts +139 -0
- package/src/cli/render.ts +60 -0
- package/src/cli/requestCommands.ts +170 -0
- package/src/cli/showView.ts +110 -0
- package/src/cli/taskCommands.ts +167 -0
- package/src/cli/userConfig.ts +58 -0
- package/src/core/chatgpt.ts +33 -0
- package/src/core/context.ts +57 -0
- package/src/core/machineSettings.ts +207 -0
- package/src/core/machineSettingsEdit.ts +156 -0
- package/src/core/ops.ts +114 -0
- package/src/core/preflight/carryover.ts +133 -0
- package/src/core/preflight/codexEngine.ts +702 -0
- package/src/core/preflight/codexImage.ts +98 -0
- package/src/core/preflight/diagnose.ts +124 -0
- package/src/core/preflight/engine.ts +92 -0
- package/src/core/preflight/input.ts +65 -0
- package/src/core/preflight/launch.ts +86 -0
- package/src/core/preflight/launcher.mjs +75 -0
- package/src/core/preflight/mock-ui.html +24 -0
- package/src/core/preflight/mock-ui.png +0 -0
- package/src/core/preflight/mockEngine.ts +145 -0
- package/src/core/preflight/render-image/Dockerfile +23 -0
- package/src/core/preflight/render-image/render.mjs +53 -0
- package/src/core/preflight/render.ts +336 -0
- package/src/core/preflight/service.ts +690 -0
- package/src/core/preflight/uiMaterials.ts +272 -0
- package/src/core/preflight/uiRender.ts +84 -0
- package/src/core/preflight/wireframe.ts +69 -0
- package/src/core/preflight/xlsx.ts +328 -0
- package/src/core/redact.ts +31 -0
- package/src/core/releaseNotes/generate.ts +271 -0
- package/src/core/releaseNotes/material.ts +114 -0
- package/src/core/releaseNotes/mockSummarizer.ts +28 -0
- package/src/core/releaseNotes/service.ts +106 -0
- package/src/core/releaseNotes/store.ts +216 -0
- package/src/core/repoAdmin.ts +81 -0
- package/src/core/repoRefs.ts +90 -0
- package/src/core/requestOps.ts +140 -0
- package/src/core/requestStatus.ts +58 -0
- package/src/core/store/attachments.ts +228 -0
- package/src/core/store/collection.ts +282 -0
- package/src/core/store/frontmatter.ts +22 -0
- package/src/core/store/fsutil.ts +90 -0
- package/src/core/store/locate.ts +181 -0
- package/src/core/store/normalize.ts +155 -0
- package/src/core/store/noteStore.ts +56 -0
- package/src/core/store/preflightStore.ts +136 -0
- package/src/core/store/projectFile.ts +101 -0
- package/src/core/store/workspace.ts +328 -0
- package/src/core/supersede.ts +74 -0
- package/src/core/userConfig.ts +180 -0
- package/src/core/userTheme.ts +22 -0
- package/src/core/workTargets.ts +120 -0
- package/src/server/api/chatgptRoutes.ts +48 -0
- package/src/server/api/local.ts +33 -0
- package/src/server/api/manifest.ts +119 -0
- package/src/server/api/releaseNoteRoutes.ts +78 -0
- package/src/server/api/repoRoutes.ts +67 -0
- package/src/server/api/routes.ts +374 -0
- package/src/server/api/userThemeRoutes.ts +62 -0
- package/src/server/server.ts +49 -0
- package/src/shared/dates.ts +12 -0
- package/src/shared/preflightInput.ts +27 -0
- package/src/shared/refs.ts +55 -0
- package/src/shared/repos.ts +113 -0
- package/src/shared/scopeView.ts +48 -0
- package/src/shared/tags.ts +27 -0
- package/src/shared/types.ts +700 -0
- package/src/shared/workTarget.ts +44 -0
|
@@ -0,0 +1,524 @@
|
|
|
1
|
+
# 使い方ガイド
|
|
2
|
+
|
|
3
|
+
P3 で要望を1件、作るところから人が確認して閉じるところまで進める手順と、その後に引くためのリファレンス。
|
|
4
|
+
導入(Docker・ChatGPT の接続・パスの対応)が済んでいる前提で書く。まだなら [導入ガイド](installation.md) から。
|
|
5
|
+
|
|
6
|
+
- 前半「1件の要望を最後まで」: 同じ例の要望で、順に手を動かす
|
|
7
|
+
- 後半「リファレンス」: 状態・データ・画面・CLI の決まり
|
|
8
|
+
|
|
9
|
+
例に出てくる要望 ID(`261009-k7m3x`)・URL・ファイル名は架空のもの。自分の環境で出たものに置き換える。
|
|
10
|
+
|
|
11
|
+
## 役割と言葉
|
|
12
|
+
|
|
13
|
+
P3 では、人と AI エージェント(Claude Code・Codex など)が同じ CLI を使い、役割を分ける。
|
|
14
|
+
|
|
15
|
+
| すること | 誰が |
|
|
16
|
+
| --- | --- |
|
|
17
|
+
| 要望を書く | 人(AI も書ける) |
|
|
18
|
+
| Preflight(評価・細分化)を実行し、タスク案を選んでタスク化する | **人** |
|
|
19
|
+
| タスクに着手し、作業し、成果物と変更の記録を残して完了にする | AI(人でもよい) |
|
|
20
|
+
| 要望のタスクを全部終えたら、要望を「対応済」にする | 作業した側(AI など) |
|
|
21
|
+
| 成果物を確かめてタスクを「済み」にし、要望を「完了済」(か「見送り」)にする | **人** |
|
|
22
|
+
|
|
23
|
+
似た言葉を取り違えないように:
|
|
24
|
+
|
|
25
|
+
| 言葉 | 何の | 意味 |
|
|
26
|
+
| --- | --- | --- |
|
|
27
|
+
| 完了(`done`) | タスク | 作業した側が終えた(成果物がある) |
|
|
28
|
+
| 済み(`checkedAt`) | タスク | 人が成果物を確かめた。タスクボードから消え、「対応済み」の一覧に移る |
|
|
29
|
+
| 対応済(`resolved`) | 要望 | 作業した側が全タスクを終えた。人の確認待ち |
|
|
30
|
+
| 完了済(`done`) | 要望 | 人が確かめて閉じた |
|
|
31
|
+
|
|
32
|
+
## 1件の要望を最後まで
|
|
33
|
+
|
|
34
|
+
### 1. 要望を書く
|
|
35
|
+
|
|
36
|
+
CLI では(本文の箇条書きは、Preflight がタスク案を作るときの手がかりになる):
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
p3 request new "通知機能を追加したい" --body "- メール送信基盤
|
|
40
|
+
- 通知設定画面"
|
|
41
|
+
# 作成: 261009-k7m3x 通知機能を追加したい
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
画面では、ヘッダーの「新しい要望」から書く。要望 ID は「作成日-乱数」で、後ろの5文字(`k7m3x`)だけでも指せる。
|
|
45
|
+
|
|
46
|
+
今の画面のスクリーンショットや仕様書の Excel があれば添付する(Preflight に渡す。後の「添付と画面資料」):
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
p3 attach add 今の画面.png --description "今の一覧" --req k7m3x
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
### 2. Preflight を実行する
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
p3 preflight k7m3x # Codex がリポジトリと過去の経緯を調べて評価し、タスク案を書く(終わるまで待つ)
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
画面では、要望の概要の「▶ Preflight を実行」。実行ログが流れ、終わると評価とタスク案が出る。
|
|
59
|
+
|
|
60
|
+
CLI など画面の外で Preflight を実行したときは、開いている要望の「概要・Preflight」が3秒ごとに最新の Preflight を確かめ、
|
|
61
|
+
実行ボタンの下に「新しい Preflight があります」(run の ID と、実行中・評価済み・失敗)を出す(再読み込みは要らない)。
|
|
62
|
+
表示中の評価・入力中のタイトル・本文・メモ・開いているタスク案の詳細はそのままで、「新しい run を開く」を押したときだけ
|
|
63
|
+
切り替わる(履歴の選択で選んでもよい)。`?run=` で前の run を開いているときは「表示中の評価は最新ではありません」。
|
|
64
|
+
確かめるのはこの画面を開いて、タブが見えている間だけ。確かめられなかったときは知らせと「もう一度確かめる」が出る
|
|
65
|
+
数分かかることがある。要望は「評価中」→「開始前」になる。
|
|
66
|
+
|
|
67
|
+
### 3. 評価とタスク案を読む
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
p3 drafts k7m3x # 評価(判定・妥当性・実現可能性・リスク・確認事項)、調べた範囲、判断の根拠、タスク案(D1, D2 ...)
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
画面では評価の下に、画面資料(UI を伴う案の画面イメージ)、メモ欄、調べた範囲・判断の根拠、タスク案が並ぶ。
|
|
74
|
+
|
|
75
|
+
- **判定**: go(着手できる)/ clarify(確認が要る)/ no_go(勧めない)
|
|
76
|
+
- **調べた範囲**: どのリポジトリ(参照先)を読めたか、git の履歴が使えたか。見ていない参照先に関わる判断は推測
|
|
77
|
+
- **判断の根拠**: 「確かめた」(読んだファイル・箇所・コミット)と「推測」を分けて出す
|
|
78
|
+
- **タスク案**: 1つの成果物(PR など)で終わる粒度。依存(← D1)と作業先のリポジトリが付く。案のファイル
|
|
79
|
+
(`preflight/<run>/drafts/D1.md`)を直接直してもよい。画面でも題・作業先・採否を直せる。本文(作業内容・完了条件・
|
|
80
|
+
判断の根拠・未確認)は、カードの「内容を見る」で開く詳細に、整形した Markdown で全文出る(読むだけ。見出し・箇条書き・
|
|
81
|
+
コード・表・チェックリスト)。Escape か「閉じる」で一覧に戻る。不採用の案・タスク化した後・前の run の案も読める
|
|
82
|
+
- **題の直し方(画面)**: カードの題は、欄から離れると保存する(変えていなければ送らない)。ファイルや CLI など外で題が
|
|
83
|
+
変わったら、再読み込み・タブに戻ったときに取り込む。直していない欄はそのまま最新になり、直している途中なら入力は残して
|
|
84
|
+
「編集中に題が他で変わりました」と外の最新の題を出す。そのあいだは欄から離れても保存せず、「入力を捨てて最新にする」で
|
|
85
|
+
最新から直し直す。画面が取り込む前に外で変わっていたときも、保存は断られて同じ知らせが出る(外の題は上書きしない)。
|
|
86
|
+
保存していない題・保存中の題・競合中の題がある間はタスク化できない(見えている題と違う題でタスクを作らない)。
|
|
87
|
+
タスク化した後の題は最新を出したまま直せない
|
|
88
|
+
|
|
89
|
+
### 4. 確認事項に答えて再評価する
|
|
90
|
+
|
|
91
|
+
確認事項に答えたいとき・方針を変えたいときは、**メモ** を書いて再評価する。前回の評価・案(人の直しと採否を含む)とメモが
|
|
92
|
+
資料として渡る。
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
p3 preflight k7m3x --note "対象は CLI だけ。Web は不要" # メモを書いてから再評価
|
|
96
|
+
p3 preflight k7m3x --note - --note-only < answer.md # メモを書くだけ(次の Preflight に渡す)
|
|
97
|
+
p3 notes k7m3x # メモの一覧と、次に渡すもの
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
画面では評価の下のメモ欄に書いて「保存して再実行」。要望の本文そのものを直してもよい(後の「要望の本文を変えたとき」)。
|
|
101
|
+
|
|
102
|
+
### 5. 案を選んでタスクにする
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
p3 accept k7m3x --skip D3 # D3 以外をタスクにする(--only D1,D2 で選ぶこともできる)
|
|
106
|
+
# タスク化 (261009-k7m3x / PF-...):
|
|
107
|
+
# T001 メール送信基盤
|
|
108
|
+
# T002 通知設定画面 ← T001
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
画面では、案のチェックで採否を決めて「n 件をタスク化」。
|
|
112
|
+
|
|
113
|
+
- タスクは要望の中で連番(T001, T002, ...)になり、案の依存(`depends_on`)が付く
|
|
114
|
+
- 要望は「進行中」になり、作業先のリポジトリごとに **ブランチ名** が割り当てられる(例 `req/261009-k7m3x-notify`)。
|
|
115
|
+
P3 は名前を決めるだけで、git のブランチや作業ツリーは作業する人・AI が作る。名前は `p3 request show k7m3x --brief` で見る
|
|
116
|
+
- 再評価で古いタスクを置き換える案があれば、置き換えられるタスクが出る。アーカイブするかは選べる(既定は残す。
|
|
117
|
+
`--archive-superseded` か画面のチェック)
|
|
118
|
+
|
|
119
|
+
### 6. 作業する(主に AI)
|
|
120
|
+
|
|
121
|
+
割り当てられたブランチ(作業ツリーでもよい)で作業する。**そのブランチの中で CLI を使うと、その要望が「今の要望」になり**、
|
|
122
|
+
`--req` を省ける。状態は常にデータのフォルダに書かれるので、ブランチごとに分かれない。
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
git switch -c req/261009-k7m3x-notify # request show で見た実際の名前を使う。git worktree でもよい
|
|
126
|
+
export P3_ACTOR=ai:claude # 変更者の記録(AI は ai:<名前>)
|
|
127
|
+
p3 show T001 --brief --json # 本文・依存とその状態・作業先とブランチ・置き換えの注意
|
|
128
|
+
p3 move T001 doing # 着手
|
|
129
|
+
# ... 作業し、テストを通し、コミットして push する ...
|
|
130
|
+
p3 move T001 done --output https://github.com/me/myapp/pull/42 --record - < record.md
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
- 依存の相手が終わっていないタスクや、置き換えられたタスク(`※置換`)からは始めない
|
|
134
|
+
- **変更の記録**(`--record`)は、何を変えたか・なぜ・入れた決まり・やめたものを Markdown で短く書く。AI が完了にするときは必須。
|
|
135
|
+
後の Preflight が経緯を調べるとき、タスクの解析・リリースノートの材料になる
|
|
136
|
+
- 作業中に見つかった別の作業は `p3 new "<題>" --body "..."` でタスクにする(人への質問はタスクにしない。チャットで聞く)
|
|
137
|
+
|
|
138
|
+
### 7. 要望を対応済にする
|
|
139
|
+
|
|
140
|
+
全タスクを完了にしたら、作業した側が要望を **対応済** にする(人に確認を頼む印)。
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
p3 request set k7m3x status=resolved
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
完了していないタスクがあると断られる(終わらせるか、不要なら人の了承を得てアーカイブする)。
|
|
147
|
+
|
|
148
|
+
### 8. 人が確認して閉じる
|
|
149
|
+
|
|
150
|
+
成果物(PR)を確かめ、マージする。
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
p3 check T001 --req k7m3x # タスクを「済み」にする(--off で外す)
|
|
154
|
+
p3 request set k7m3x status=done # 要望を完了済にする(見送るなら rejected)
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
画面では、タスクボードの完了のカードの「✓ 済み」と、要望の概要のステータス。対応済の要望は、進捗の「確認待ち」で一覧できる。
|
|
158
|
+
|
|
159
|
+
## リファレンス
|
|
160
|
+
|
|
161
|
+
### プロジェクトと今の要望
|
|
162
|
+
|
|
163
|
+
**操作するプロジェクト** は、今いる場所と個人設定から決まる(環境変数では決めない)。上から順に見て、最初に当たったもの。
|
|
164
|
+
どれで決まったかは `p3 whoami` の「決まり方」(`--json` の `via`)に出る。
|
|
165
|
+
|
|
166
|
+
| 順 | `via` | 決まり方 |
|
|
167
|
+
| --- | --- | --- |
|
|
168
|
+
| 1 | `dir` | `--dir <データのフォルダ>` を付けた |
|
|
169
|
+
| 2 | `project` | `--project <名前>` を付けた |
|
|
170
|
+
| 3 | `cwd` | 登録した参照先(サブフォルダ・その git の作業ツリーを含む)か、データのフォルダの中 |
|
|
171
|
+
| 4 | `legacy` | リポジトリの中の `.p3/`(以前の置き方) |
|
|
172
|
+
| 5 | `only` | 登録が1つだけなので、どこからでもそれ(今いる場所とは関係なく決まる) |
|
|
173
|
+
|
|
174
|
+
決まらなければ、登録済みのプロジェクトと選び方を出す。AI 向けの指示では、`via` が `cwd` でなければ操作を止めて人に確かめる。
|
|
175
|
+
|
|
176
|
+
`only`(登録が1つだけ)は p3 を使わないフォルダでも当たるので、そのときは **読むだけ** にする。変える操作は何も読み書きする前に
|
|
177
|
+
止まり(終了コード 1)、`--project <名前>` での明示と、リポジトリ・データのフォルダの中に移る方法を案内する。読むだけの操作は
|
|
178
|
+
標準エラーに同じ案内の警告を出して続ける(`--json` の標準出力には混ぜない)。
|
|
179
|
+
|
|
180
|
+
| 登録が1つだけで決まったとき | コマンド |
|
|
181
|
+
| --- | --- |
|
|
182
|
+
| 警告して続ける | `whoami`・`progress`・`ls`・`show`・`find`・`notes`・`drafts`、`request ls / show`、`milestone`(一覧)、`config`(表示)、`repo`(一覧)、`attach`(一覧)、`release-notes ls / show / export` |
|
|
183
|
+
| 止まる | 上のほか全部。要望・タスク・マイルストーン・設定・参照先の変更、`preflight`(`--note-only` も)、`accept`、`attach add / get / rm`(`get` はファイルを書く)、`release-notes generate / save`(`generate` は保存しなくても生成を始める)、`serve`(画面から変えられる) |
|
|
184
|
+
|
|
185
|
+
`init`・`project`・`user-config`・`chatgpt`・`codex`・`render` はプロジェクトを選ばないので対象外。
|
|
186
|
+
|
|
187
|
+
決まったプロジェクトの **データのフォルダと `project.yaml` が無い** と、CLI のどのコマンドも `serve` も、空のプロジェクトとして
|
|
188
|
+
開かずに終了コード 1 で止まる(何も作らない。`--json` でも空の結果は返さず、案内は標準エラーに出る)。フォルダの移動・共有ドライブの
|
|
189
|
+
切断・パスの誤りで、別の場所に書いてしまわないため。`requests/` は無くてよい。直し方は
|
|
190
|
+
[導入ガイド](installation.md#うまくいかないとき) の「うまくいかないとき」。
|
|
191
|
+
|
|
192
|
+
`p3 project` で一覧、`p3 project add <名前> <フォルダ>` で init せずに登録、`p3 project rm <名前>` で登録を外す(データは消さない)。
|
|
193
|
+
|
|
194
|
+
**今の要望** は `--req <要望>` → 環境変数 `P3_REQUEST` → 今いる参照先に割り当てたブランチ → ブランチ名の要望 ID の順で決まる
|
|
195
|
+
(パスに要望 ID が入っているだけでは決めない。detached HEAD では決めない)。`p3 whoami` で今の判定を見る。
|
|
196
|
+
|
|
197
|
+
**変更者** は `--actor` → `P3_ACTOR` → `human:<git の user.name>` の順。AI は `ai:<名前>` を名乗る。
|
|
198
|
+
|
|
199
|
+
### プロジェクトの設定
|
|
200
|
+
|
|
201
|
+
`p3 config`、画面の「設定」→「プロジェクトの基本」、`project.yaml` の直接編集のどれでも変えられる(コメントは残る)。
|
|
202
|
+
|
|
203
|
+
| 設定 | 使われ方 |
|
|
204
|
+
| --- | --- |
|
|
205
|
+
| `name` / `description` | 画面の表示と、Preflight の前提(説明が空だと画面に警告を出す) |
|
|
206
|
+
| `instructions`(`preflight.instructions`) | プロジェクト固有の評価の観点・制約。Codex への指示に加わる |
|
|
207
|
+
| `branchPattern` | 要望のブランチ名(既定 `req/{id}-{slug}`。作業先のリポジトリごとに同じ名前で割り当てる) |
|
|
208
|
+
|
|
209
|
+
マイルストーンは `p3 milestone add|set|rm`、参照先は下の「参照先と作業先」。
|
|
210
|
+
|
|
211
|
+
### 参照先と作業先
|
|
212
|
+
|
|
213
|
+
**参照先** は Preflight の Codex が読むリポジトリ・フォルダで、数と名前は自由。`p3 init` が本体を登録する。ドキュメント・基盤・
|
|
214
|
+
依存しているライブラリなど、ほかのリポジトリも読ませたいときに足す。
|
|
215
|
+
|
|
216
|
+
- 共有の定義(`project.yaml` の `repos`): 名前・役割・最初に読むか(`readFirst`)・作業先にできるか(`writable`)・主なフォルダ(`map`)
|
|
217
|
+
- このマシンのパス(個人設定): 人によって違うので共有しない
|
|
218
|
+
|
|
219
|
+
```bash
|
|
220
|
+
p3 repo add docs /workspaces/docsrepo/guide role=ドキュメント # リポジトリの中のサブフォルダでもよい
|
|
221
|
+
p3 repo add infra /workspaces/infrarepo role=基盤 writable=true
|
|
222
|
+
p3 repo ls # このマシンのパスが無いものは「未登録」
|
|
223
|
+
p3 repo path docs ~/src/docsrepo/guide # ほかの人が足した参照先に、自分のマシンのパスだけを登録する
|
|
224
|
+
p3 repo set infra role=基盤(Terraform) # 共有の定義を変える
|
|
225
|
+
p3 repo rm infra --local # このマシンのパスだけ外す(rm だけなら共有の定義ごと消す。フォルダは消さない)
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
```yaml
|
|
229
|
+
# project.yaml(共有)
|
|
230
|
+
repos:
|
|
231
|
+
app:
|
|
232
|
+
role: システム本体
|
|
233
|
+
readFirst: true
|
|
234
|
+
writable: true
|
|
235
|
+
map: # 主なフォルダ: どこから読むかの案内(全部を読む指示ではない)
|
|
236
|
+
src/server: API とデータ
|
|
237
|
+
src/web: { role: 画面, entry: src/web/main.tsx } # 入口: そのフォルダで最初に読むファイル
|
|
238
|
+
infra: { role: 基盤 }
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
- 「最初に読む」参照先の主なフォルダは、Preflight が評価の前に必要な範囲で読む(方針・設計・README など)
|
|
242
|
+
- 設定画面の「参照先」のタブでも同じことができる。このマシンのパスは、P3 を動かしているマシンのローカルの画面でだけ見え、変えられる
|
|
243
|
+
- Codex のコンテナでは、読める参照先を `/workspace/<名前>` に **読むだけで** マウントする。git の履歴が使えるのは、参照先が
|
|
244
|
+
リポジトリの最上位のメインのチェックアウトのとき(git の作業ツリー・リポジトリの中のサブフォルダでは使えない)
|
|
245
|
+
|
|
246
|
+
**作業先**(タスクの `repo`)は、作業するリポジトリ(`writable` の参照先)か `none`(調査・人の判断など)。1つのタスクの作業先は1つ。
|
|
247
|
+
タスク化で、採用した案の作業先の分だけブランチ名を割り当てる。
|
|
248
|
+
|
|
249
|
+
```bash
|
|
250
|
+
p3 new "基盤の設定" --req <要望> --repo infra # 作業先(none で作業先なし)。足りないブランチは割り当てる
|
|
251
|
+
p3 set T004 --req <要望> repo=app # 作業先を変える
|
|
252
|
+
p3 ls --req <要望> --repo infra # 作業先で絞る
|
|
253
|
+
p3 move T005 done --repo-output app=https://…/pull/1 --repo-output infra=https://…/pull/2 # 全部の PR を最後のタスクに
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
`areas` と根拠の参照は `<参照先>:<パス>`(例 `docs:guide/`)で書ける。名前なしは先頭の参照先の中のパス。
|
|
257
|
+
|
|
258
|
+
### 要望の本文を変えたとき
|
|
259
|
+
|
|
260
|
+
要望のタイトル・本文は、いつでも書き換えられる(画面の「本文を編集」→「本文を保存」、CLI の `request set`)。
|
|
261
|
+
|
|
262
|
+
```bash
|
|
263
|
+
p3 request show k7m3x --brief --json # rev を見る
|
|
264
|
+
p3 request set k7m3x --body - --rev 3 < body.md # rev で楽観ロック(ほかで変わっていれば競合)
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
Preflight は始めたときの内容を固定して評価する。**評価のあとでタイトル・本文を変えると、その評価からはタスク化できない**ので、
|
|
268
|
+
もう一度 Preflight を実行する(前回の結果とメモは引き継がれ、変わった点も渡る)。タグ・期限・ステータスだけの変更は関係ない。
|
|
269
|
+
元の内容に戻せば、その評価からタスク化できる。既存のタスク・成果物は、本文を変えても消えない。
|
|
270
|
+
|
|
271
|
+
### 状態
|
|
272
|
+
|
|
273
|
+
**タスク** は 未着手(`todo`)/ 作業中(`doing`)/ 完了(`done`)の3つだけ。保留や取りやめの状態は持たず、手を付けないなら未着手の
|
|
274
|
+
まま、マージしないなら完了のまま(成果物の側で閉じる)。作業中にした・完了にした日時は P3 が記録する。予定の日付や見積りは持たない。
|
|
275
|
+
|
|
276
|
+
**要望**:
|
|
277
|
+
|
|
278
|
+
| 値 | 表示 | 誰が・いつ |
|
|
279
|
+
| --- | --- | --- |
|
|
280
|
+
| `draft` | 下書き | 作ったとき |
|
|
281
|
+
| `preflight` / `reviewed` | 評価中 / 開始前 | Preflight の実行中 / 評価が済みタスク化の前(自動) |
|
|
282
|
+
| `active` | 進行中 | タスク化したとき(自動)。対応済の要望に未完了のタスクができたときも戻る |
|
|
283
|
+
| `resolved` | 対応済 | 作業した側が全タスクを終えたら |
|
|
284
|
+
| `done` / `rejected` | 完了済 / 見送り | 人が決める |
|
|
285
|
+
|
|
286
|
+
- 対応済にできるのは、タスクが1件以上あり全部が完了のときだけ(人の「済み」や PR のマージは条件にしない)
|
|
287
|
+
- 対応済の要望にタスクを足した・完了から戻した・再評価をタスク化したときは、進行中に戻る
|
|
288
|
+
- Preflight で状態が動くのはタスク化の前の要望だけ。進行中・完了の要望を再評価しても状態は変わらない
|
|
289
|
+
|
|
290
|
+
### タスクの関係と置き換え
|
|
291
|
+
|
|
292
|
+
関係は同じ要望の中の2つだけで、どちらも Preflight のタスク化が張る(手では張らない)。
|
|
293
|
+
|
|
294
|
+
| 種類 | 意味(A → B) | A に出る | B に出る |
|
|
295
|
+
| --- | --- | --- | --- |
|
|
296
|
+
| `depends_on` | A は B が先に終わっている必要がある | 依存先 B | 依存元 A |
|
|
297
|
+
| `supersedes` | A は B を置き換える(B は古い案) | 旧案 B | 新案 A |
|
|
298
|
+
|
|
299
|
+
置き換えられて残したタスクには、一覧(`※置換`)・ボードのカード・詳細に印が付き、作業中にすると警告が出る(移動はする)。
|
|
300
|
+
不要ならアーカイブする(`p3 archive T001`)。過去の経緯や別の要望とのつながりは、関係ではなく git の履歴と過去の要望・タスクの
|
|
301
|
+
ファイルから調べる。
|
|
302
|
+
|
|
303
|
+
### 成果物と変更の記録
|
|
304
|
+
|
|
305
|
+
- **成果物**(`outputs`): 1項目ずつ、PR / MR の URL・文章・ドキュメントのパスのどれでもよい。項目全体が `http(s)://` の URL なら
|
|
306
|
+
画面でリンクになる(文章の中の URL は拾わない)。足すのは `move <T> done --output 値`(繰り返し可。カンマで分けない)か画面の
|
|
307
|
+
「成果物を編集」。`set <T> outputs=a,b` はカンマで分けて置き換える
|
|
308
|
+
- **リポジトリごとの成果物**(`repoOutputs`): `--repo-output <参照先>=<URL>`。複数のリポジトリにまたがるときに最後のタスクに残す
|
|
309
|
+
- **変更の記録**(`record`): 何を変えたか・なぜ・入れた決まり・やめたもの(Markdown)。`move <T> done --record 本文|-`、後から直すなら
|
|
310
|
+
`set <T> --record ...`、画面のタスク詳細。`P3_ACTOR=ai:...` で完了にするときは必須(人は無くてもよい)
|
|
311
|
+
|
|
312
|
+
### タグ・期限・マイルストーン
|
|
313
|
+
|
|
314
|
+
- **期限**(`due`): 要望の期限(`--due YYYY-MM-DD`)。進捗のスケジュールに ⚑ で出る
|
|
315
|
+
- **マイルストーン**: まとめてリリースする単位(`p3 milestone add v0.2 --title "通知まわり" --due 2026-11-30`、要望に `--milestone v0.2`)。
|
|
316
|
+
リリースノートはマイルストーンごとに作る([リリースノート](#リリースノート))
|
|
317
|
+
- **タグ**(`tags`): 外部 ID や分類の自由な文字列(例 `jira:PROJ-123`、`group:顧客A`)。同じ値を複数の要望に付けてグループにできる。
|
|
318
|
+
要望・タスクの参照の代わりにはせず、外部のシステムとは同期しない
|
|
319
|
+
- CLI: `request new --tag 値`(繰り返し可。カンマで分けない)、`request set <要望> --tag 値 ...`(この並びに置き換える)、
|
|
320
|
+
`request set <要望> tags=a,b`(カンマで分ける)、`tags=` で全部外す、`request ls --tag 値`(どれかが付いている要望)
|
|
321
|
+
- 画面: 値ごとに Enter で足し、× で外す(すぐ保存)。前後の空白は除き、同じ値は1つにまとめる。カンマ・空白・記号・日本語はそのまま
|
|
322
|
+
- 進捗の絞り込み: 「タグ」から複数選ぶと、どれかが付いている要望(状態の絞り込みとは「かつ」)。URL は `?tags=`(JSON の配列)
|
|
323
|
+
|
|
324
|
+
### リリースノート
|
|
325
|
+
|
|
326
|
+
マイルストーンごとに1件、そのマイルストーンに属する要望のタスクの **変更の記録** から機能の要約をまとめる。
|
|
327
|
+
生成した案は保存されず、人が確かめて直してから保存する。保存しても要望・タスク・マイルストーンの状態は変わらない。
|
|
328
|
+
|
|
329
|
+
```bash
|
|
330
|
+
p3 release-notes # マイルストーンごとのノートの有無と要望の数
|
|
331
|
+
p3 release-notes show v0.2 # 対象の要望(収録 / 対象外)と警告、保存したノートと版
|
|
332
|
+
p3 release-notes generate v0.2 > draft.md # 機能の要約の案(stdout は本文の案だけ。出典・材料の hash・進み具合は stderr)
|
|
333
|
+
# draft.md を確かめて直す
|
|
334
|
+
p3 release-notes save v0.2 --file draft.md --based-on <材料の hash> # 新しく保存(--body 本文|- でもよい)
|
|
335
|
+
p3 release-notes show v0.2 --json # 版(note.version)を見る
|
|
336
|
+
p3 release-notes save v0.2 --file draft.md --version <版> # 直して保存し直す(版が違えば競合)
|
|
337
|
+
p3 release-notes export v0.2 > RELEASE.md # 公開する本文だけ(出典は出さない)
|
|
338
|
+
```
|
|
339
|
+
|
|
340
|
+
- **収録する要望**: 対応済か完了済で、タスクが1件以上あり、全部が完了のもの。見送りは対象外(理由だけ)、それ以外の状態は
|
|
341
|
+
**未完了** として警告して対象外。対応済・完了済でも完了していないタスクや読めないタスクがあれば、警告して対象外にする
|
|
342
|
+
- **要約の材料**: 収録する要望の、変更の記録のある完了したタスクだけ。記録の無いタスクは警告し、要望やタスクの本文で補わない。
|
|
343
|
+
材料が1つも無ければ生成はせず(Codex を呼ばない)、本文を手で書いて保存する
|
|
344
|
+
- **生成**: Preflight と同じ Codex の接続(ChatGPT プラン)で頼む。渡すのはマイルストーンのタイトルと、要望・タスクの ID・タイトル・
|
|
345
|
+
変更の記録だけ。結果の出典(要望・タスク)は P3 が確かめ、内部のパスらしいものは警告する。Ctrl-C で取り消せる。
|
|
346
|
+
`--engine mock` は要約しない試し用(記録の1行目を並べる)
|
|
347
|
+
- **古い材料**: 生成や保存のあとで要望・タスクが変わると「材料が変わった」と知らせる(本文は自動では直さない)。
|
|
348
|
+
必要なら生成し直して、確かめてから保存する
|
|
349
|
+
- **競合**: 保存したノートを直すときは、読んだときの版(`--version`)が要る。画面・エディタなど別のところで先に変わっていれば
|
|
350
|
+
終了コード 3 で何も書かない。`show` で読み直してからやり直す
|
|
351
|
+
- **ファイル**: `<データのフォルダ>/release-notes/<マイルストーン>.md`(本文と、出典を書いた frontmatter)。エディタで直してもよい。
|
|
352
|
+
壊すと「読めない」と出て、直すまで新しく保存しない。ノートのあるマイルストーンは消せない。保存の形と直し方は
|
|
353
|
+
[docs/architecture.md](architecture.md#リリースノートのデータ)
|
|
354
|
+
|
|
355
|
+
### 添付と画面資料
|
|
356
|
+
|
|
357
|
+
**添付**: 要望に PNG / JPEG / xlsx を付けて Preflight に渡す(今の画面のスクリーンショット・仕様書の Excel)。P3 は対象のアプリを
|
|
358
|
+
起動・撮影しないので、今の画面が要るときは撮った画像を添付する。
|
|
359
|
+
|
|
360
|
+
```bash
|
|
361
|
+
p3 attach add 今の画面.png --description "今の一覧" --source "本番の画面" --req <要望>
|
|
362
|
+
p3 request new "一覧に絞り込み" --attach 今の画面.png --attach 項目表.xlsx # 作るときに添付する
|
|
363
|
+
p3 attach --req <要望> # 一覧
|
|
364
|
+
p3 attach get <A-ID> --out 項目表.xlsx # 原本を書き出す(--run PF-... でその run に固定した原本)
|
|
365
|
+
p3 attach rm <A-ID>
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
- 形式は中身で確かめる。xls・xlsm(マクロつき)は扱わない。上限は1つの要望に 20 件・合計 100MB、画像 5MB(幅 4096・高さ 16384 px)、xlsx 20MB
|
|
369
|
+
- Preflight を始めるときに、そのときの添付を run に固定する(後で足し・消ししても過去の評価の資料は変わらない)
|
|
370
|
+
- xlsx は、P3 がセルの文字・保存済みの値と埋め込みの画像を取り出して渡す(数式は計算しない。図形・グラフは扱わない)
|
|
371
|
+
|
|
372
|
+
**画面資料**: UI を伴うタスク案には、Codex が画面イメージの原稿(HTML / CSS)を書き、P3 が PNG にして評価の下に出す
|
|
373
|
+
(提案・現状(添付)・仕様書から(xlsx の画像)に分けて並べる)。画像は「拡大」で大きく見られる。画像への意見はメモに書いて
|
|
374
|
+
再評価に渡す。必要な画面イメージが足りなければ、判定を go から clarify にして知らせる。原稿を自分で描くなら:
|
|
375
|
+
|
|
376
|
+
```bash
|
|
377
|
+
p3 render 画面.html --width 1280 # 画面.png ができる(幅 320〜2560 px・原稿 2MB まで。スクリプト・外部の参照は使えない。data: の画像はよい)
|
|
378
|
+
```
|
|
379
|
+
|
|
380
|
+
### 画面
|
|
381
|
+
|
|
382
|
+
`p3 serve` で開く(既定 http://localhost:4310)。画面の状態は URL に載る。
|
|
383
|
+
|
|
384
|
+
| URL | 画面 |
|
|
385
|
+
| --- | --- |
|
|
386
|
+
| `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=` |
|
|
387
|
+
| `/requests/new` | 新しい要望(添付も) |
|
|
388
|
+
| `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・添付)と Preflight(`?run=PF-...` で過去の評価) |
|
|
389
|
+
| `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す) |
|
|
390
|
+
| `/requests/<要望>/done` | 対応済み(済みにしたタスクと成果物の一覧。要望の「対応済」とは別) |
|
|
391
|
+
| `/release-notes` | リリースノート(`?m=<マイルストーン>`)。下の「リリースノートの画面」 |
|
|
392
|
+
| `/settings` | 個人(ChatGPT の接続・テーマ)/ プロジェクトの基本 / 参照先(`?tab=personal|project|repos`) |
|
|
393
|
+
|
|
394
|
+
要望の中のページでは `?task=T003` でタスク詳細を重ねて開く。
|
|
395
|
+
|
|
396
|
+
進捗のスケジュールの記号:
|
|
397
|
+
|
|
398
|
+
| 記号 | 意味 |
|
|
399
|
+
| --- | --- |
|
|
400
|
+
| ○ / ✓ | 完了にした日 / 人が確認して「済み」にしたもの |
|
|
401
|
+
| ◐ | 作業中にした日 |
|
|
402
|
+
| □ | 未着手のタスク(今日の線の右に、残りの数だけ) |
|
|
403
|
+
| ⚑ | 要望の期限(過ぎて未完了なら赤) |
|
|
404
|
+
| ◆ と縦の破線 | マイルストーン |
|
|
405
|
+
| 縦の線・丸囲みの日付 | 今日 |
|
|
406
|
+
|
|
407
|
+
印をクリックするとタスクの詳細が開く。ズーム(日 / 週 / 月)と「今日」ボタンで動かす。
|
|
408
|
+
|
|
409
|
+
**リリースノートの画面**(ヘッダーの「リリースノート」): 左でマイルストーンを選ぶ(ノートの有無と要望の数)。右に:
|
|
410
|
+
|
|
411
|
+
- **このマイルストーンの要望**: 状態・収録 / 対象外(理由)・変更の記録の数・警告(未完了・記録なし・状態の食い違い)。
|
|
412
|
+
タイトルで要望を開き、「変更の記録を見る」で要約の出典になるタスクの記録を確かめる(タスク名でタスクの詳細を開く)
|
|
413
|
+
- **機能の要約(案)**: 「機能の要約を生成」で生成する(生成中は「生成を取り消す」、失敗・取消は理由と「もう一度生成する」)。
|
|
414
|
+
結果は項目ごとに出典を添えて出し、**編集欄には入れない**。「生成の結果を編集欄へ反映」で入れる(保存していない入力が
|
|
415
|
+
あれば置き換えてよいか確かめる)。生成の間やあとで要望・タスクが変わると「古い材料からの案」と出る。材料が無ければ
|
|
416
|
+
ボタンは押せず、手で書く案内が出る
|
|
417
|
+
- **本文**: 公開する Markdown を直して「保存」。保存しても要望やマイルストーンの状態は変わらない。「保存した本文を
|
|
418
|
+
ダウンロード」は保存した本文だけ(未保存の変更・出典は含まない)
|
|
419
|
+
- **編集中にほかで保存・削除された / 読めなくなった**: 入力は残したまま赤い知らせが出て、その版では保存できない。
|
|
420
|
+
「外で保存された本文を見る」で見比べ、「入力をコピー」してから「最新の本文を読み直す」で最新にして貼り直す。
|
|
421
|
+
消されたときは「この入力で新しく保存する」を選べる(自動では作り直さない)。読めないときはファイルを直してから
|
|
422
|
+
「もう一度読み込む」
|
|
423
|
+
|
|
424
|
+
**外での変更の取り込み**: CLI・AI・エディタ・git pull で変えたものは、ヘッダーの「再読み込み」で取り込む(タブやウィンドウに
|
|
425
|
+
戻ったときも1回読み直す)。ブラウザのリロードはしないので、入力中の内容は残る。画面同士の変更は自動で届く。
|
|
426
|
+
入力中に同じものがほかで変わったときは、入力を残して知らせ、保存は競合として止める(「入力を捨てて最新にする」で最新を見る)。
|
|
427
|
+
|
|
428
|
+
### 短い出力・JSON・終了コード
|
|
429
|
+
|
|
430
|
+
- `--json` で機械可読な出力(AI 向け)。`--brief` は作業に要る項目だけの短い出力(本文は切り詰めない):
|
|
431
|
+
- タスク: 本文・状態・rev・成果物・依存(`depends_on`)とその状態(`dependencies`)・置き換えの注意(`warnings`)・作業先とブランチ(`work`)・変更の記録
|
|
432
|
+
- 要望: 本文・状態・rev・作業先ごとのブランチ(`branches`)・タスクの一覧・対応済なのに未完了のタスクがあるときの知らせ(`issue`)
|
|
433
|
+
- `dependencies` の相手が見つからない(アーカイブした・参照の誤り)ときは `title` と `status` が `null`(完了とは扱わない)
|
|
434
|
+
- `--rev <番号>` で楽観ロック(`set` / `move` / `request set`)
|
|
435
|
+
- 終了コード: 0 成功 / 1 使い方の誤り(次にすることが出る)/ 2 見つからない / 3 競合(読み直してやり直す)
|
|
436
|
+
- CLI はサーバを経由せずファイルに直接書く(serve が動いていなくてよい)
|
|
437
|
+
|
|
438
|
+
### データの持ち方
|
|
439
|
+
|
|
440
|
+
DB は無く、1タスク = 1 Markdown ファイル。人・AI・Codex が直接編集しても整合する(書き込みは直前に読み直し、古い rev なら止める)。
|
|
441
|
+
|
|
442
|
+
```
|
|
443
|
+
<データのフォルダ>/ (例: ~/p3-data/myapp。リポジトリの中なら .p3/)
|
|
444
|
+
project.yaml プロジェクト設定
|
|
445
|
+
requests/
|
|
446
|
+
261009-k7m3x/ 要望のフォルダ(作成日 + 乱数5文字。タイトルが変わっても変わらない)
|
|
447
|
+
request.md 要望
|
|
448
|
+
tasks/T001.md, T002.md ... タスク(要望の中の連番)
|
|
449
|
+
tasks/.archive/ アーカイブしたタスク(その ID は再利用しない)
|
|
450
|
+
notes/N-....md Preflight へのメモ
|
|
451
|
+
attachments/A-.../ 添付
|
|
452
|
+
preflight/PF-.../ Preflight の記録(評価対象・評価・タスク案・画面資料・ログ)
|
|
453
|
+
.archive/ アーカイブした要望
|
|
454
|
+
release-notes/v0.2.md リリースノート(マイルストーンごとに1件)
|
|
455
|
+
```
|
|
456
|
+
|
|
457
|
+
タスクファイルの例(`requests/261009-k7m3x/tasks/T003.md`):
|
|
458
|
+
|
|
459
|
+
```markdown
|
|
460
|
+
---
|
|
461
|
+
id: T003
|
|
462
|
+
title: ファイル監視で外部編集を取り込む
|
|
463
|
+
status: done
|
|
464
|
+
areas: [src/core/store/workspace.ts]
|
|
465
|
+
outputs:
|
|
466
|
+
- https://github.com/me/myapp/pull/42
|
|
467
|
+
startedAt: 2026-10-09T10:12:00.000Z # 作業中にした日時(P3 が記録)
|
|
468
|
+
doneAt: 2026-10-09T15:40:00.000Z # 完了にした日時(P3 が記録)
|
|
469
|
+
checkedAt: 2026-10-10T09:00:00.000Z # 人が確認して「済み」にした日時
|
|
470
|
+
record: | # 変更の記録
|
|
471
|
+
- 外部の編集をファイル監視で取り込むようにした
|
|
472
|
+
- 理由: CLI で直したタスクが画面に出なかった
|
|
473
|
+
relations:
|
|
474
|
+
- { type: depends_on, target: T002, origin: preflight }
|
|
475
|
+
rev: 3
|
|
476
|
+
updatedBy: ai:claude
|
|
477
|
+
---
|
|
478
|
+
|
|
479
|
+
(本文: 作業内容と完了条件)
|
|
480
|
+
```
|
|
481
|
+
|
|
482
|
+
- 参照: 同じ要望の中は `T003`、別の要望は `<要望ID>/T003`、要望そのものは `<要望ID>`
|
|
483
|
+
- 要望 ID は乱数を含むので、複数人が別々に作っても衝突しない。ID の順は作った順を表さない
|
|
484
|
+
- 一覧の並び: 進捗は最終更新の新しい順、タスクは ID の順(T2 < T10)、Preflight の run は新しい順、メモは古い順、対応済みは済みにした新しい順
|
|
485
|
+
|
|
486
|
+
### AI エージェントから使う
|
|
487
|
+
|
|
488
|
+
AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --agents` で、`AGENTS.md`(無ければ `CLAUDE.md`)に短い使い方を追記し、
|
|
489
|
+
詳しい手順のスキルを置く。どちらにも上の「役割と言葉」の役割が書いてある。置いたファイルはリポジトリに入れて共有する。
|
|
490
|
+
|
|
491
|
+
| 置く場所(リポジトリのルート) | 読む AI |
|
|
492
|
+
| --- | --- |
|
|
493
|
+
| `.claude/skills/p3/SKILL.md` | Claude Code |
|
|
494
|
+
| `.agents/skills/p3/SKILL.md` | Codex(今いるフォルダからリポジトリのルートまでの `.agents/skills` を読む) |
|
|
495
|
+
|
|
496
|
+
中身は同じ(同梱の原本 `skills/p3/SKILL.md` の写し)。ほかの AI が `.agents/skills` を読むかは確かめていない。
|
|
497
|
+
置くのはプロジェクトの中だけにする。個人のスキルの場所(`~/.claude/skills`・`~/.agents/skills`)に置くと、p3 を使わない
|
|
498
|
+
プロジェクトでも読まれ、関係ない作業で p3 を操作しかねない。
|
|
499
|
+
|
|
500
|
+
**P3 を新しくしたとき**: 置いたスキルと追記は、手で直した分を消さないよう上書きしない。登録済みのリポジトリで
|
|
501
|
+
`p3 init --agents --project <名前> --dir <データのフォルダ>` をもう一度実行すると、登録とデータはそのままで、スキルの場所ごとに
|
|
502
|
+
無ければ置き、「最新です」か「同梱の版と違う」かを出す。片方(以前の版で置いた `.claude/skills` だけなど)しか無ければ、
|
|
503
|
+
足りない方が置かれる。違うものは同梱の原本と見比べて手で直す(追記は見出しがあれば足さないので、最新の内容は
|
|
504
|
+
[docs/architecture.md](architecture.md) の「AI エージェントへの指示」と見比べる)。
|
|
505
|
+
|
|
506
|
+
ブラウザ用の REST API(`/api/...`、自己記述は `GET /api/ai/manifest`)もあるが、ローカルの画面のためのもの。
|
|
507
|
+
|
|
508
|
+
### CLI の一覧
|
|
509
|
+
|
|
510
|
+
すべてのオプションは `p3 help`。
|
|
511
|
+
|
|
512
|
+
| コマンド | 内容 |
|
|
513
|
+
| --- | --- |
|
|
514
|
+
| `p3 init` / `p3 project` / `p3 whoami` | 初期設定・参加 / 個人設定のプロジェクト / 今の判定 |
|
|
515
|
+
| `p3 config` / `p3 repo` / `p3 user-config` | プロジェクトの設定 / 参照先 / 個人設定(テーマ・マシンごとの設定) |
|
|
516
|
+
| `p3 progress` | 要望ごとの進捗(マイルストーンごと。`--all` で完了・見送りも) |
|
|
517
|
+
| `p3 milestone ls\|add\|set\|rm` | マイルストーン |
|
|
518
|
+
| `p3 release-notes ls\|show\|generate\|save\|export` | マイルストーンのリリースノート(要約の生成・保存・本文の出力) |
|
|
519
|
+
| `p3 request new\|ls\|show\|set\|archive` | 要望 |
|
|
520
|
+
| `p3 ls` / `p3 show` / `p3 find` | タスクの一覧(`--all` で全要望)/ 詳細(`--brief`)/ 参照・タイトルで探す |
|
|
521
|
+
| `p3 new` / `p3 set` / `p3 move` / `p3 check` / `p3 archive` | タスクを足す / 直す / 状態を変える / 済みにする / アーカイブ |
|
|
522
|
+
| `p3 preflight` / `p3 notes` / `p3 drafts` / `p3 accept` | Preflight の実行(`--note`)/ メモ / 評価とタスク案 / タスク化 |
|
|
523
|
+
| `p3 attach` / `p3 render` | 添付 / 画面イメージの描画 |
|
|
524
|
+
| `p3 chatgpt` / `p3 codex update` / `p3 serve` | ChatGPT の接続 / Codex のイメージ / 画面 |
|