spec(task): rename the done state label to review-pending and fix its boundary against waiting and blocked [rules/task, skills, docs] - #1682
Open
liplus-lin-lay wants to merge 1 commit into
Conversation
…, skills, docs] Rename the state-machine label `done` to `review-pending`, and fix its boundary against `waiting` / `blocked` in the same change. 状態機械ラベル `done` を `review-pending` へ改名した。仕様側の literal は `awaiting orchestration` であって `undergoing` ではなく、ラベル単体では 「何が done なのか」が落ちる。加えて `done` は close 操作と同じ「完了」を 名乗り、層が食い合っていた。`review-pending` は「能動状態 1 つ + 何を待って いるかで名付けた待機状態」という既存の家族に入り、subagent の exit 時点 （親はまだ brake 1 を回していない）でも真である。 同時に `waiting` / `blocked` との境界を literal 化した。semi_auto の minor / major における人間の PR レビュー待ちは `review-pending` に留まり、 `blocked` にはしない（完成物への裁定を求める待ちであって、作業が必要とする 入力を求める待ちではないため）。併記は許さず、同時に立つのは 1 つだけとした。 Changes: - rules/task/task.md: Lifecycle 定義の改名 + state-machine subset の境界 literal 追加 - skills/task-subagent-state-labels/SKILL.md: description と MUST mandate の改名、blocked 行に境界の参照を追加 - docs/3.-Task.md: ライフサイクルラベル表に state-machine subset 3 種を補完（ミラー欠落の修復）+ 境界の日本語ミラー - docs/4.-Operations.md: 廃止ラベル表の `done` 行を改名記録へ更新、見出しを「廃止・改名」へ - docs/Decision-Structure.md: index 行の label 名更新（wiki 本体は導入時の名前を保持するため改名を注記） GitHub 側のラベルは `gh label edit done --name review-pending` で改名済み （削除ではないため、既存 issue の付与は保たれている）。 Refs #1681
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #1681
変更内容
状態機械ラベル
doneをreview-pendingへ改名し、同じ PR でwaiting/blockedとの境界を literal 化した。改名
rules/task/task.mdskills/task-subagent-state-labels/SKILL.mddocs/3.-Task.mddocs/Decision-Structure.mdgh label edit done --name review-pending実行済み（説明文も更新）境界の決定（issue の制約「同時に literal で決めること」への回答）
rules/task/task.mdに以下を追加した。review-pendingを立てる（blockedにしない）。理由は待ちの主語であり、完成した実装への裁定を人間に求める待ちと、作業を進めるために人間の入力が要る待ちは別物であるExactly one holds at a time.を明記したskills/task-subagent-state-labels/SKILL.mdのblocked行にも適用モーメント側の参照を置いた掃き出しの結果
doneの残存は以下の 2 箇所のみで、いずれも改名の記録であり状態機械ラベルとしての用法ではない。docs/4.-Operations.md廃止ラベル表 — 従前の行「issue の closed 状態と冗長」は spec(task+operations): introduce state-machine labels with partial subagent authority #1277 で撤回済みの理由が残っていた（正本rules/operations/operations.mdからは削除済み、docs ミラーだけ取り残されていた）。改名の記録へ更新し、見出しを「廃止・改名されたラベル」に直したdocs/Decision-Structure.md— wiki 本体subagent-state-machine-label-mechanismは導入時の判断記録としてdoneの名前を保持するため、index 行に改名の注記を置いたその他の
done（consume/doneの通知意味論、bash のdone、地の文）は別軸のため対象外とした。ミラー欠落の修復
docs/3.-Task.mdのライフサイクルラベル表にはin-progress/backlog/deferredしか無く、#1277 で追加された state-machine subset 3 種（done/waiting/blocked）が落ちていた。改名のミラー同期にあたり表を補完した。表の導入文も「いつ着手するか」から「着手・進行・待機の状態」へ直した（待機状態が入ったため）。対象外
adapter/claude/CLAUDE.md/adapter/codex/AGENTS.md—doneの出現なし。parity 作業は不要--label in-progressのみでdoneを参照していない確認
python -m unittest discover -s tests→ 56 tests OKgh label listでreview-pendingの存在とdoneの消滅を確認gh issue list --label review-pending --state allで既存 issue の付与が保たれていることを確認（改名であり削除ではないため）版種
patch。
rules/operations/release-version-rule.mdの minor は large かつ user/system observable の二条件であり、本件は observable だがラベル 1 個の改名 + 掃き出しであって large ではない。残作業（この PR の外）
wiki
subagent-state-machine-label-mechanismはdoneを現行ラベル名として記述している。Decision Structure entry は wiki が正本であり、改名を反映するか supersede edge を張るかは wiki 側の作業となる。