azukiazusa1/sapper-blog-app / .claude/skills/tech-review
tech-review
Verified技術ブログ記事、チュートリアル、技術原稿を、技術的正確性、一次情報、現在の API 挙動、コード、再現性、セキュリティ、アクセシビリティ、互換性の観点からレビューする。技術的な主張、コードサンプル、対応バージョン、仕様、公開前の正確性を確認してほしいと依頼されたときに使用する。一般的な文章校正は article-review に任せ、明示的な依頼なしに原稿を変更しない。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.9 KB |
| agents/openai.yaml | config | 304 B |
| references/technical-checklist.md | markdown | 2.1 KB |
| scripts/run_code_samples.py | script | 14.8 KB |
references/technical-checklist.md
View on GitHub# 技術記事の技術レビューチェックリスト
該当する項目だけを適用し、影響の大きい問題を優先する。
## 主張と根拠
- 中心的な事実が一次情報または記録された観測で裏付けられている
- バージョン依存の情報を現在の資料で確認している
- 仕様と公式文書を文脈どおりに説明している
- 過去の議論に日付があり、現在の要件として扱っていない
- 根拠が近接する主張を実際に支持している
- 設計理由が見つからない場合に推測で補っていない
- 事実、観測、推論、意見を区別している
## コードと再現性
- 構文、型、制御フロー、API の使い方が対象バージョンで正しい
- import、依存関係、環境変数、設定、起動順序が揃っている
- コマンドを実行するディレクトリが明確である
- 記事の抜粋が検証済みプロジェクトと一致している
- 期待結果と観測結果が一致している
- 検証日、環境、成功条件、手動確認の操作と観測を記録している
- 構文検査や単一環境の結果を過度に一般化していない
- 未検証の挙動を明示している
## 設計と読者理解
- 採用した方法が記事で述べた問題を解決している
- 中心的な代替案とトレードオフを公平に扱っている
- 教育上の簡略化が危険または無効な慣習を教えていない
- 最小例から実用例へ進む過程で必要な概念を隠していない
## リスクと互換性
- セキュリティとプライバシーへの影響を必要に応じて扱っている
- 秘密情報、実際の認証情報、非公開 URL がサンプルや出力にない
- UI では意味論、キーボード、支援技術への影響を考慮している
- ブラウザ、ランタイム、プラットフォーム、ライブラリの互換性が正しい
- 失敗条件、後始末、運用上の制約、フォールバックを説明している
- 実験的な API と不安定な依存関係を記事の早い段階で示している
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |