feat: Add setup-ci to repo-maintenance command

[keito4]

Summary

• /repo-maintenance コマンドの Setup カテゴリに /setup-ci を追加
• CI/CD ワークフローの設定確認が自動メンテナンスに含まれるようになりました

Changes

repo-maintenance.md

• 3.4 CI/CD Setup Check セクションを追加（full mode only）
  • GitHub Actions ワークフローの存在確認
  • 必須ジョブ（lint, test, build）の確認
  • セキュリティスキャンの設定確認
  • Claude Code Review の統合確認
• サマリーレポートの Setup セクションに CI/CD ステータスを追加
• Action Items に /setup-ci を追加
• Related Commands テーブルに /setup-ci を追加

YAML パースエラー修正

• argument-hint の値に含まれる | 文字が YAML の特殊文字として解釈される問題を修正
• 対象ファイル: repo-maintenance.md, setup-ci.md

Test plan

• /repo-maintenance --mode check-only でエラーなく実行できる
• スキル一覧に repo-maintenance が正しく表示される

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

• Documentation

  • Updated repo maintenance guide with comprehensive CI/CD setup validation details, including workflow checks, required jobs, and security scans.
  • Added new CI/CD configuration documentation and command references.

• Chores

  • Minor formatting improvements in command documentation.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

📝 Walkthrough

Walkthrough

Documentation updates to the repo maintenance guide add a new CI/CD Setup Check section describing CI/CD workflow validation, required jobs, and security scans integration. Minor formatting changes update argument hints in CLI command files, and references to CI/CD are added throughout related sections.

Changes

Cohort / File(s)	Summary
CI/CD Documentation Updates .claude/commands/repo-maintenance.md	Added new section 3.4 detailing CI/CD Setup Check with validation steps, expected results, and conditional /setup-ci command suggestion. Updated Pre-PR Checklist, Setup, Cleanup, and Summary sections to reference CI/CD status and configuration level.
CLI Command Formatting .claude/commands/setup-ci.md	Wrapped argument-hint value in quotes for consistent CLI argument parsing.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• feat: Add setup-ci command for comprehensive CI/CD setup #292: Modifies the same CLI command documentation file (.claude/commands/setup-ci.md) and references the /setup-ci command for CI/CD setup workflows.
• feat: Add Setup category to repo-maintenance command #291: Adds Setup-related steps and commands to the repo maintenance workflow, sharing similar structural additions for setup automation and validation.

Poem

🐰 ✨ Our CI/CD checks now shine so bright,
With validation steps done just right,
Documentation flows like morning dew,
Repo health shines through and through! 🌟

Pre-merge checks

✅ 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 accurately describes the main change: adding /setup-ci to the repo-maintenance command, which is the primary objective of this PR.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

---

📜 Recent review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 32cdfaf and dab7f80.

📒 Files selected for processing (2)

• .claude/commands/repo-maintenance.md
• .claude/commands/setup-ci.md

🧰 Additional context used

🧠 Learnings (6)

📓 Common learnings

Learnt from: CR
Repo: keito4/config PR: 0
File: CLAUDE.md:0-0
Timestamp: 2025-12-01T03:45:17.253Z
Learning: Applies to .github/workflows/ci.yml : Validate code quality in CI pipeline (.github/workflows/ci.yml) with linting, formatting, testing, and building

📚 Learning: 2025-12-01T03:45:17.253Z

Learnt from: CR
Repo: keito4/config PR: 0
File: CLAUDE.md:0-0
Timestamp: 2025-12-01T03:45:17.253Z
Learning: Applies to .github/workflows/ci.yml : Validate code quality in CI pipeline (.github/workflows/ci.yml) with linting, formatting, testing, and building

Applied to files:

• .claude/commands/setup-ci.md
• .claude/commands/repo-maintenance.md

📚 Learning: 2025-12-09T08:39:14.049Z

Learnt from: CR
Repo: keito4/config PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-12-09T08:39:14.049Z
Learning: Follow development quality standards defined in `CLAUDE.md` when using Claude Code for development assistance

Applied to files:

• .claude/commands/repo-maintenance.md

📚 Learning: 2025-12-01T03:45:17.253Z

Learnt from: CR
Repo: keito4/config PR: 0
File: CLAUDE.md:0-0
Timestamp: 2025-12-01T03:45:17.253Z
Learning: Applies to .github/workflows/claude.yml : Trigger automatic AI assistance on claude mentions in issues, PRs, and comments using .github/workflows/claude.yml

Applied to files:

• .claude/commands/repo-maintenance.md

📚 Learning: 2025-12-01T03:45:17.253Z

Learnt from: CR
Repo: keito4/config PR: 0
File: CLAUDE.md:0-0
Timestamp: 2025-12-01T03:45:17.253Z
Learning: Applies to .github/workflows/update-libraries.yml : Execute npm run update:libs on schedule and open pull requests when dependencies or Codex/Claude tooling changes in .github/workflows/update-libraries.yml

Applied to files:

• .claude/commands/repo-maintenance.md

📚 Learning: 2025-12-01T03:45:17.253Z

Learnt from: CR
Repo: keito4/config PR: 0
File: CLAUDE.md:0-0
Timestamp: 2025-12-01T03:45:17.253Z
Learning: Applies to .github/workflows/docker-image.yml : Build DevContainer images automatically with semantic versioning and multi-platform support in .github/workflows/docker-image.yml

Applied to files:

• .claude/commands/repo-maintenance.md

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

• GitHub Check: check-ci-status

🔇 Additional comments (5)

.claude/commands/setup-ci.md (1)

4-4: YAML parsing fix correctly applied.

Quoting the argument-hint value prevents the pipe characters in the CLI syntax from triggering YAML special-character interpretation. This is the correct approach and aligns with the PR's stated objective.

.claude/commands/repo-maintenance.md (4)

4-4: YAML parsing fix consistently applied.

The argument-hint is now properly quoted to prevent pipe characters from triggering YAML special-character interpretation, mirroring the fix in setup-ci.md.

---

16-16: Overview description correctly updated to mention CI/CD.

The addition of "CI/CD およびリポジトリ保護の設定" (CI/CD and repository protection setup) accurately reflects the expanded scope of the Setup category.

---

183-204: New CI/CD Setup Check section is well-structured and properly integrated.

The section follows the established pattern of other setup validation steps (3.1–3.3), clearly documenting what will be checked (workflows, required jobs, security scans, Claude integration), expected results, and a conditional recommendation to run /setup-ci when appropriate. The section correctly targets full-mode-only execution and aligns with the repo-maintenance workflow's design.

---

277-278: Integration updates maintain consistency and coherence.

The additions to the summary report (line 278), action items (lines 298–299), and related commands table (line 461) properly integrate /setup-ci into the broader maintenance workflow. The CI/CD entry appears alongside other Setup tasks, maintains appropriate priority ordering in the Immediate section, and is correctly categorized in the related commands table.

Also applies to: 298-299, 461-461

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[claude]

PR Review: feat: Add setup-ci to repo-maintenance command

概要

このPRは /repo-maintenance コマンドに CI/CD セットアップチェック機能を追加するものです。全体的によく設計されており、CLAUDE.mdの品質基準に沿った実装となっています。

---

✅ 良い点

1. 適切な機能統合

• /setup-ci コマンドを /repo-maintenance の Setup カテゴリに適切に統合
• 既存の構造（Team Protection, Husky, Pre-PR Checklist）と一貫性のある設計
• full mode でのみ実行される設定が明確（repo-maintenance.md:183）

2. YAML パースエラーの修正

• argument-hint フィールドの | 文字をクォートで囲むことで、YAMLパーサーの問題を解決
• 両ファイル（repo-maintenance.md:4, setup-ci.md:4）で一貫した修正を適用
• これにより、コマンドのメタデータが正しく解析されるようになります

3. ドキュメントの整合性

• サマリーレポート例に CI/CD ステータスを追加（:278）
• Action Items のナンバリングを適切に更新（:298-309）
• Related Commands テーブルに /setup-ci を追加（:461）

4. 明確な実行内容

Section 3.4 で以下を明示：

• GitHub Actions ワークフローの存在確認
• 必須ジョブ（lint, test, build）の確認
• セキュリティスキャンの設定確認
• Claude Code Review の統合確認

---

🔍 潜在的な改善提案

1. チェック重複の可能性（軽微）

• Section 3.3 "Pre-PR Checklist Validation" で CI ワークフローの存在を確認（:173）
• Section 3.4 でも GitHub Actions ワークフローの存在を確認（:189）
• これらは目的が異なるため問題ありませんが、ドキュメントでより明確に区別できます：
  • 3.3: CI の存在確認
  • 3.4: CI の設定内容の包括的検証

推奨: Section 3.4 の冒頭に以下を追加することを検討：

Note: このチェックは 3.3 よりも詳細で、ワークフローの存在だけでなく、
必須ジョブやセキュリティ設定の完全性を検証します。

2. --dry-run フラグの動作（要確認）

• /setup-ci --dry-run と同等の処理を実行すると記載（:194）
• しかし、/repo-maintenance の MODE が check-only の場合の動作が不明確
• full mode でのみ実行されるため、check-only では実行されない想定ですが、明示的な記載があるとより良い

推奨: Section 3.4 のタイトル行を確認：

### 3.4 CI/CD Setup Check (full mode only)

既に "full mode only" と明記されているため、問題ありません。

3. テストカバレッジ

PR description のテストプランは手動確認のみです：

• /repo-maintenance --mode check-only でエラーなく実行できる
• スキル一覧に repo-maintenance が正しく表示される

推奨:

• CI での自動テストがあればより安全
• ただし、コマンドスキルの性質上、統合テストは手動が適切かもしれません

---

🛡️ セキュリティ・品質面

✅ セキュリティ

• 外部入力の処理なし
• 機密情報の露出なし
• 問題なし

✅ コード品質

• Markdown フォーマットが一貫している
• YAML frontmatter が正しく構成されている
• 日本語ドキュメントとして明確で読みやすい

✅ Git Workflow

• Conventional Commits 準拠（feat:）
• 適切なコミットメッセージ
• Co-authored-by タグ付き

---

📋 リリース要件の確認

CLAUDE.md によると、以下のファイルへの変更は release-triggering type が必要です：

• ✅ .codex/** - 該当なし
• ✅ .devcontainer/codex* - 該当なし
• ✅ package*.json - 該当なし
• ✅ npm/global.json - 該当なし

このPRは .claude/commands/ のみを変更しているため、feat タイプの使用は適切です。

---

🎯 総合評価

Overall: ✅ Approve

このPRは以下の点で優れています：

1. 機能追加: CI/CD チェックを包括的メンテナンスに統合
2. バグ修正: YAML パースエラーの修正
3. ドキュメント: 一貫性のある更新
4. 品質: CLAUDE.md の基準に準拠

軽微な改善提案はありましたが、現状のままでマージ可能です。提案した改善は将来的な enhancement として検討できます。

---

✅ マージ推奨

以下を確認後、マージを推奨します：

• コード品質: 問題なし
• セキュリティ: 問題なし
• ドキュメント: 完全
• Conventional Commits: 準拠
• CI/CD: ステータス確認待ち（あれば）
• 手動テスト: PR author による確認

---

🤖 Generated with Claude Code

[github-actions]

🎉 This PR is included in version 1.41.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