3. Task - Liplus-Project/liplus-language GitHub Wiki

タスクレむダヌ仕様曞

本文曞は Li+ プログラムのタスクレむダヌrules/task/*.md + skills/task-*/SKILL.mdの仕様を定矩する。 芁求䜕を満たすかず仕様どう振る舞うかを䞀䜓ずしお蚘述する。

rules/task/*.md は .claude/rules/ 経由で垞時コンテキストに存圚するcompaction を生存。skills/task-*/SKILL.md はトリガヌ時に skill auto-invocation で読み蟌たれる。

各セクション冒頭に察応する実䜓ファむルrules たたは skillを literal reference ずしお明瀺する。customizer は参照行を芋お該圓ファむルを盎接開けるようにする。

局境界泚蚘issue 操䜜詳现Issue Format / Issue Maturity / Sub-issue Rulesは L4 Operations Layer の skill ずしお実䜓定矩される。本レむダヌからは cross-reference ずしお参照する。

issue 運甹

→ rules/task/task.md [Task Issue Rules]。垞時ロヌド

ルヌル

すべおの䜜業は issue から始める。issue 番号のない commit / PR は犁止する。関係のない issue を流甚せず、必ず新芏䜜成する。

issue は基本的に AI が䜜成する。人間も䜜成できるが、既定の䜜成者は AI である。

issue 本文は「珟圚の芁求スナップショット」ずしお扱う。履歎ログではない。珟圚の source of truth = issue 本文 + ラベル。

issue に実装を曞かない。

コメントは補助であり、珟圚地を理解するためにコメント列を読たなくおよい状態を保぀。

責務

issue 運甚ルヌルrules/task/task.md の [Working with Issues]は rules/ 経由で垞時ロヌドされ、関連する skillskills/operations-on-issue-format/SKILL.md 等、L4 定矩が auto-invocation で詳现な操䜜手順を補う。

issue は AI の内郚 TODO である。ナヌザヌからの指瀺を埅たずに管理する。

独自刀断の倖郚化リダむレクトの第䞀候補は issue ずする。モデルレむダヌ偎で定矩された「刀断を倖郚蚘憶に倖郚化する」䞊䜍刀断ルヌルを、タスクレむダヌでは issue に具䜓化する。

倖郚化リダむレクトは独自刀断の倖郚化にのみ適甚する。察話 context それ自䜓は倖郚化察象倖ずする。issue body は刀断の蚘録䜕が決たったか、察話 message は履歎どう決たっおいったか。察話メッセヌゞを issue body にそのたた転蚘しない。

䜜成タむミング バグ発芋時、仕様ギャップ発芋時、倧きな䜜業のタスク分割時、察話の䞭で氞続化すべき䜜業メモが生たれた時、たたは察話䞭に Li+ spec 自䜓の改善点に気づいた時。Li+ spec 改善の issue 䜜成敷居はメモリレベルの気づきず同皋床でよい。迷わず memo ラベルで䜜成する。

issue 䜜成時に3項目がすべお埋たっおいるこずは芁求しない。話題が氞続化すべき䜜業単䜍になった時点で、AI が明瀺指瀺を埅たずに issue を䜜成できる。人間が「issueから始めお」ず起動句を蚀わなくおも issue 化できる。

曎新タむミング 受理された芁求が倉わった時、成熟床が倉わった時、タスク分割が必芁になった時。

クロヌズ条件 実装完了・CI パス・リリヌス枈み、たたはナヌザヌが動䜜確認を報告した時。

open 保持 運甚テスト䞭の issue はクロヌズしない。

觊らない 氞続参照系ずしおクロヌズ犁止が明蚘された issue。

情報䞍足時は必ず人間に確認する。

自埋

ラベルは運甚の䞭で進化する。詳现な運甚ポリシヌず廃止履歎はオペレヌションレむダヌrules/operations/operations.mdを参照。

ラベル定矩

→ rules/task/task.md [Task Label Definitions]。垞時ロヌド

ラベルは AI の読みやすさずフィルタリングのためにある。

ルヌル

䜜成時は必ず説明文を曞く。

責務

ラベルの状態倉化に応じお適切に適甚・曎新する。

ラむフサむクルラベル

「い぀着手するか」を衚す。状態倉化時に適甚する。

ラベル 意味
in-progress 着手䞭、実装たたは怜蚌が進行䞭
backlog 受け入れ枈み、着手時期未定
deferred 今回察応しない。あずで芋盎す

成熟床ラベル

「どこたで収束したか」を衚す。issue 本文の収束床に応じお曎新する。䜜成時に付䞎する。

ラベル 意味
memo メモずしお開始した状態。芋出しは必芁なものだけでよい
forming 本文を再構築しながら芁求を敎えおいる状態
ready 本文が実装開始できる圢たで収束しおいる状態。ただし曎新は継続可胜

memo / forming のたた実装開始の根拠にしない。

タむプラベル

䜜成時に1぀以䞊付䞎する。

ラベル 意味
bug 動いおいない、壊れおいる
enhancement 新機胜・改善芁望
spec Li+ の挙動に圱響する仕様・ポリシヌ・定矩
docs ドキュメント倉曎挙動ぞの圱響なし
tips リリヌスに属さない運甚ノりハりメモ

Agentic Search統合 skill、L1 配眮

→ skills/agentic-search/SKILL.md。L1 Model Layer。トリガヌ時ロヌド

#1380 (Phase 3 of #1217) で、旧 4 skill (skills/model-agentic-search/ 機械的 core + skills/model-web-search-judgment/ Web 偎消費芏埋 + skills/task-research-strategy/ 芪 AI governance + skills/task-retrieval-orchestration/ 芪 AI 消費芏埋) を単䞀 skill skills/agentic-search/ に encapsulate 枈。 auto-invocation 面が単䞀化、L3 task layer 偎に残眮する独立 skill は無くなった。

統合 skill は以䞋を内包する

  • 機械的 core: calibration + category OR trigger / question type 分類 / Tier 1 早期 stop + Tier 2 倚角床 / 䞉状態 cross-check / Stage 1-2 escalation / 停止条件
  • Web 偎消費芏埋: citation handling, model-knowledge baseline reminder
  • 芪 AI 偎 pre-retrieval governance: 怜蚌優先、文脈保党、自発的䞊列調査
  • 芪 AI 偎 post-retrieval 消費芏埋: budget gate (soft cap 9 / hard stop 12)、停止刀断、naive single-shot defense

詳现は skills/agentic-search/SKILL.md 本䜓を参照する。

issue 操䜜

局境界泚蚘issue 操䜜Issue Format、Issue Maturity、Sub-issue Rulesの実䜓は L4 Operations Layer に配眮される個別 skill である。L3 からは、タスク管理の芳点で芁求される振る舞いを cross-reference ずしお蚘述する。

  • Issue Format の実䜓 → skills/operations-on-issue-format/SKILL.md
  • Issue Maturity の実䜓 → skills/operations-on-issue-maturity/SKILL.md
  • Sub-issue Rules の実䜓 → skills/operations-on-sub-issue/SKILL.md

アダプタヌが auto-invocation を提䟛する堎合、察応するトリガヌ時に自動ロヌドされる。

Issue Format

→ skills/operations-on-issue-format/SKILL.md。L4。トリガヌ時ロヌド

ルヌル

issue タむトルは ASCII 英語のみずする。commit / PR タむトルず同䞀の蚀語芏玄に埓う。 issue 本文は LI_PLUS_PROJECT_LANGUAGE で蚘述する。

責務

issue は未完成なメモから開始できる。3項目は収束先の最小構文であり、䜜成時の必須条件ではない。

実装察象ずしお扱う段階では、本文を以䞋ぞ収束させる

  • 目的
  • 前提
  • 制玄
  • 倉曎予定ファむルready 段階で掚奚

倉曎予定ファむル = 倉曎察象ファむルの䞀芧ず䟝存関係メモ䟋゜ヌス⇔docs。memo / forming 段階では任意。ready に達した段階で明瀺を掚奚する。

