Skip to content

docs: o3/Linear の古い参照を完全削除し壊れたリンクを修正 - #494

Merged
keito4 merged 8 commits into
mainfrom
docs/cleanup-stale-references
Feb 21, 2026
Merged

docs: o3/Linear の古い参照を完全削除し壊れたリンクを修正#494
keito4 merged 8 commits into
mainfrom
docs/cleanup-stale-references

Conversation

@keito4

@keito4 keito4 commented Feb 21, 2026

Copy link
Copy Markdown
Owner

Summary

  • credentials テンプレート4ファイルから OPENAI_API_KEY / LINEAR_API_KEY 参照を削除
  • setup-mcp.sh / lib/config.sh から o3/Linear 関連のチェック・案内を削除
  • npm/global.json から @mseep/linear-mcp エントリを削除
  • .claude/settings.json / .devcontainer/claude-settings.json から linear.app WebFetch 許可を削除
  • README.md の壊れたリンク修正(setup-recommended-ci/setup-cidevcontainer-recommendations パス修正)
  • .claude/devcontainer-recommendations.md から o3 設定例・トラブルシューティングを削除
  • .claude/commands/devcontainer-checklist.md から OPENAI_API_KEY チェック項目を削除
  • docs/tool-catalog.md から Linear MCP エントリを削除

Context

PR #492, #493.mcp.json / CLAUDE.md / settings から o3/Linear を削除したが、credentials テンプレート・スクリプト・README 等に古い参照が多数残存していた。

Test plan

  • npm run format:check 通過
  • npm run lint 通過
  • npm test 通過(101 tests)
  • grep -rOPENAI_API_KEY / LINEAR_API_KEY / linear-mcp の残存ゼロ確認(git-ignored ファイルを除く)

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Enhanced security by preventing API key exposure in logs.
  • Documentation

    • Updated configuration and MCP setup guidance.
    • Removed references to deprecated service integrations.
  • Chores

    • Cleaned up unused dependency and configuration entries.
    • Added CLAUDE.md to Prettier ignore list.

github-actions Bot and others added 7 commits February 21, 2026 21:01
o3 MCP / Linear MCP は既に削除済みのため、テンプレートと
credentials/README.md からも OPENAI_API_KEY / LINEAR_API_KEY の
参照を削除する。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
setup-mcp.sh の OPENAI_API_KEY チェック・警告と、
lib/config.sh の MCP インポート時の o3/Linear 案内、
エクスポート時の sk- プレフィックス置換を削除する。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Linear MCP サーバーは使用停止済みのため、グローバルパッケージ
定義から削除する。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Linear MCP は削除済みのため、linear.app ドメインへの
WebFetch 許可も不要になった。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- o3/Linear 関連の言及を削除(.codex 説明、Vault 構造、
  手動セットアップ例、Glossary)
- setup-recommended-ci の古いパス参照を /setup-ci に更新
- devcontainer-recommendations のパスを .codex → .claude に修正

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- MCP 設定例から o3 エントリと OPENAI_API_KEY 環境変数を削除
- o3 MCP トラブルシューティングセクションを削除
- 参考リンクから o3 Search MCP を削除
- チェックリストの環境変数確認から OPENAI_API_KEY を削除

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Linear MCP は使用停止済みのため、ツールカタログの
MCP/Automation セクションからも削除する。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Feb 21, 2026

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉


📝 Walkthrough

Walkthrough

This PR removes references to o3 and Linear MCP server integrations, along with their associated API keys (OPENAI_API_KEY, LINEAR_API_KEY) from configuration files, templates, scripts, documentation, and npm dependencies. The changes consolidate the MCP setup around remaining integrations like n8n and Playwright.

Changes

Cohort / File(s) Summary
Claude Settings & Permissions
\.claude/settings.json, \.devcontainer/claude-settings.json
Removed WebFetch permission for linear.app domain from the allow list in both configuration files.
MCP Configuration & Setup Scripts
\.claude/devcontainer-recommendations.md, \.claude/commands/devcontainer-checklist.md, script/setup-mcp.sh, script/lib/config.sh
Removed o3 MCP server entry, OPENAI_API_KEY references, and placeholder replacement logic. Removed runtime validation check for OPENAI_API_KEY. Updated MCP setup guidance to exclude o3 and Linear integrations.
Environment Templates
credentials/templates/devcontainer.env.template, credentials/templates/mcp.env.template, credentials/templates/simple.env.template, \.zsh/configs/pre/\.env.secret.template
Removed OPENAI_API_KEY and LINEAR_API_KEY environment variable entries and associated comments from all template files.
Documentation
README.md, credentials/README.md, docs/tool-catalog.md
Removed references to o3 Search, Linear MCP server, OPENAI_API_KEY, and LINEAR_API_KEY. Updated MCP server lists to focus on n8n and Playwright. Updated command references from setup-recommended-ci to /setup-ci.
Dependencies
npm/global.json
Removed @mseep/linear-mcp dependency (version 78.0.1) from the dependencies object.
Ignore Configuration
\.prettierignore
Added CLAUDE.md to the Prettier ignore list.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

Suggested labels

size/S

Poem

