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

Capacity, Performance & Cost Assumptions

Ensure architecture/design docs state traffic assumptions, performance budgets, resource limits, and cost risks for critical paths.

インストール方法を見る

含まれるファイル(3)

  • SKILL.md4.0 KB
  • fixtures/01-no-traffic-assumption-retry-amplification-should-detect.md4.3 KB
  • fixtures/02-poc-out-of-operation-should-not-detect.md3.1 KB

SKILL.md(原文)

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

Pattern declaration

Primary pattern: Reviewer Secondary patterns: Inversion Why: 性能・容量・コストの前提漏れをチェックリスト型で評価し、本番ではじめて発覚するリスクを低減する

Goal / 目的

  • 設計の差分から、性能/容量/コストの前提不足により “本番で初めて詰む” リスクを減らす。

Non-goals / 扱わないこと

  • 具体的なインフラ構成やクラウドサービスの最適解を断定しない。
  • 実装レベルのチューニング(クエリ改善やキャッシュ実装など)。

Pre-execution Gate / 実行前ゲート

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

  • 差分に設計ドキュメント(設計書/ADR/容量計画書)の変更がある
  • 差分に性能・容量・コストの前提や目標に関わる記述の追加または変更がある
  • inputContextにdiffが含まれている

ゲート不成立時の出力: NO_REVIEW: capacity-cost-design — 性能・容量・コスト設計に関わる変更が検出されない

False-positive guards / 抑制条件

  • PoC/運用対象外と明記されている場合は、必須要件としては扱わず “確認” に留める。

Rule / ルール

  • 先頭に要約を 1 行出す(クリティカルパスと前提の変更点)。
  • 指摘は最大 8 件まで。性能予算/上限制約/コスト爆発のリスクを優先。
  • “追記テンプレ” を付けて、文書に落とせる形にする。

Checklist / 観点チェックリスト

  • トラフィック前提
    • 想定 QPS/ピーク、データ量、同時接続などの前提があるか。
    • 増加率(成長)と期間の前提があるか。
  • 性能予算(Budget)
    • 重要フローのレイテンシ目標(p95/p99)と内訳があるか。
    • タイムアウト/リトライで “増幅” しない前提になっているか。
  • ボトルネックと限界
    • 依存(外部 API/DB/キュー)の上限と、劣化時のふるまいがあるか。
    • Backpressure(キュー溢れ、レート制限)と、落としどころがあるか。
  • コスト
    • コストドライバー(データ転送、ストレージ、ログ、外部 API 課金)が列挙されているか。
    • コスト上限/監視/アラートの前提があるか。

Output / 出力フォーマット

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

  • 先頭に要約を 1 行: (summary):1: <重要フローと前提/予算の要点>
  • 以降は指摘(最大 8 件):
    • <message> に [severity=critical|major|minor|info] を含める。
    • 可能なら “追記テンプレ” を 1 行付ける。

追記テンプレ例:

  • 前提: peakQPS=<>, payload=<>, dataGrowth=<>, 期間=<>
  • 性能: p95=<ms>, p99=<ms>, timeout=<ms>, retry=<回数>
  • コスト: ドライバー=<>, 上限=<>, 監視=<メトリクス>

評価指標(Evaluation)

  • 合格基準: 差分に紐づく前提/予算/上限の抜けが優先度付きで指摘され、追記案がある。
  • 不合格基準: 推測の断定、差分と無関係な一般論、指摘過多。

人間に返す条件(Human Handoff)

  • コスト上限や性能目標がビジネス判断に跨る場合は人間(PM/Tech Lead)へ返す。

レビュー

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

同じリポジトリのスキル

概要と使いどころ

<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 のスキルをすべて見る

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