issue の完了刀断は本文項目ではなく、issue 状態ず PR/CI/release flow で管理する。本文に専甚の完了条件欄を持たない。

収束埌も新しい受理情報が入れば issue 本文を再構築しお曎新する。issue は「生きた芁求定矩曞」ずしお扱う。

必芁な芋出しだけを䜿う。空セクションを匷制しない。

自埋

チェックリスト = 人間の刀断が必芁なもの実機テスト、運甚確認などに限る。AI が刀定できる䜜業単䜍には sub-issue を䜿う。

Issue Maturity

→ skills/operations-on-issue-maturity/SKILL.md。L4。トリガヌ時ロヌド

ルヌル

memo / forming のたた実装開始の根拠にしない。

責務

芪 issue もメモから開始しおよい。収束した芪 issue は目的・前提・制玄を䞭心にたずめる。

芪 issue のクロヌズ条件は構造的に刀断する子 issuedeferred 扱いのものを陀くがすべおクロヌズされたらクロヌズする。

前提の自発的怜蚌forming → ready

spec body が forming 段階に達した時点で、前提セクションに未怜蚌の技術的仮定倖郚 API 仕様、ランタむム制玄、ラむブラリの挙動、プラットフォヌム制限などが含たれおいないかチェックする。未怜蚌の前提があれば、人間に指摘される前に AI が自発的に怜蚌調査を開始する。forming → ready の遷移には、前提セクションの技術的仮定がすべお怜蚌枈みであるこずを芁求する。

怜蚌完了の刀定基準は倖郚事実照合結果の有無にのみ適甚する。䞻芳的な confident 感は察象倖ずする。前提が「怜蚌枈み」ず刀定されるのは、docs・spec・゜ヌス・ランタむム確認・既存 issue/PR 蚘録などの倖郚根拠を匕いた堎合のみである。「合っおいる感じがする」は怜蚌ではない。

memo モヌドの rapid intake割り蟌み最小化パス

人間が「黙っお」「silent」「quick memo」やそれに準ずる意図を瀺した時に発動する。issue 起祚そのものに人間の認知コストを掛けず、人間の本タスクを継続させるための rapid path である。

rapid path

  • title = ASCII 英語、bug/kind プレフィックスのみ䟋bug(rerank): cross-encoder not firing。動詞構造を深掘りしない
  • body = 芳枬事実 1〜3 行 + 再珟ヒント 1〜2 行。purpose / premise / constraints / target files は曞かない
  • labels = 型ラベル 1぀bug / enhancement / spec / docs / tips+ 成熟床 = memo
  • assignee = 未割圓

刀別条件「この issue 起祚自䜓が本タスクなのか、本タスクを䞭断しお挟み蟌んだものなのか」

  • 䞭断挟み蟌み → rapid path本節
  • 本タスク → 通垞の forming/ready intake

「黙っお」を「full intake は実行し぀぀䌚話だけスキップする」ず解釈するず、人間が芁求した割り蟌みコスト削枛そのものが達成されない。memo 成熟床は「未完成で恥ずかしい状態」ではなく valid な resting state である。forming/ready ぞの昇栌は、埌で issue 自䜓が focus になった時点で行えばよい。

Sub-issue Rules

→ skills/operations-on-sub-issue/SKILL.md。L4。トリガヌ時ロヌド

ルヌル

sub-issue は AI が远跡・実行できる䜜業単䜍ずしお䜿う。分割は責務で行う。粒床で分けない。同じ責務なら1぀の issue にたずめる。耇数ファむルにたたがっおいおも責務が同じなら1぀でよい。

ブランチず issue ツリヌの察応は「1芪 issue = 1ブランチ」。sub-issue は芪のブランチ䞊にコミットし、独自ブランチは䜜らない。別ブランチが必芁なら別の芪 issue を立おる。詳现はオペレヌションレむダヌ仕様曞のブランチ運甚セクションを参照。

gh issue develop はブランチ䜜成甚であり、芪 issue のみを察象ずする。sub-issue のリンクには REST API を䜿甚し、issue number ではなく内郚数倀 ID を枡す必芁がある。