🐇 O3 and Linear fade away,
Keys once secret, now don't stay,
Playwright thrives and n8n dance,
Config cleaned with each small glance,
Rabbit hops through simpler days! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title in Japanese accurately describes the main purpose: removing stale o3/Linear references and fixing broken links. It directly aligns with the changeset's primary objectives.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/cleanup-stale-references

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@keito4

keito4 commented Feb 21, 2026

Copy link
Copy Markdown
Owner Author

🔍 AI Code Review (Local Hook)

Models: Codex (default) / Gemini (default)

🤖 Codex Review

指摘事項(重大度順)

  • 重要: config::export_mcp.mcp.json をそのままコピーするため、実値のAPIキーを含む設定をエクスポートしてしまい、リポジトリや共有先への機密情報流出リスクが増えます。以前のプレースホルダー置換が削除されているため回避手段がありません。script/lib/config.sh:116-127

判定: patch is incorrect — エクスポート処理でAPIキーのマスキングがなくなり、セキュリティ上の退行があるため。信頼度 0.31


⚠️ 修正が必要です

上記のレビューで問題が指摘されています。修正してからマージしてください。


🤖 Generated by post_pr_ai_review.py hook

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 96c2f08d0e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread script/lib/config.sh
# APIキーをプレースホルダーに置換
sed -E 's/"(sk-[a-zA-Z0-9]+)"/"${OPENAI_API_KEY}"/g' "$source_file" > "$target_file"
echo "✅ Exported .mcp.json (API keys replaced with placeholders)"
cp "$source_file" "$target_file"

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Restore secret scrubbing when exporting .mcp.json

config::export_mcp now copies ~/.mcp.json directly into the tracked repo file without any redaction, so running ./script/export.sh on a workstation that stores MCP tokens in env/headers will write real credentials into .mcp.json and makes accidental secret commits likely. This is a regression from the prior export behavior that replaced API-key-like values before writing the file.

Useful? React with 👍 / 👎.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
.claude/devcontainer-recommendations.md (1)

790-791: Nit: UUOC in example command.

♻️ Suggested simplification
-     cat .mcp.json | grep '\${'
+     grep '\${' .mcp.json
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.claude/devcontainer-recommendations.md around lines 790 - 791, Replace the
useless use of cat in the example command: instead of piping "cat .mcp.json |
grep '\${'" call grep directly on the file (grep '\${' .mcp.json) so the example
uses "grep '\${' .mcp.json" while preserving the existing comment "#
${VAR_NAME}が残っている場合は未展開".
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In @.claude/devcontainer-recommendations.md:
- Around line 790-791: Replace the useless use of cat in the example command:
instead of piping "cat .mcp.json | grep '\${'" call grep directly on the file
(grep '\${' .mcp.json) so the example uses "grep '\${' .mcp.json" while
preserving the existing comment "# ${VAR_NAME}が残っている場合は未展開".

.prettierignore から CLAUDE.md の除外設定が欠落していたため、
Prettier が symlink ファイルに末尾改行を追加し、CI 環境
(core.symlinks=false)で壊れたリンクとなる問題を修正。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@claude

claude Bot commented Feb 21, 2026

Copy link
Copy Markdown
Contributor

Claude Code レビュー

概要

PR #492, #493 に続く整合性確保のクリーンアップとして、変更の目的は明確です。削除漏れの参照を一括処理しており、全体的に正しい方向性です。


セキュリティ懸念(要確認)

script/lib/config.shconfig::export_mcp 関数

Codex レビューが指摘した点と同様ですが、掘り下げて確認します。

変更前は OpenAI の sk- パターンのみをマスクしていたため、n8n 等の他のキーはマスクされていませんでした。つまり 以前からn8nキーは保護されていなかった という点は事実です。

ただし、この関数の用途(エクスポート先は何か)によっては、.mcp.json に展開済みの実値が含まれる場合にそのままコピーされるリスクは残ります。

確認してほしい点:エクスポート先が git-tracked なファイルになりえますか?もしそうであれば展開済みキーの流出リスクがあります。git-ignored なファイル間のコピーのみであれば、実質的なリスク増加はないと判断できます。


軽微な指摘

.claude/devcontainer-recommendations.md line 790

CodeRabbit が指摘済みですが同意。cat .mcp.json | grep は UUOC(Useless Use of Cat)のため、grep の直接呼び出しが望ましいです。


良い点

  • 削除の網羅性:Test plan の grep -r 確認により残存ゼロが確認されている
  • .prettierignore の追加:シンボリックリンクを Prettier から除外する適切な対応
  • リンク修正.codex/devcontainer-recommendations.md から .claude/devcontainer-recommendations.md への修正は正しいパス修正
  • README の簡略化setup-recommended-ci から /setup-ci コマンドへの統一は一貫性向上
  • 101 テスト通過:既存機能への影響なし

判定

config::export_mcp の用途が確認できれば概ねマージ可能です。エクスポート先が git-ignored のみであれば 承認、git-tracked ファイルへのエクスポートが可能なら API キーのサニタイズ処理の追加を推奨します。

@keito4
keito4 merged commit 0f4319f into main Feb 21, 2026
19 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 1.80.2 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions github-actions Bot added the released リリース済み label Feb 21, 2026
@keito4
keito4 deleted the docs/cleanup-stale-references branch March 1, 2026 09:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

released リリース済み

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant