Skip to content
frontmatter
キー値
specdojo.idprj-0001:pjr-eank-agent-members-alias-schema
specdojo.typeproject
specdojo.statusready
specdojo.rulebookspecdojo:pjr-rulebook
specdojo.part_ofprj-0001:pjr-index
specdojo.item_typetodo
specdojo.item_statusdone
specdojo.prioritymedium
specdojo.ownerDEV
specdojo.registered_at2026-10-14T22:18:18Z
specdojo.completed_at2026-10-18T07:21:26Z
specdojo.conclusionagent-members の schema に実体の model・effort と、実体を指す別名(aliases、alias_of)を加えた。名簿の読み込みで別名の循環・存在しない実体・無効な実体を指す別名を、名簿のファイルと名前を含めてエラーにする。今の 1 段の名簿もそのまま読める。名前の解決は PJR-YK1C で行う

PJR-EANK agent の名簿の schema に実体の model と別名を加える ​

1. 概要 ​

agent-members の schema に、実体の provider・model・effort と、別名(実体を指す名前)を加え、検証(別名の循環・存在しない実体・無効な実体を指す別名)を入れる。 PJR-ZM1K の決定に基づく(Y8P9 の完了後、0.4.0)

2. 完了条件 ​

  • agent-members の schema(docs/specdojo/schemas/v1/agent-members.schema.yaml)に、実体の provider・model・effort・役割と、別名(実体を指す名前)を加える。
  • 実体の名前は model の系統(opus・sonnet・sol・terra・flash など)と役割で付け、版は model の欄に書く。既定でない provider の実体は provider の名前を前に付ける(agy-opus-executor など)。この命名を schema の説明か specdojo:exec-config-guide に書く。
  • 名簿の読み込みで、別名の循環、存在しない実体を指す別名、無効(disabled)な実体を指す別名をエラーにする。エラーのメッセージには名簿のファイルと名前を含める。
  • 今の 1 段の名簿(別名のない形)もそのまま読める。
  • 単体テストで、正しい 2 段の名簿、今の 1 段の名簿、3 通りのエラーを確かめる。
  • 本件では名前の解決(--executor-by などや自動選択)は変えない(PJR-YK1C で行う)。
  • 作業を終える前に、npm run typecheck・npm run lint:ts・npm run test:unit を実行して通す。
  • 親の検証(lint-ts・lint-fm・lint-md・typecheck・test-unit・test-integration・validate-schema)が通る。
  • CHANGELOG に記載する場合は、未公開の版の節(## [0.4.0] - 未定)に書く。公開済みの版の節は変えない。

3. 作業内容 ​

No作業担当状態メモ
1agent の名簿の schema に実体と別名を加えるDEVdonemembers に model・effort、トップレベルに aliases を追加し、読み込み時の意味検証を実装

4. 対応結果 ​

  • agent-members.schema.yaml の member に任意の model・effort を追加し、nickname と alias_of からなる任意の aliases を追加した。既存の aliases がない一段形式は引き続き有効とした。
  • loadMemberRoster で alias の連鎖を検証し、循環、存在しない member で終わる連鎖、disabled: true の member で終わる連鎖を、名簿ファイルと alias 名を含むエラーとして拒否するようにした。名前解決は行わず、検証済みの aliases を roster に保持するだけとした。
  • 実体名はモデルの系統と役割で付け、版は model に記録し、既定でない provider は名前の先頭に付ける規則を exec設定ガイド に記載した。
  • schema と読み込み処理の単体テストに、正しい二段形式、既存の一段形式、循環、存在しない実体、無効な実体のケースを反映した。
  • 名前解決、コマンドへの model の展開、actor への実体名の記録は本件では変更しておらず、PJR-YK1C の対象として残る。

5. 関連ドキュメント ​