@pecot/workflow-mcp 0.0.0-stage → 5.0.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.
Files changed (244) hide show
  1. package/.claude-plugin/plugin.json +8 -0
  2. package/LICENSE +21 -0
  3. package/README.md +126 -2
  4. package/bin/pecot-workflow-mcp.mjs +10 -0
  5. package/cli/dist/cli.d.ts +26 -0
  6. package/cli/dist/cli.js +222 -0
  7. package/cli/dist/commands/cell-table.d.ts +3 -0
  8. package/cli/dist/commands/cell-table.js +495 -0
  9. package/cli/dist/commands/command-binding.d.ts +26 -0
  10. package/cli/dist/commands/command-binding.js +266 -0
  11. package/cli/dist/commands/command-definition.d.ts +136 -0
  12. package/cli/dist/commands/command-definition.js +101 -0
  13. package/cli/dist/commands/command-help.d.ts +8 -0
  14. package/cli/dist/commands/command-help.js +173 -0
  15. package/cli/dist/commands/command-stop.d.ts +19 -0
  16. package/cli/dist/commands/command-stop.js +30 -0
  17. package/cli/dist/commands/dependabot.d.ts +3 -0
  18. package/cli/dist/commands/dependabot.js +165 -0
  19. package/cli/dist/commands/directory-option.d.ts +7 -0
  20. package/cli/dist/commands/directory-option.js +48 -0
  21. package/cli/dist/commands/failure.d.ts +13 -0
  22. package/cli/dist/commands/failure.js +33 -0
  23. package/cli/dist/commands/fuzzy.d.ts +7 -0
  24. package/cli/dist/commands/fuzzy.js +79 -0
  25. package/cli/dist/commands/github-client.d.ts +12 -0
  26. package/cli/dist/commands/github-client.js +23 -0
  27. package/cli/dist/commands/global-options.d.ts +25 -0
  28. package/cli/dist/commands/global-options.js +83 -0
  29. package/cli/dist/commands/help-layout.d.ts +40 -0
  30. package/cli/dist/commands/help-layout.js +117 -0
  31. package/cli/dist/commands/help.d.ts +8 -0
  32. package/cli/dist/commands/help.js +55 -0
  33. package/cli/dist/commands/input-schema.d.ts +14 -0
  34. package/cli/dist/commands/input-schema.js +56 -0
  35. package/cli/dist/commands/issue-board.d.ts +38 -0
  36. package/cli/dist/commands/issue-board.js +62 -0
  37. package/cli/dist/commands/issue-comment.d.ts +3 -0
  38. package/cli/dist/commands/issue-comment.js +196 -0
  39. package/cli/dist/commands/issue-create.d.ts +3 -0
  40. package/cli/dist/commands/issue-create.js +329 -0
  41. package/cli/dist/commands/issue-project.d.ts +3 -0
  42. package/cli/dist/commands/issue-project.js +176 -0
  43. package/cli/dist/commands/issue-quick.d.ts +3 -0
  44. package/cli/dist/commands/issue-quick.js +126 -0
  45. package/cli/dist/commands/issue-read.d.ts +3 -0
  46. package/cli/dist/commands/issue-read.js +80 -0
  47. package/cli/dist/commands/issue-shared.d.ts +159 -0
  48. package/cli/dist/commands/issue-shared.js +419 -0
  49. package/cli/dist/commands/issue.d.ts +4 -0
  50. package/cli/dist/commands/issue.js +15 -0
  51. package/cli/dist/commands/names.d.ts +9 -0
  52. package/cli/dist/commands/names.js +16 -0
  53. package/cli/dist/commands/output.d.ts +78 -0
  54. package/cli/dist/commands/output.js +187 -0
  55. package/cli/dist/commands/pr.d.ts +3 -0
  56. package/cli/dist/commands/pr.js +933 -0
  57. package/cli/dist/commands/project-info.d.ts +48 -0
  58. package/cli/dist/commands/project-info.js +181 -0
  59. package/cli/dist/commands/project-sync.d.ts +91 -0
  60. package/cli/dist/commands/project-sync.js +273 -0
  61. package/cli/dist/commands/project.d.ts +5 -0
  62. package/cli/dist/commands/project.js +677 -0
  63. package/cli/dist/commands/registry.d.ts +6 -0
  64. package/cli/dist/commands/registry.js +27 -0
  65. package/cli/dist/commands/release.d.ts +10 -0
  66. package/cli/dist/commands/release.js +414 -0
  67. package/cli/dist/commands/repository-display.d.ts +3 -0
  68. package/cli/dist/commands/repository-display.js +7 -0
  69. package/cli/dist/commands/repository-match.d.ts +14 -0
  70. package/cli/dist/commands/repository-match.js +33 -0
  71. package/cli/dist/commands/repository.d.ts +5 -0
  72. package/cli/dist/commands/repository.js +265 -0
  73. package/cli/dist/commands/rich-panel.d.ts +22 -0
  74. package/cli/dist/commands/rich-panel.js +295 -0
  75. package/cli/dist/commands/security.d.ts +3 -0
  76. package/cli/dist/commands/security.js +164 -0
  77. package/cli/dist/commands/session.d.ts +3 -0
  78. package/cli/dist/commands/session.js +161 -0
  79. package/cli/dist/commands/tracker-sync.d.ts +58 -0
  80. package/cli/dist/commands/tracker-sync.js +53 -0
  81. package/cli/dist/commands/usage-error.d.ts +47 -0
  82. package/cli/dist/commands/usage-error.js +72 -0
  83. package/cli/dist/commands/value-types.d.ts +46 -0
  84. package/cli/dist/commands/value-types.js +94 -0
  85. package/cli/dist/commands/work-target.d.ts +13 -0
  86. package/cli/dist/commands/work-target.js +41 -0
  87. package/cli/dist/commands/worktree.d.ts +3 -0
  88. package/cli/dist/commands/worktree.js +335 -0
  89. package/cli/dist/domain/api-error-detail.d.ts +10 -0
  90. package/cli/dist/domain/api-error-detail.js +25 -0
  91. package/cli/dist/domain/branch-name.d.ts +5 -0
  92. package/cli/dist/domain/branch-name.js +10 -0
  93. package/cli/dist/domain/changelog.d.ts +43 -0
  94. package/cli/dist/domain/changelog.js +107 -0
  95. package/cli/dist/domain/config.d.ts +215 -0
  96. package/cli/dist/domain/config.js +300 -0
  97. package/cli/dist/domain/dependabot-pull-requests.d.ts +82 -0
  98. package/cli/dist/domain/dependabot-pull-requests.js +338 -0
  99. package/cli/dist/domain/dependabot-source.d.ts +51 -0
  100. package/cli/dist/domain/dependabot-source.js +4 -0
  101. package/cli/dist/domain/dependabot.d.ts +47 -0
  102. package/cli/dist/domain/dependabot.js +88 -0
  103. package/cli/dist/domain/errors.d.ts +19 -0
  104. package/cli/dist/domain/errors.js +31 -0
  105. package/cli/dist/domain/field-options.d.ts +31 -0
  106. package/cli/dist/domain/field-options.js +44 -0
  107. package/cli/dist/domain/format.d.ts +47 -0
  108. package/cli/dist/domain/format.js +168 -0
  109. package/cli/dist/domain/frontmatter.d.ts +122 -0
  110. package/cli/dist/domain/frontmatter.js +264 -0
  111. package/cli/dist/domain/git-runner.d.ts +10 -0
  112. package/cli/dist/domain/git-runner.js +4 -0
  113. package/cli/dist/domain/git-url.d.ts +17 -0
  114. package/cli/dist/domain/git-url.js +30 -0
  115. package/cli/dist/domain/issue-kind.d.ts +16 -0
  116. package/cli/dist/domain/issue-kind.js +16 -0
  117. package/cli/dist/domain/issue-readout.d.ts +107 -0
  118. package/cli/dist/domain/issue-readout.js +4 -0
  119. package/cli/dist/domain/json-null.d.ts +2 -0
  120. package/cli/dist/domain/json-null.js +5 -0
  121. package/cli/dist/domain/json.d.ts +21 -0
  122. package/cli/dist/domain/json.js +47 -0
  123. package/cli/dist/domain/prerequisites.d.ts +32 -0
  124. package/cli/dist/domain/prerequisites.js +192 -0
  125. package/cli/dist/domain/pull-request.d.ts +134 -0
  126. package/cli/dist/domain/pull-request.js +232 -0
  127. package/cli/dist/domain/python-format.d.ts +105 -0
  128. package/cli/dist/domain/python-format.js +304 -0
  129. package/cli/dist/domain/readiness.d.ts +172 -0
  130. package/cli/dist/domain/readiness.js +280 -0
  131. package/cli/dist/domain/reference-parser.d.ts +49 -0
  132. package/cli/dist/domain/reference-parser.js +119 -0
  133. package/cli/dist/domain/release.d.ts +49 -0
  134. package/cli/dist/domain/release.js +72 -0
  135. package/cli/dist/domain/repository-policy.d.ts +32 -0
  136. package/cli/dist/domain/repository-policy.js +65 -0
  137. package/cli/dist/domain/repository-resolver.d.ts +57 -0
  138. package/cli/dist/domain/repository-resolver.js +119 -0
  139. package/cli/dist/domain/sections.d.ts +69 -0
  140. package/cli/dist/domain/sections.js +514 -0
  141. package/cli/dist/domain/security-alerts-source.d.ts +29 -0
  142. package/cli/dist/domain/security-alerts-source.js +4 -0
  143. package/cli/dist/domain/security-alerts.d.ts +52 -0
  144. package/cli/dist/domain/security-alerts.js +107 -0
  145. package/cli/dist/domain/security-tracker.d.ts +115 -0
  146. package/cli/dist/domain/security-tracker.js +353 -0
  147. package/cli/dist/domain/state.d.ts +29 -0
  148. package/cli/dist/domain/state.js +56 -0
  149. package/cli/dist/domain/tracker-body.d.ts +70 -0
  150. package/cli/dist/domain/tracker-body.js +65 -0
  151. package/cli/dist/domain/yaml-document.d.ts +5 -0
  152. package/cli/dist/domain/yaml-document.js +206 -0
  153. package/cli/dist/infra/authored-notes.d.ts +37 -0
  154. package/cli/dist/infra/authored-notes.js +66 -0
  155. package/cli/dist/infra/changelog-file.d.ts +19 -0
  156. package/cli/dist/infra/changelog-file.js +43 -0
  157. package/cli/dist/infra/child-stdin.d.ts +4 -0
  158. package/cli/dist/infra/child-stdin.js +8 -0
  159. package/cli/dist/infra/config-store.d.ts +49 -0
  160. package/cli/dist/infra/config-store.js +121 -0
  161. package/cli/dist/infra/diagnostics.d.ts +9 -0
  162. package/cli/dist/infra/diagnostics.js +2 -0
  163. package/cli/dist/infra/file-kind.d.ts +9 -0
  164. package/cli/dist/infra/file-kind.js +26 -0
  165. package/cli/dist/infra/frontmatter-file.d.ts +14 -0
  166. package/cli/dist/infra/frontmatter-file.js +30 -0
  167. package/cli/dist/infra/git.d.ts +74 -0
  168. package/cli/dist/infra/git.js +133 -0
  169. package/cli/dist/infra/github/auth.d.ts +60 -0
  170. package/cli/dist/infra/github/auth.js +158 -0
  171. package/cli/dist/infra/github/client.d.ts +173 -0
  172. package/cli/dist/infra/github/client.js +576 -0
  173. package/cli/dist/infra/github/dependabot-source.d.ts +13 -0
  174. package/cli/dist/infra/github/dependabot-source.js +33 -0
  175. package/cli/dist/infra/github/errors.d.ts +47 -0
  176. package/cli/dist/infra/github/errors.js +42 -0
  177. package/cli/dist/infra/github/index.d.ts +13 -0
  178. package/cli/dist/infra/github/index.js +19 -0
  179. package/cli/dist/infra/github/issues.d.ts +129 -0
  180. package/cli/dist/infra/github/issues.js +273 -0
  181. package/cli/dist/infra/github/payload.d.ts +44 -0
  182. package/cli/dist/infra/github/payload.js +80 -0
  183. package/cli/dist/infra/github/projects.d.ts +108 -0
  184. package/cli/dist/infra/github/projects.js +303 -0
  185. package/cli/dist/infra/github/pulls.d.ts +80 -0
  186. package/cli/dist/infra/github/pulls.js +161 -0
  187. package/cli/dist/infra/github/queries.d.ts +36 -0
  188. package/cli/dist/infra/github/queries.js +883 -0
  189. package/cli/dist/infra/github/readout.d.ts +18 -0
  190. package/cli/dist/infra/github/readout.js +156 -0
  191. package/cli/dist/infra/github/repos.d.ts +68 -0
  192. package/cli/dist/infra/github/repos.js +137 -0
  193. package/cli/dist/infra/github/rest-path.d.ts +14 -0
  194. package/cli/dist/infra/github/rest-path.js +31 -0
  195. package/cli/dist/infra/github/security-alerts-source.d.ts +15 -0
  196. package/cli/dist/infra/github/security-alerts-source.js +73 -0
  197. package/cli/dist/infra/gitignore-spec.d.ts +36 -0
  198. package/cli/dist/infra/gitignore-spec.js +235 -0
  199. package/cli/dist/infra/nx-scope.d.ts +51 -0
  200. package/cli/dist/infra/nx-scope.js +182 -0
  201. package/cli/dist/infra/os-error.d.ts +24 -0
  202. package/cli/dist/infra/os-error.js +38 -0
  203. package/cli/dist/infra/paths.d.ts +88 -0
  204. package/cli/dist/infra/paths.js +234 -0
  205. package/cli/dist/infra/state-store.d.ts +45 -0
  206. package/cli/dist/infra/state-store.js +118 -0
  207. package/cli/dist/infra/template-store.d.ts +15 -0
  208. package/cli/dist/infra/template-store.js +34 -0
  209. package/cli/dist/infra/text-file.d.ts +12 -0
  210. package/cli/dist/infra/text-file.js +33 -0
  211. package/cli/dist/infra/worktree-copy.d.ts +24 -0
  212. package/cli/dist/infra/worktree-copy.js +95 -0
  213. package/cli/dist/infra/worktree-links.d.ts +139 -0
  214. package/cli/dist/infra/worktree-links.js +433 -0
  215. package/cli/dist/infra/worktree-setup.d.ts +21 -0
  216. package/cli/dist/infra/worktree-setup.js +41 -0
  217. package/cli/dist/infra/worktree.d.ts +174 -0
  218. package/cli/dist/infra/worktree.js +567 -0
  219. package/cli/dist/mcp/result.d.ts +33 -0
  220. package/cli/dist/mcp/result.js +52 -0
  221. package/cli/dist/mcp/serve.d.ts +51 -0
  222. package/cli/dist/mcp/serve.js +183 -0
  223. package/cli/dist/mcp/server.d.ts +21 -0
  224. package/cli/dist/mcp/server.js +128 -0
  225. package/cli/dist/mcp/session-directory.d.ts +26 -0
  226. package/cli/dist/mcp/session-directory.js +84 -0
  227. package/cli/dist/package.json +1 -0
  228. package/cli/dist/version.d.ts +17 -0
  229. package/cli/dist/version.js +42 -0
  230. package/cli/templates/comment/merge-diff.md +34 -0
  231. package/cli/templates/comment/plan.md +181 -0
  232. package/cli/templates/comment/precede-notify.md +33 -0
  233. package/cli/templates/comment/review-findings.md +42 -0
  234. package/cli/templates/comment/review-resolution.md +48 -0
  235. package/cli/templates/issue/bug.md +63 -0
  236. package/cli/templates/issue/epic.md +54 -0
  237. package/cli/templates/issue/task-implement.md +67 -0
  238. package/cli/templates/issue/task.md +48 -0
  239. package/cli/templates/issue/tracker.md +48 -0
  240. package/cli/templates/pr/create.md +123 -0
  241. package/cli/templates/pr/release.md +56 -0
  242. package/hooks/lib/core/pecot-gitignore-ensure.sh +48 -0
  243. package/npm-shrinkwrap.json +83 -0
  244. package/package.json +22 -4
@@ -0,0 +1,181 @@
1
+ ---
2
+ issue_ref: ""
3
+ template: plan
4
+ ---
5
+
6
+ <!--
7
+ 読者: 承認者(プランモードの承認画面と Issue で、折りたたみの外を読んで判断する)と、次のセッションの実装者(折りたたみを開いて着手する)。末尾の「例:」の形で書く。
8
+
9
+ 書き方:
10
+ - Files は、外に触る代表ファイルを並べ、`<details>` の中にファイルごとのどう触るかを詳しく書く
11
+ - Claude Code の plan mode の標準 5 項目は、Context・Approach(推奨方針)・Files(主要ファイルと再利用する既存関数)・E2E(検証)に書く
12
+
13
+ CUJ = 利用者(人またはエージェント)が製品の起点から始め、利用者が観測する結果で終わる操作フロー。
14
+ 起点はスキル起動・MCP ツール呼出・実ツール発火による hook・利用者が打つ CLI コマンドのいずれか。
15
+ 同じコマンドでも、利用者が成果を得るために打つなら CUJ で、実装者が変更の健全性を確かめるために打つなら CUJ ではない。
16
+ 起点のコマンドに付ける `--dry-run` / `--prepare` は副作用を消す手段なので、利用者が打つ形なら起点に含む。
17
+ CUJ ごとに「誰が・起点・観測結果」の 3 要素を必須とし、いずれかを書けない項目を CUJ と呼ばない。
18
+ テストランナー実行(run-tests.sh / pytest / vitest)・ベースライン計測・健全性確認のための dry-run は CUJ にしない。
19
+ スクリプトや hook の直叩き(`echo '{}' | bash hook.sh`)も同じく CUJ にしない。
20
+
21
+ 例:
22
+
23
+ ## Plan
24
+
25
+ `mytool export` に `--format csv` を足し、CSV のファイルを書き出せるようにする。
26
+
27
+ ### Context
28
+
29
+ `mytool export` は JSON しか書き出せない。表計算ソフトで開くには、利用者が JSON を自分で CSV に変換している。
30
+
31
+ ### Approach
32
+
33
+ 書き出しの入口に形式の選択を足し、形式ごとの書き手に処理を渡す。CSV の書き手を新しく足す。
34
+
35
+ <details>
36
+ <summary align="right">詳細はこちら</summary>
37
+
38
+ - 書き手は形式ごとに 1 ファイルにする。JSON の書き手も同じ形に移し、入口は形式の名前で書き手を選ぶだけにする
39
+ - CSV は標準ライブラリの `csv` モジュールで書く。カンマ・改行・ダブルクォートのエスケープを自前で書かない
40
+ - 列の順は `mytool list` の表示と同じにする。設定で列の順を変える案は採らない(利用者が 2 つの順を覚えることになる)
41
+ - 入れ子の値は JSON の文字列にして 1 つのセルに入れる
42
+
43
+ </details>
44
+
45
+ ### Files
46
+
47
+ - `src/export.py`
48
+ - `src/writers/csv.py`(新規)
49
+ - `src/writers/json.py`(新規)
50
+ - `tests/test_export.py`
51
+
52
+ <details>
53
+ <summary align="right">詳細はこちら</summary>
54
+
55
+ - `src/export.py`
56
+ - `--format` の引数を足す。値は `json`(既定)と `csv`
57
+ - それ以外の値は「csv か json を指定してください」で止める
58
+ - 書き出しの処理を、選んだ形式の書き手に渡す
59
+ - `src/writers/csv.py`(新規)
60
+ - `write_csv(rows, columns, out)` を足す。`columns` は `mytool list` と同じ `LIST_COLUMNS` を使う
61
+ - `src/writers/json.py`(新規)
62
+ - `src/export.py` にある JSON の書き出しを、そのまま `write_json(rows, out)` に移す
63
+ - `tests/test_export.py`
64
+ - CSV の書き出し、エスケープ、入れ子の値、不正な形式の名前のケースを足す
65
+
66
+ </details>
67
+
68
+ ### Notes
69
+
70
+ Issue の Acceptance にある「表計算ソフトで開ける」は、CSV の中身を読んで確かめる。
71
+
72
+ <details>
73
+ <summary align="right">詳細はこちら</summary>
74
+
75
+ - 表計算ソフトは devcontainer に入っていない。表計算ソフトが読む形(RFC 4180)になっているかを、書き出したファイルを Python の `csv` モジュールで読み戻して確かめる
76
+
77
+ </details>
78
+
79
+ ## PECOT-Workflow
80
+
81
+ `mytool export` を 3 通り打ち、CSV の書き出し・不正な形式の名前・既定の JSON を確かめる。
82
+
83
+ ### E2E
84
+
85
+ CSV を書き出せること、不正な形式の名前で止まること、`--format` を省くと今までどおり JSON を書き出すことを、`mytool export` を打って確かめる。
86
+
87
+ <details>
88
+ <summary align="right">詳細はこちら</summary>
89
+
90
+ CUJ 1
91
+
92
+ - 誰が — 利用者(devcontainer の端末)
93
+ - 起点 — `mytool export --format csv > out.csv`
94
+ - テスト手順
95
+ 1. カンマと改行を含む値を持つ行を `mytool add` で足す
96
+ 2. `mytool export --format csv > out.csv` を打つ
97
+ 3. `out.csv` を Python の `csv` モジュールで読み戻す
98
+ - 合格基準 — 1 行目が `mytool list` と同じ列の見出しで、カンマと改行を含む値が 1 つのセルに戻る
99
+
100
+ CUJ 2
101
+
102
+ - 誰が — 利用者(同上)
103
+ - 起点 — `mytool export --format xml`
104
+ - テスト手順
105
+ 1. `mytool export --format xml` を打つ
106
+ - 合格基準 — 「csv か json を指定してください」と出て、終了コードが 1 で、ファイルを書かない
107
+
108
+ CUJ 3
109
+
110
+ - 誰が — 利用者(同上)
111
+ - 起点 — `mytool export > out.json`
112
+ - テスト手順
113
+ 1. `--format` を付けずに打つ
114
+ 2. 変更前のブランチで打った出力と比べる
115
+ - 合格基準 — 変更前と同じ JSON が書き出される
116
+
117
+ </details>
118
+ -->
119
+
120
+ ## Plan
121
+
122
+ <タスクの要約>
123
+
124
+ ### Context
125
+
126
+ <なぜこの変更が要るか。何が起きていて、何を目指すか>
127
+
128
+ ### Approach
129
+
130
+ <採る方針の要約>
131
+
132
+ <details>
133
+ <summary align="right">詳細はこちら</summary>
134
+
135
+ <方針の詳細と理由。採らなかった案があれば、その理由>
136
+
137
+ </details>
138
+
139
+ ### Files
140
+
141
+ <触る代表ファイル>
142
+
143
+ <details>
144
+ <summary align="right">詳細はこちら</summary>
145
+
146
+ <ファイルごとに、どう触るか。再利用する既存の関数があれば、その名前>
147
+
148
+ </details>
149
+
150
+ ### Notes
151
+
152
+ <他の見出しに収まらないが読者に要ることの要約。無ければ「なし」>
153
+
154
+ <details>
155
+ <summary align="right">詳細はこちら</summary>
156
+
157
+ <Issue の記述と変える点、判断を仰ぐ点、前提にした事実と、その根拠>
158
+
159
+ </details>
160
+
161
+ ## PECOT-Workflow
162
+
163
+ <検証方法の要約>
164
+
165
+ ### E2E
166
+
167
+ <CUJ の要約>
168
+
169
+ <details>
170
+ <summary align="right">詳細はこちら</summary>
171
+
172
+ CUJ 1
173
+
174
+ - 誰が — <利用者 / エージェント。どの環境・セッションで>
175
+ - 起点 — <スキル / MCP ツール / hook を発火させる実ツール / CLI コマンド>
176
+ - テスト手順
177
+ 1. <手順1>
178
+ 2. <手順2>
179
+ - 合格基準 — <利用者が見る出力・状態>
180
+
181
+ </details>
@@ -0,0 +1,33 @@
1
+ ---
2
+ issue_ref: ""
3
+ template: precede-notify
4
+ ---
5
+
6
+ <!--
7
+ 読者: 後に続く Issue の実装者。先に終わったタスクを受けて、合わせる必要があるかを判断する。末尾の「例:」の形で書く。
8
+
9
+ 書き方:
10
+ - 見出しの `—` の後は、何がどうなったか(どうなるか)を、主語と述語のある 1 文で書く
11
+
12
+ 例:
13
+
14
+ ## Notice — CSV の書き出しが入り、書き手の作り方が決まった
15
+
16
+ ### Changes — 書き手を足す場所と、その形が変わった
17
+
18
+ - `src/writers/` — 形式ごとに書き手を 1 ファイルで置く形になった。並べ替えの結果もここを通る
19
+
20
+ ### Checks — 並べ替えのテストは、確かめ方の見直しが要る
21
+
22
+ - `tests/test_sort.py` — 結果を JSON の文字列で比べている。CSV の書き手でも同じ結果になるかを足すか決める
23
+ -->
24
+
25
+ ## Notice — <先行完了サマリを1行で>
26
+
27
+ ### Changes — <関連する変更を1行で>
28
+
29
+ - <変わったもの(ファイル・関数)> — <このタスクへの影響>
30
+
31
+ ### Checks — <確認が必要な点を1行で>
32
+
33
+ - <確かめ直す観点> — <テストの更新の要否など、なぜ要るか>
@@ -0,0 +1,42 @@
1
+ ---
2
+ issue_ref: ""
3
+ template: review-findings
4
+ ---
5
+
6
+ <!--
7
+ 読者: 指摘を採るかを判断するユーザーと、採った指摘を直す実装者。Disposition の F-NN を、PR のインラインコメントと後の review-resolution に突き合わせる。末尾の「例:」の形で書く。
8
+
9
+ 書き方:
10
+ - 見出しの `—` の後は、何がどうなったか(どうなるか)を、主語と述語のある 1 文で書く
11
+ - 行に紐づく指摘は、PR の該当行にインラインコメントとして投稿してある。本文をここに再掲しない
12
+ - 指摘 1 件に F-NN を 1 つ振る(F-01 から連番。外部のレビュアーの指摘も同じ連番)
13
+ - General には、行に紐づけられない指摘だけを書く(PR 本文・欠けているもの・差分の外の既存行・横断的な設計)
14
+ - Disposition には、インラインにした分も含めて全 F-NN を並べる。URL は、自分が投稿したコメントなら `html_url`、外部のレビュアーなら元のスレッド。インラインでない分は省く
15
+ - 想定する方針は「対応」か「対応不要」で書く。保留は使わない
16
+ - 指摘が 0 件でも投稿する。0 件の節は `- 非インライン指摘なし` / `- 指摘なし` にする
17
+ - `-m` の 1 行の投稿は節が欠けて検証で止まる。このファイルを編集してから投稿する
18
+
19
+ 例:
20
+
21
+ ## Findings — CSV の値のエスケープの漏れが争点になる
22
+
23
+ ### General — PR 本文に CSV の文字コードの説明が無い
24
+
25
+ - **F-02** [tech-advisor] PR 本文の Summary に、書き出す CSV の文字コード(UTF-8・BOM の有無)が書かれていない
26
+
27
+ ### Disposition — 2 件の指摘は、どちらも直す
28
+
29
+ - **F-01** 値の中のダブルクォートをエスケープしていない — 対応 https://github.com/acme/mytool/pull/45#discussion_r101
30
+ - **F-02** PR 本文に CSV の文字コードが無い — 対応
31
+ -->
32
+
33
+ ## Findings — <レビュー指摘の焦点を1行で>
34
+
35
+ ### General — <行に紐づかない指摘を1行で>
36
+
37
+ - **F-02** [<レビュアーの種別>] <指摘の要旨(該当箇所)>
38
+
39
+ ### Disposition — <F-NN ごとの想定対応方針を1行で>
40
+
41
+ - **F-01** <インラインにした指摘の要旨> — <対応 / 対応不要と理由> <インラインコメントの html_url>
42
+ - **F-02** <インラインでない指摘の要旨> — <対応 / 対応不要と理由>
@@ -0,0 +1,48 @@
1
+ ---
2
+ issue_ref: ""
3
+ template: review-resolution
4
+ ---
5
+
6
+ <!--
7
+ 読者: マージしてよいかを判断する人と、次のラウンドのレビュアー。F-NN は、同じ PR の review-findings で振った番号と突き合わせる。末尾の「例:」の形で書く。
8
+
9
+ 書き方:
10
+ - 見出しの `—` の後は、何がどうなったか(どうなるか)を、主語と述語のある 1 文で書く
11
+ - スレッドの resolve は終わった印で、採否は表さない(対応不要とした F-NN も返信して resolve する)。採否は Declined と、コミットメッセージの F-NN で表す
12
+ - 採った指摘の対応は、指摘の本文を再掲しない。コミットの sha も書かない(squash マージの後に残らない)
13
+ - Decision には review-findings の方針と違えた点だけを書く。無ければ `- 提案どおり` にする
14
+ - Applied には General への対応と、差分に現れない対応だけを書く。無ければ `- 補足なし` にする
15
+ - Declined には対応不要とした F-NN と理由を書く。無ければ `- 対応しなかった指摘なし` にする
16
+ - 採否は「対応」か「対応不要」で、保留や別 Issue への先送りは無い
17
+ - `-m` の 1 行の投稿は節が欠けて検証で止まる。このファイルを編集してから投稿する
18
+
19
+ 例:
20
+
21
+ ## Resolution — 指摘は 2 件とも直り、方針と違えた点は無い
22
+
23
+ ### Decision — 対応は review-findings の方針のとおりだった
24
+
25
+ - 提案どおり
26
+
27
+ ### Applied — PR 本文に CSV の文字コードの説明が加わった
28
+
29
+ - F-02 — Summary に、UTF-8 で BOM を付けずに書き出すことを書いた
30
+
31
+ ### Declined — 対応しなかった指摘は無い
32
+
33
+ - 対応しなかった指摘なし
34
+ -->
35
+
36
+ ## Resolution — <レビュー対応の結果を1行で>
37
+
38
+ ### Decision — <提案からの乖離を1行で>
39
+
40
+ - <違えた F-NN> — <方針は A、実績は B(理由)>
41
+
42
+ ### Applied — <非インライン指摘と差分外対応を1行で>
43
+
44
+ - F-03 — <対応の補足>
45
+
46
+ ### Declined — <対応不要と判断した理由を1行で>
47
+
48
+ - **F-02** <要旨> — <対応不要とした理由>
@@ -0,0 +1,63 @@
1
+ ---
2
+ title: ""
3
+ type: bug
4
+ repository: ""
5
+ status: ready
6
+ priority: ""
7
+ size: ""
8
+ labels: []
9
+ parent_epic: ""
10
+ order: ""
11
+ ---
12
+
13
+ <!--
14
+ 読者: バグを再現して直す実装者。Repro で再現し、直した後に Acceptance で確かめる。末尾の「例:」の形で書く。
15
+
16
+ 書き方:
17
+ - 見出しの `—` の後は、何がどうなったか(どうなるか)を、主語と述語のある 1 文で書く
18
+ - 長いログは `<details>` に入れる
19
+
20
+ フィールド:
21
+ - repository: 起票先 `owner/repo` 必須
22
+ - parent_epic: `owner/repo/number` 推奨。番号のみは aggregation_repo 解釈なので別リポの Epic を指すなら full path 必須
23
+ - order: 親 Epic 内の通し番号。タイトル先頭が `#{epic}-{order:02d}` で自動生成
24
+ - 起票ルール: skills/w-help/references/issue-flow-rules.md (投稿先 / parent_epic / order の判定基準)
25
+
26
+ 例:
27
+
28
+ ## Problem — `list --sort date` が日付を文字列として並べる
29
+
30
+ `2026-10-02` が `2026-9-30` より前に並ぶ。環境: Linux・mytool 1.3.0
31
+
32
+ | 期待する動き | 今の動き |
33
+ |---|---|
34
+ | 日付の古い順に並ぶ | 文字列の順に並ぶ |
35
+
36
+ ### Repro
37
+
38
+ 1. `mytool add --date 2026-9-30 a` と `mytool add --date 2026-10-02 b` を打つ
39
+
40
+ 2. `mytool list --sort date` を打ち、`b` が `a` より前に並ぶことを見る
41
+
42
+ ## Acceptance — `--sort date` が日付の古い順に並べる
43
+
44
+ - Repro の手順で、`a` が `b` より前に並ぶ — 確認: Repro の手順を打つ
45
+ -->
46
+
47
+ ## Problem — <何が起きているか1行で>
48
+
49
+ <何をしたら何が起きるか。環境と、期待する動き・今の動きの表>
50
+
51
+ | 期待する動き | 今の動き |
52
+ |---|---|
53
+ | <本来の動き> | <今起きている動き> |
54
+
55
+ ### Repro
56
+
57
+ 1. <手順>
58
+
59
+ 2. <手順>
60
+
61
+ ## Acceptance — <直った状態を1行で>
62
+
63
+ - <外から見える状態> — 確認: <判定の手段>
@@ -0,0 +1,54 @@
1
+ ---
2
+ title: ""
3
+ type: epic
4
+ repository: ""
5
+ status: backlog
6
+ priority: ""
7
+ size: ""
8
+ labels: []
9
+ parent_epic: ""
10
+ ---
11
+
12
+ <!--
13
+ 読者: この Epic を分解する人(/pecot-w:w-ready・/pecot-w:w-breakdown を回す人と AI)。GAP と sub-issue の表示を見比べて次の 1 件を決め、AS-IS が TO-BE に届いたら Epic を閉じる。末尾の「例:」の形で書く。
14
+
15
+ 書き方:
16
+ - 見出しの `—` の後は、何がどうなったか(どうなるか)を、主語と述語のある 1 文で書く
17
+ - GAP は、AS-IS と TO-BE の差を書く。サブタスクや Issue へのリンク・担当・進み具合は書かない(sub-issue の表示とボードが見せる)
18
+
19
+ フィールド:
20
+ - repository: aggregation_repo 設定済みなら自動補完。未設定 or 例外時のみ `--repo` で明示
21
+ - 起票ルール: skills/w-help/references/issue-flow-rules.md (投稿先の判定基準)
22
+
23
+ 例:
24
+
25
+ ## AS-IS — 表計算ソフトの利用者が JSON を手で変換している
26
+
27
+ - 書き出しの形式は JSON だけ — 問い合わせの 3 割が変換の方法
28
+
29
+ - 並べ替えは文字列の比較だけ — 日付と数値の列で順が崩れる
30
+
31
+ ## TO-BE — 表計算ソフトの利用者が変換なしで出力を使える
32
+
33
+ - **CSV で書き出せる**
34
+
35
+ - **日付と数値の列が、値の順に並ぶ**
36
+
37
+ ## GAP — 書き出しの形式と並べ替えの比較が足りない
38
+
39
+ - 書き出し — CSV の形式が無い
40
+
41
+ - 並べ替え — 列の型に合わせた比較が無い
42
+ -->
43
+
44
+ ## AS-IS — <現状を1行で>
45
+
46
+ - <事実> — <数字・実例での裏付け>
47
+
48
+ ## TO-BE — <完了時の状態を1行で>
49
+
50
+ - **<残るもの・変わるもの>**
51
+
52
+ ## GAP — <埋めるべき差分を1行で>
53
+
54
+ - <差のある場所> — <AS-IS と TO-BE の差>
@@ -0,0 +1,67 @@
1
+ ---
2
+ title: ""
3
+ type: task
4
+ template: task-implement
5
+ repository: ""
6
+ status: ready
7
+ priority: ""
8
+ size: ""
9
+ labels: []
10
+ parent_epic: ""
11
+ order: ""
12
+ parallel: ""
13
+ ---
14
+
15
+ <!--
16
+ 読者: フェーズを実行する実装者。Artifacts の spec と plan を読んで Tasks を進め、Acceptance で完了を判定する。末尾の「例:」の形で書く。
17
+
18
+ 書き方:
19
+ - Tasks は、tasks.md のこのフェーズのタスクを過不足なく写す。記法 `T001 [P] [US1] 説明(ファイルパス含む)` のまま、1 行に 1 タスク
20
+ - Acceptance は、Tasks と同じく tasks.md のこのフェーズから写す。`**Checkpoint**:` の行と、あれば `**Independent Test**:` の行を、言い換えずに 1 行に 1 つ写す
21
+ - Artifacts は、speckit の一式を置いたディレクトリを 1 つ、実パスで書く。外部のリポにあるときは `owner/repo:specs/NNN-*/` の形
22
+
23
+ フィールド:
24
+ - repository: 実装が行われるリポ `owner/repo` 必須
25
+ - parent_epic: 親 Epic を `owner/repo/number` で指定(推奨)
26
+ - order: フェーズの段(依存グラフの層)。タイトル先頭が `#{epic}-{order:02d}` で自動生成
27
+ - parallel: 同じ段に 2 件以上あるときだけ入れる枝の文字(`a`〜`z`)。タイトル先頭が `#{epic}-{order:02d}{parallel}` になる
28
+ - 起票ルール: skills/w-help/references/issue-flow-rules.md (投稿先 / parent_epic / order の判定基準)
29
+
30
+ 例:
31
+
32
+ ## Goal
33
+
34
+ `mytool export --format csv` で、CSV のファイルを書き出せるようにする。書き出しの処理に形式の選択を足し、CSV の書き手を新しく加える。
35
+
36
+ ## Tasks
37
+
38
+ - T004 [US1] `src/export.py` に `--format` を足し、選んだ形式の書き手に書き出しを渡す
39
+ - T005 [P] [US1] `src/writers/csv.py` に、`mytool list` と同じ列の順で書く CSV の書き手を足す
40
+
41
+ ## Acceptance
42
+
43
+ - Checkpoint: この時点で、CSV の書き出しが単独で動き、確かめられる
44
+ - Independent Test: `mytool export --format csv` で書き出したファイルを表計算ソフトで開き、列がずれずに並ぶことを見る
45
+
46
+ ## Artifacts
47
+
48
+ `acme/mytool:specs/012-csv-export/`
49
+ -->
50
+
51
+ ## Goal
52
+
53
+ <このフェーズが終わると何ができるようになるか>
54
+
55
+ ## Tasks
56
+
57
+ - T001 [P] [US1] <説明(ファイルパス含む)>
58
+ - T002 [US1] <説明(ファイルパス含む)>
59
+
60
+ ## Acceptance
61
+
62
+ - Checkpoint: <tasks.md のこのフェーズの Checkpoint>
63
+ - Independent Test: <tasks.md のこのフェーズの Independent Test。無ければこの行を消す>
64
+
65
+ ## Artifacts
66
+
67
+ `<owner/repo>:specs/<NNN-feature>/`
@@ -0,0 +1,48 @@
1
+ ---
2
+ title: ""
3
+ type: task
4
+ repository: ""
5
+ status: ready
6
+ priority: ""
7
+ size: ""
8
+ labels: []
9
+ parent_epic: ""
10
+ order: ""
11
+ ---
12
+
13
+ <!--
14
+ 読者: /pecot-w:w-active で plan を立てる実装者と、完了を判定する人。末尾の「例:」の形で書く。
15
+
16
+ 書き方:
17
+ - 見出しの `—` の後は、何がどうなったか(どうなるか)を、主語と述語のある 1 文で書く
18
+
19
+ フィールド:
20
+ - repository: 起票先 `owner/repo` 必須
21
+ - parent_epic: `owner/repo/number` 推奨。番号のみは aggregation_repo 解釈なので別リポの Epic を指すなら full path 必須
22
+ - order: 親 Epic 内の通し番号。タイトル先頭が `#{epic}-{order:02d}` で自動生成
23
+ - 起票ルール: skills/w-help/references/issue-flow-rules.md (投稿先 / parent_epic / order の判定基準)
24
+
25
+ 例:
26
+
27
+ ## Goal — `mytool export` が CSV を書き出せる
28
+
29
+ 今は JSON しか書き出せず、表計算ソフトで開くには利用者が自分で変換している。
30
+
31
+ | コマンド | 今 | 達成後 |
32
+ |---|---|---|
33
+ | `mytool export --format csv` | エラーで止まる | CSV を書き出す |
34
+
35
+ ## Acceptance — CSV が表計算ソフトでそのまま開ける
36
+
37
+ - `mytool export --format csv` の出力が、表計算ソフトで列のずれなく開ける — 確認: 実際に書き出して開く
38
+
39
+ - `--format` を省くと、今までどおり JSON を書き出す — 確認: `mytool export` の出力を読む
40
+ -->
41
+
42
+ ## Goal — <達成したい状態を1行で>
43
+
44
+ <利用者から見て何が変わるか。今と達成後の比較は表にする>
45
+
46
+ ## Acceptance — <達成判定を1行で>
47
+
48
+ - <外から見える状態> — 確認: <判定の手段>
@@ -0,0 +1,48 @@
1
+ ---
2
+ title: ""
3
+ type: tracker
4
+ repository: ""
5
+ status: backlog
6
+ priority: ""
7
+ size: ""
8
+ labels: []
9
+ parent_epic: ""
10
+ ---
11
+
12
+ <!--
13
+ 読者: この Tracker が束ねる対象を追う人(運用する人と AI)。何を束ね、どう運用するかを確かめて、sub-issue の表示と見比べる。末尾の「例:」の形で書く。
14
+
15
+ 書き方:
16
+ - 見出しの `—` の後は、何がどうなったか(どうなるか)を、主語と述語のある 1 文で書く
17
+ - 束ねる対象は、対象の種類と集め方を書く。個々の Issue へのリンク・担当・進み具合は書かない(sub-issue の表示とボードが見せる)
18
+
19
+ フィールド:
20
+ - repository: `--repo owner/repo` 必須(Tracker は aggregation_repo へ寄せない)
21
+ - 起票ルール: skills/w-help/references/issue-flow-rules.md (投稿先の判定基準)
22
+
23
+ 例:
24
+
25
+ ## Scope — 依存パッケージの脆弱性の通知を、このリポジトリの Issue として束ねる
26
+
27
+ - 束ねる対象 — 依存パッケージの脆弱性の通知 1 件につき sub-issue 1 件
28
+
29
+ - 集め方 — 毎時の確認が、新しい通知を sub-issue に足す
30
+
31
+ ## Operation — 通知が直ったら、その sub-issue を閉じる
32
+
33
+ - 閉じ方 — 通知が解消したら sub-issue を閉じる
34
+
35
+ - この Issue — sub-issue を持つ間は閉じない
36
+ -->
37
+
38
+ ## Scope — <束ねる対象を1行で>
39
+
40
+ - 束ねる対象 — <対象の種類と、sub-issue 1 件の単位>
41
+
42
+ - 集め方 — <sub-issue を足す手段>
43
+
44
+ ## Operation — <運用の決まりを1行で>
45
+
46
+ - 閉じ方 — <sub-issue を閉じる条件>
47
+
48
+ - この Issue — <この Issue を閉じる条件>