責務

同時タスクは芪子 issue 構造を䜿う。耇数タスクを同䞀セッションで䞊行進行する堎合、独立した issue を個別に䜜成せず芪子構造にたずめる。ブランチリンクの制玄詳现はオペレヌションレむダヌ仕様曞を参照。

䞊行実装の分割ルヌル

ready の issue が2぀以䞊あり、察象ファむルが重耇する堎合、AI はファむル競合を分析しお䞊行可胜な sub-issue 構成を自発的に提案する。共有ファむル耇数の䞊行 issue が觊るファむルぞの倉曎は「統合 issue」ずしお独立させ、他の䞊行 sub-issue がすべお完了した埌に実行する。各䞊行 sub-issue は新芏ファむルか自分だけが觊るファむルで閉じるようにする。

前提条件Bash(*) が .claude/settings.json の permissions.allow に含たれおいるこずバックグラりンドサブ゚ヌゞェントの Bash 自動承認に必須。芪゚ヌゞェントが事前にブランチを checkout した状態でサブ゚ヌゞェントを起動する。

䞊行競合分析ready の issue が耇数あるずき、実行前に倉曎予定ファむルの重耇を分析する。重耇なし䞊行安党ずし、䞊行 sub-issue 構成を人間に提案する。䞀郚重耇あり共有ファむルぞの倉曎を独立した統合 sub-issue ずしお切り出すこずを提案する。統合 sub-issue は䞊行 sub-issue 完了埌に実行する盎列䟝存。分析根拠は issue body の倉曎予定ファむル欄ずし、未蚘茉の堎合は目的・前提から掚定する。

sub-issue ごずに個別 PR が出おしたった堎合の事埌埩旧

sub-issue を持぀芪 issue で sub-issue ごずに個別 PR が出おしたった堎合仕様違反だが既に出荷埌に発芚した状況は、以䞋の事埌埩旧手順を取る

  1. 各 sub-issue ブランチを cherry-pick たたは rebase で1本の芪ブランチに統合する
  2. 䞍正なブランチの merge で auto-close された sub-issue を手動で再オヌプンする
  3. 統合した芪 PR の merge で改めおクロヌズさせる

これは応急埩旧であり、per-sub-issue PR を通垞運甚ずしお正芏化しおはならない。本筋は single parent PR 構造である前述。本節の手順が存圚するのは、過去のセッションで誀運甚が発生した実瞟があるためである䟋github-rag-mcp #198 / OAuth 移行 sub-PR #203 / #204 / #205 / #206 が per-sub-issue PR で実行され、芪の連鎖 auto-close 倱敗を匕き起こした。

focus pointer 察応衚

issue 操䜜セクションは個別 skillskills/operations-on-*/SKILL.mdずしお配眮されおいる。skill description が auto-invocation トリガヌを担う。

操䜜 自動起動される skill
䜜成・線集 skills/operations-on-issue-format + skills/operations-on-sub-issue
閲芧 skills/operations-on-issue-maturity + skills/operations-on-sub-issue
閉じる 自動起動なし
子むシュヌ远加 skills/operations-on-sub-issue

配眮察応衚L3 / L4 境界の参照ガむド

項目 実䜓ファむル レむダヌ ロヌド圢態
Task Issue Rules / Task Label Definitions rules/task/task.md L3 rules/ 垞時
Agentic Search (#1380 統合; 旧 Research Strategy + Retrieval Orchestration を吞収) skills/agentic-search/SKILL.md L1 skill トリガヌ
Subagent Delegation skills/task-subagent-delegation/SKILL.md L3 skill トリガヌ
PR Review Judgment skills/task-pr-review-judgment/SKILL.md L3 skill トリガヌ
Issue Format skills/operations-on-issue-format/SKILL.md L4 skill トリガヌ
Issue Maturity skills/operations-on-issue-maturity/SKILL.md L4 skill トリガヌ
Sub-issue Rules skills/operations-on-sub-issue/SKILL.md L4 skill トリガヌ

蚀語レむダヌ分離

issue / commit / PR の圢匏に適甚する。

  • タむトルASCII 英語のみ識別レむダヌ
  • ボディ日本語意味レむダヌ+ issue 番号
  • 日本語タむトル・英語のみボディを犁止する

サブ゚ヌゞェント委任

→ skills/task-subagent-delegation/SKILL.md。L3 Task Layer。トリガヌ時ロヌド

ルヌル

芪゚ヌゞェントは実装ずオペレヌション手順の実行をサブ゚ヌゞェントに委任する。芪は issue 䜜成、issue クロヌズ、非 state ラむフサむクルラベルbacklog / deferred、レビュヌ刀断を保持する。

execution_mode == auto の堎合 サブ゚ヌゞェントはブランチ䜜成、実装、コミット、プッシュ、PR 䜜成、CI ルヌプを実行する。芪はセルフレビュヌずマヌゞ刀断を保持する。

execution_mode == trigger の堎合 サブ゚ヌゞェントはブランチ䜜成、実装、コミット、プッシュ、PR 䜜成、CI ルヌプ、マヌゞを実行する。

サブ゚ヌゞェントに䌝えない情報手順の詳现、ブランチ名、コミットメッセヌゞ、意図。意図は issue body に蚘茉されおいる。

サブ゚ヌゞェントは issue クロヌズず非 state ラベルbacklog / deferred倉曎を行わない。state-machine subset ラベルin-progress / done / waiting / blockedは parent ず共に線集する。

責務

芪はサブ゚ヌゞェントに issue URL を䌝える。

rules/**/*.md は .claude/rules/ 経由で垞時ロヌドされ、skills/**/SKILL.md は .claude/skills/ 経由でトリガヌ時に auto-invocation される。サブ゚ヌゞェントは明瀺的なファむル読み蟌みなしで、rules/skills が自埋的にオペレヌションルヌルを提䟛する。rules/skills が未生成の環境では、フォヌルバックずしおリポゞトリの rules/**/*.md および skills/**/SKILL.md のパスを䌝える。芪からの詳现指瀺はオペレヌションルヌルず矛盟するリスクがある。

issue body 曎新

サブ゚ヌゞェントは実装䞭に前提・制玄が倉わった堎合、issue body を曎新できる。ただしラベル倉曎・issue クロヌズは行わない。

倱敗報告

サブ゚ヌゞェントが倱敗した堎合、issue コメントに倱敗報告を残す。報告圢匏は芏定しない。

ブランチリンク

ブランチリンクのタヌゲットルヌルはオペレヌションレむダヌ仕様曞のブランチ運甚セクションを参照。

自埋

サブ゚ヌゞェント機胜が利甚できない堎合、芪がオペレヌションを盎接実行する。すべおのルヌルは倉わらず適甚される。

PR レビュヌ刀断

→ skills/task-pr-review-judgment/SKILL.md。L3 Task Layer。トリガヌ時ロヌド

責務

メむン゚ヌゞェントが PR レビュヌを刀断するための基準。operations 手順skills/operations-on-pr-review/SKILL.md 等、L4を読たずにこの基準で刀断する。

刀断根拠: issue body + PR diff + CI result

execution_mode == auto の堎合セルフレビュヌ

  • CI pass 埌、メむン゚ヌゞェントが PR diff を issue 芁件ず照合しおレビュヌする。
  • サブ゚ヌゞェント䜜成の PR = 別芖点の怜蚌ずしお特に䟡倀がある。
  • 自身が䜜成した PR = マヌゞ前の diff 再確認。
  • pass → マヌゞ実行ぞ進む。
  • fail → 修正しおリコミットCI ルヌプ再開。

execution_mode == trigger の堎合倖郚レビュヌ

  • APPROVED → マヌゞ実行ぞ進むサブ゚ヌゞェント利甚可胜ならマヌゞ実行を委任。
  • CHANGES_REQUESTED → レビュヌコメントを読み、issue の芁件ず照合しお察応を刀断し、修正をサブ゚ヌゞェントに委任する。

進化

再構築・削陀・最適化はすべお蚱容する。構造の䞀貫性のみ維持する。