Skip to content

スライド: 作り方の手順が NDF に無く、AI が毎回その場で作り方を組み立てて手本と違う資料になる → 生成スクリプトの汎用テンプレート・構成メモと台本・gws での変換とサムネイル確認を既存の規約から辿れ、その手順で発表資料を作れる(#2065) - #2066

Merged
takemi-ohama merged 4 commits into
developfrom
design/issue-2065
Oct 17, 2026

Conversation

@takemi-ohama

Copy link
Copy Markdown
Contributor

#2065 の設計文書を追加しました。要求と受け入れ条件の写し、設計、設計判断の記録を置き、スライドの作成に関する語を用語集へ足しています。設計では、生成スクリプトの汎用テンプレート、構成メモと台本、gws での変換とサムネイル確認を既存の規約へ足す方針を定めています。

利用者向けの変化

  • 無し

移行の手順

  • 無し

変更の要点

テスト

supervise.py の run のステップの結果は次のとおりです。

ステップ exit 結果
glossary 0 ok。宣言と用語集が揃っている
requirements-check 2 stopped。issues/issue-2065-requirements.md を読めない([Errno 2] No such file or directory)

requirements-check は止まっています。issues/issue-2065-requirements.md は変更の統計に含まれているのに、ステップの実行時には読めていません。マージの前に、このファイルがある状態で再実行して確認する必要があります。

モード: standard / 通した工程: 設計 → 要求と受け入れ条件 → ドキュメントレビュー

🤖 Generated with Claude Code

決めたこと

issues/issue-2065-design-decisions.md

  • 決定 1: Skill の数を増やさないため、既存の 4 つの規約と google-workspace へ足す
  • 決定 2: すべてのランタイムで同じテンプレートを使うため、汎用テンプレートを release Skill の assets に置く
  • 決定 3: 生成スクリプトの経路を規約で扱えるようにするため、スライドの生成の経路に「生成スクリプトを書く」を決定的な経路として足す
  • 決定 4: 枠組みの更新でプロジェクトの値を失わないため、トーン&マナーは theme.json で上書きし、枠組みは写して書き換えない
  • 決定 5: 会社色を持たず配布先で同じ見え方にするため、既定の書体を Noto Sans JP、強調の色を 2B6CB0 にし、著作権表示とロゴは既定で描かない
  • 決定 6: スピーカーノートを台本と食い違わせないため、枠組みが台本を読んでページ番号でノートを付ける
  • 決定 7: 台本の読み取りを 1 つにするため、尺の計算を枠組みと同じ JavaScript で持つ
  • 決定 8: 全ページを決まった手順で見られるようにするため、サムネイルの取得をスクリプトにし、変換と差し替えは対応表のコマンドで打つ
  • 決定 9: 発表資料を発表日時点の記録にするため、資料は枠組みを写して持ち、汎用テンプレートを直接読まない
  • 決定 10: 成果物を 1 つにするため、pptx をコミットせず Google Slides を成果物にし、公開ページの入口に足さない
  • 決定 11: 生成のテストが CI で読み飛ばされないよう、pytest のジョブに Node.js 22 と npm ci を足す

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 1 | codex | REQUEST_CHANGES

指摘は major 1 件です。

Comment thread issues/issue-2065-design.md Outdated

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 1 | kiro | APPROVE

設計 PR のドメインモデルの節(コンテキスト・集約・不変条件・ドメインイベント・用語)と用語集の差分だけを見た。コンテキストマップの関係(顧客 / 供給者)が宣言され、集約ごとに持ち主が 1 つに決まり、不変条件 I1〜I7 は互いに矛盾せず、ドメインイベント E1〜E7 は要求の番号を引き継いで各イベントに受け手がある。用語の表が宣言する 3 語(トーン&マナーのファイル・尺・台本)は用語集の差分に反映されている。重要度 critical / major に当たる修正アクションは見つからなかった。

新しい版の lib/ を取り込むたびに違反と判定される規則を直し、
資料の README.md に写した元の NDF の版を書く。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@takemi-ohama

Copy link
Copy Markdown
Contributor Author

🔧 /ndf:fix サマリ | round 1 | commit ee4092c

対応件数: critical=0 / major=1 / minor=0(合計 1 件)
決着: 1 件 / 見送り: 0 件 / 却下: 0 件
CI: PENDING

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 2 | claude | REQUEST_CHANGES

I2 の比較の基準にした「写した元の版(NDF の版)」は、lib/ の中身を一意に指せない。基準をコミット(またはハッシュ)へ変える指摘 1 件。

Comment thread issues/issue-2065-design.md Outdated

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 2 | kiro | APPROVE

round 1 の major 指摘(I2 の改変判定を『写した元の版』との比較にする)が、変更された行だけで解消されている。新しい I2 は『資料の slides/lib/ を README.md に記録した写した元の NDF の版の lib/ と比べ、差分が出たら書き換え、新しい版との差分は更新の取り込み』と具体化され、集約の表(『資料は汎用テンプレートを ID(写した元の版)で参照し』)・成果物の README 記述(『lib/ を写した元の NDF の版』)・テスト設計(受け入れ条件 5・I2・I3/受け入れ条件 10 の『作った時点で比べる。以後は追随しない』)と矛盾しない。初回の写しの時点では写した元の版と現版が一致するため、受け入れ条件 10 とも食い違わない。critical / major に当たる修正アクションは見つからなかった。

@takemi-ohama

Copy link
Copy Markdown
Contributor Author

🔧 /ndf:fix サマリ | commit 44f9629

対応件数: critical=0 / major=0 / minor=0(合計 0 件)
決着: 1 件 / 見送り: 0 件 / 却下: 0 件
CI: NONE

@takemi-ohama
takemi-ohama marked this pull request as ready for review October 17, 2026 16:17
@takemi-ohama takemi-ohama added the design-approved 設計 Pull Request の承認の印 label Oct 17, 2026
@takemi-ohama
takemi-ohama merged commit f9b01a2 into develop Oct 17, 2026
23 checks passed
@takemi-ohama
takemi-ohama deleted the design/issue-2065 branch October 17, 2026 17:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

design-approved 設計 Pull Request の承認の印

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant