Mastodon Mastodon

スコープ名にモデル名を用いたモデル設計とStyle/ClassAndModuleChildren (ネスト記法) のオートコレクションについて

(Qiitaに2023年8月24日に投稿した記事の転載です)

環境

対象 バージョン
Rubocop 1.56.1
TargetVersion 3.2
Rails 7.0.7

TL;DR

Style/ClassAndModuleChildren cop のオートコレクションは非安全である。特に既存のモデル名をスコープ名として使用している場合には、オートコレクションによってZeitwerkの定数解決に関するTypeErrorが発生する。

既存のモデル名をスコープ名としていた場合

以下の記事のように、既存のモデル名をスコープ名とするモデル設計を行っていたとする。

https://qiita.com/jkr_2255/items/68c94573d07d189f4c6f

図1のようなディレクトリ構造で与えられている Post::Revision モデルに対して、Style/ClassAndModuleChildren cop (EnforcedStyle: nested) のオートコレクションを適用する 1 。

app/models
├── post.rb
└── post
    └── revision.rb
class Post; end
class Post::Revision; end

すると、post/revision.rb は次の変更を受ける。

- class Post::Revision; end
+ module Post
+     class Revision; end
+ end

この状態で bin/rails server などのコマンドを実行すると、「Post はモジュールではない」というメッセージを持つTypeErrorが発生する。

app/models/post/revision.rb:3:in `<main>': Post is not a module (TypeError)
app/models/project.rb:1: previous definition of Post was here

原因と解決

Zeitwerkは、まず post.rb を参照し post をクラスの定数であると解決する。その次に post/revision.rb の module Post を見て、「postはモジュールではないよ!」と怒る2。

したがって、次のように Post をモジュール定数からクラス定数として書き換えればよい。

- module Post
+ class Post
     class Revision; end
 end

そもそも……

そもそもRubocopドキュメントの『Style/ClassAndModuleChildren』節に、このcopのオートコレクションが非安全であり、手動による監督が必要であると明記されている。Rubocop はコンパクト記法 (Post::Revision) からネスト記法に移行する知識を (少なくとも現時点では) 持たないのだ。

Safety

Autocorrection is unsafe.

Moving from compact to nested children requires knowledge of whether the outer parent is a module or a class. Moving from nested to compact requires verification that the outer parent is defined elsewhere. RuboCop does not have the knowledge to perform either operation safely and thus requires manual oversight.

そもそもモデル設計に関して、admin などのクラス名とならないスコープ名は正しいものだが、「名前空間としてクラスを使」3ったモデル名は避けるべきだろう。たとえば、Railsドキュメントの『モデルを生成』には、「階層を指定」してモデルを生成するコマンドとして

rails generate model admin/account

が例示されている。つまり、階層を表す接頭辞 (スコープ名) に既存のモデル名を充てることは推奨されないということだ。


  1. コマンド rubocop -A <file> で Rubocop の自動訂正を適用できる。↩
  2. Zeitwerkの名前解決アルゴリズムについては、『Zeitwerkの壊し方』を参照してほしい。↩
  3. https://qiita.com/fursich/items/717a720d9f4465e4cbbb#5-%E5%90%8D%E5%89%8D%E7%A9%BA%E9%96%93%E3%81%A8%E3%81%97%E3%81%A6%E3%82%AF%E3%83%A9%E3%82%B9%E3%82%92%E4%BD%BF%E3%81%86↩

AIエージェントとセッション・レトロスペクティブ

Google AntigravityやOpenAI ChatGPT、Anthropic Claudeといった対話型AIエージェントは、セッション(会話スレッドの単位)のなかで、指令や事実の提示を人間から受けたり、思考の連鎖やエージェンティックな行為を行う(外部システムのAPIを叩くなど)ことによって、新たな知識(ナレッジ)を得ることがある。このナレッジは、組織が保持すべき無形資産である。

このナレッジは、ハーネスのうちの「記憶」機能*1によって保持される。しかし、この記憶機能は、明示的な形で外部化する(codificate)必要があるもの以外も記憶してしまう、汎用的なものである。つうじょうナレッジとして保持したいものは、選択され、限定される必要があるだろう。したがって、agent.md や skill.md にセッションを通してエージェントが得た知識を選択し、外部化するプロセスが必要になる。

ここで外部化する知識は、エージェントじしんにセッションの内容を反省させることによって抽出することができる。この知識の外部化の方法を、「セッション・レトロスペクティブ(session retrospective)」と呼ぼう。この用語は、アジャイル開発における「レトロスペクティヴ」という概念を下敷きにしたものである。

この「セッション・レトロスペクティブ」スキルは、各スキルやセッションの最後に呼び出すことによって、エージェントにフィードバックと改善を実施させることができる。PDCAサイクルをエージェントに自動で回させることができるのだ*2。

プロンプト

以下のプロンプトを .claude/skills/retro.md として保存しておけば、/retro で呼び出すことができる。

---
description: セッション終了時に振り返りを行い、使用したコマンド md(や関連ルール)を更新するかユーザーに尋ねる(汎用)
argument-hint: [対象コマンド名 (省略可)]
---

引数: $ARGUMENTS

このセッションで実行した作業を振り返り、**コマンド定義の md(`.claude/commands/*.md`、対応する `.agents/skills/*/SKILL.md`)を更新すべきか** をユーザーに尋ねる汎用コマンドです。特定のワークフローに依存せず、どのコマンドの後でも使えます。

## 安全規則

1. **承認なしに md を書き換えない**: 更新案は必ず提示し、`AskUserQuestion` でユーザーの承認を得てから編集する。
2. **元の作業ブランチに混入させない**: 更新は `origin/main` から新ブランチ(`chore/retro-<topic>`)を切って行い、独立した PR にする。作業ブランチへのコミットはユーザーが明示した場合のみ。
3. **一般化できる知見だけ**: 今回限りの事情(特定記事の内容、一時的な障害)は提案しない。再発しうる摩擦・曖昧さ・手戻りのみ対象とする。

## 手順

### 1. 対象コマンドの特定

- `$ARGUMENTS` があればそれを対象とする。
- なければ、会話中に呼び出されたスラッシュコマンド / スキルを洗い出す。複数ある場合は全て候補にする。
- 該当がなければ、関連する `AGENTS.md` / `docs/` のルールを候補とする。
- 対象 md の現行内容を `Read` で確認し、`.claude/commands/<name>.md` と `.agents/skills/<name>/SKILL.md` の両方があれば **両方** を更新対象とする(内容を同期させる)。

### 2. 振り返り

以下の観点でセッションを振り返る:

- 手順が曖昧で迷った・誤解した箇所
- 失敗したコマンド、リトライ、手戻り、想定外のエラーとその原因
- ユーザーから受けた訂正・追加指示(次回も必要になるもの)
- 手作業で行ったが、スクリプト / リンター / テストで自動化できる処理
- md に書かれていないが守る必要があった暗黙ルール
- 逆に、md に書かれているが不要・古い・誤っている記述

### 3. 更新案の提示

- 改善点がなければ「更新すべき点は検出されませんでした」と報告して終了する。
- ある場合は、各項目を「背景 → 問題 → 提案する変更(対象ファイルと差分の要約)」で簡潔に列挙する。
- 変更の置き場所を分類する: コマンド md / `AGENTS.md`・`docs/` / スクリプト・テスト・CI。コマンド md 以外が適切ならそう明記する。

### 4. ユーザーへの確認

`AskUserQuestion` で次を尋ねる(項目が多い場合は multiSelect で採用する項目を選ばせる):

- 「提案した改善(コマンド md に限らず、`AGENTS.md`・`docs/`・スクリプト・テスト・CI を含む)を反映しますか?」: 全て反映 / 選択した項目のみ / 反映しない
- 更新する場合の反映方法: 新規 PR を起票 / ローカルに変更のみ残す

「反映しない」の場合はここで終了する。

### 5. 反映

1. `git fetch origin main && git checkout -b chore/retro-<topic> origin/main`(未コミット変更がある場合は `git worktree` を使う)。
2. 承認された項目のみ md を編集する。`.claude/commands/` と `.agents/skills/` の同名ファイルは同期する。
3. 変更が `scripts/` / `tests/` に及ぶ場合はローカル検証(`uv run ruff check scripts tests`、`uv run python -m unittest discover -s tests`)を通す。
4. `chore(retro): <要約>` でコミットし push、PR を起票してその URL を報告する(ユーザーが「ローカルのみ」を選んだ場合は PR を作らない)。

## 出力

最後に 1〜3 行で、提案件数・採用件数・作成した PR(または「変更なし」)を報告する。

*1: https://code.claude.com/docs/ja/memory

*2:このスキルは Bitwarden が作っているらしいが、それ単体で公開されているのかはよく分からない。 https://github.com/bitwarden/ai-plugins/blob/main/plugins/claude-retrospective/skills/retrospecting/SKILL.md

Academia.eduに65,000円課金させられた話

Academia.edu というサイトがある。論文を無料でダウンロードするときに使う、あのサイトのことである。このサイトはどうやら2003年からあるらしい。edu TLDを使っているが、商業サイトである*1。人文系の研究者が比較的登録しているようだ。哲学科出身の人が作ったかららしい*2。

Academia.eduは利用者に初月 $1 でサブスクリプション購読を開始させ、その後 $169(26,730 JPY)/年のプランに移行させる。その次年度には、$269(42,547 JPY)/年のプランに移行させる。返金処理が可能であるのは初年度に限ると契約で定めているので、次年度以降のサブスク延長については返金申請を受理しないらしい。

私は、1年目($169のとき)はなぜか払っていたらしい。そのときはほとんど金銭管理をしていなかったからだろう。

Google検索で「Academia.edu predatory」と検索すると、たくさんの悪評が見つかる。Trustpilotでは星1.1で、ほとんどがその高額なサブスクリプションに対する批判的なレビューである。

https://www.trustpilot.com/review/academia.edu

hs.cnies.org

返金を求めるメールをサポートに送ると、以下のような(煽りのような)定型文が返ってくる。

Thanks for getting in touch with us regarding this payment. Our records indicate that this payment is for an Academia Premium subscription renewal.

While we're unable to process refunds for subscription renewals, we want you to know that your support genuinely makes a difference in advancing research worldwide. Your subscription helps us connect researchers globally, improve our recommendation systems, strengthen our infrastructure, and develop new tools, like better ways to find and apply for grants, that benefit the entire academic community.

いまは国民生活センターの越境消費者センター(CCJ)に本件を問い合わせているが、CCJからも連絡が無い。また、北米+カナダ圏にはBetter Business Bureau(BBB)という非政府組織があり、そこで米国かカナダに住所を持つ自然人はcomplaintを申し立てることができるが、日本人は基本的には難しい。BBB でも星 1 なので*3、Academia.eduのカスタマーサポートが最悪であることは分かるだろう。

まとめ

みなさんは Academia.edu のサブスクリプションには絶対に登録しないようにしましょう。(自分はアカウントを消した。)

追記

2026年10月9日、Academia.edu から一度限りの返金を認めるというメールが届いた。良かった。

なお、CCJからは煽りみたいなメールが届いたので、(当たり前だが)何もしてくれないんだなぁと思った。

また、ご申告内容からは、以前から有料プランを利用していたところ、既存の契約が更新された事案であることがうかがわれます。 さらに、更新日の約1か月前に、更新料金269米ドルおよび更新日2026年9月18日が記載されたメールが送信されていたことも確認できます。

その更新メールが消費者に誤解させるような書き方になっているということが本件の問題の趣旨なのだが、CCJ では同じような問い合わせは来ていないということなのだろうか。

クリエイティブ・コモンズ・ライセンス
このブログのコンテンツは、クリエイティブ・コモンズ 表示 - 非営利 - 継承 4.0 国際 ライセンスの下に提供されています。