本文へ移動
cccskills
無料GitHub で公開

Architecture Change Communication

Ensure architecture updates document affected stakeholders, notification plan, and deprecation/retirement signals to keep knowledge aligned.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md4.1 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Pattern declaration

Primary pattern: Reviewer Secondary patterns: Inversion Why: 設計変更の影響範囲・通知計画・非推奨措置をチェックリスト型で評価し、コミュニケーション漏れを防ぐ

Goal / 目的

  • 設計変更の差分から、影響範囲・通知経路・非推奨措置を共有するコミュニケーション計画が抜け落ちていないかをチェックする。

Non-goals / 扱わないこと

  • 内部通知ツール(Slack/Teams)のテンプレ作成や運用作業そのもの。
  • 個別チームの予定調整(ただし通知対象に入るべきステークホルダーは指摘する)。

Pre-execution Gate / 実行前ゲート

このスキルは以下の条件がすべて満たされない限りNO_REVIEWを返す。

  • 差分に設計ドキュメント(アーキテクチャ/ADR/設計書)の変更がある
  • 差分にアーキテクチャ変更・API変更・非推奨化など影響範囲を伴う記述の追加または変更がある
  • inputContextにdiffが含まれている

ゲート不成立時の出力: NO_REVIEW: change-communication — コミュニケーション計画が必要な設計変更が検出されない

False-positive guards / 抑制条件

  • すでに別 ADR/通知チャネルで整備されており、差分がその参照のみであれば重複指摘を避ける。

Rule / ルール

  • 先頭に要約を 1 行出す(影響範囲・通知・非推奨/移行の要点)。
  • 指摘は最大 8 件。ステークホルダー漏れ、通知対象不明、移行/非推奨の曖昧さを優先。
  • 可能なら「通知文/説明テンプレ」を添える(貼れる短文)。

Checklist / 観点チェックリスト

  • 影響範囲
    • 変更が影響するサービス/チーム/ドメインを列挙しているか。
    • オーナー/責任者(Team/Role)が明記されているか。
  • 通知計画
    • 変更を知らせるチャネル(release notes, mailing list, status page 等)が決まっているか。
    • スケジュール(いつ通知し、いつ施行するか)があるか。
    • 非推奨・移行
    • 旧バージョン/機能の非推奨状況と移行締切があるか。
    • 互換性の切り分け(どのクライアント/サービスが動かなくなるか)が説明されているか。
  • 継続的整合
    • ドキュメント/ADR/図の更新が必要な箇所が TODO/追跡対象としてリストされているか。
    • コミュニケーションの経路(誰が更新するか)を明示しているか。

Output / 出力フォーマット

すべて日本語。<file>:<line>: <message> 形式で出力。

  • 先頭に要約行: (summary):1: <影響範囲/通知/非推奨の要点>
  • 指摘(最大8件):
    • [severity=critical|major|minor|info] を含める。
    • 可能なら「通知テンプレ」等を追加。

例:

  • docs/architecture/change.md:42: [severity=major] 公開API影響が未通知。Fix: 12月14日 15:00に release-notes へ通知予定と明記。

評価指標(Evaluation)

  • 合格: 影響範囲・通知計画・移行方針に抜けがないかを差分に紐づく形で指摘し、アクションに結びつく遷移案がある。
  • 不合格: 一般論やオペレーションの詳細、差分と無関係なステークホルダー批判。

人間に返す条件(Human Handoff)

  • 組織的なポリシー変更や交渉が必要な場合は人間レビューへ。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

<What this skill does>

日本語の概要は準備中です。原文の説明を表示しています。

s977043/river-review42026年10月12日 更新

a11y Accessible Name Basics

無料日本語概要

画像・ボタン・フォーム要素に適切なアクセシブルネームがあるか確認する。

s977043/river-review42026年10月12日 更新

Ensure ADRs capture context, decision, alternatives, tradeoffs, and follow-ups in a way that prevents future drift.

日本語の概要は準備中です。原文の説明を表示しています。

s977043/river-review42026年10月12日 更新

adversarial-review

無料日本語概要

敵対的分析手法を統合したレビューの entry skill。認知バイアス対策の3手法 (Pre-mortem / War Game / Logic Torturing)と、宣言・主張と実態の乖離を突く claim-vs-actual 検出3パターン(Self-Contradiction / Refactor-Claim Audit / Cross-File Leakage)へルーティングし、通常のレビューでは見えない設計の盲点・ 防御の穴・論理の弱点・宣言と実装のズレを可視化する。

s977043/river-review42026年10月12日 更新

Review changes to the Agent Skills import/export bridge for path safety, round-trip fidelity, and validation correctness.

日本語の概要は準備中です。原文の説明を表示しています。

s977043/river-review42026年10月12日 更新

Checks whether AI-assisted work defines review criteria, accessible context, explicit review loop, human judgment boundary, and feedback capture before delegating to an agent.

日本語の概要は準備中です。原文の説明を表示しています。

s977043/river-review42026年10月12日 更新

s977043 のスキルをすべて見る

このスキルの問題を報告する