Skip to content

azukiazusa1/sapper-blog-app / .claude/skills/article-review

article-review

Verified

引数で指定した記事のレビューを行います。記事スラッグを引数に渡すと、textlint による自動校正と誤字脱字・文法的な誤りの指摘を行います。/article-review [スラッグ] の形式で呼び出してください。記事を書いた後のチェック、公開前の校正、文章の品質確認にも使用してください。

FileKindSize
SKILL.mdskill md2.7 KB
agents/openai.yamlconfig319 B
references/editorial-checklist.mdmarkdown2.0 KB
references/notation-rules.mdmarkdown978 B

references/editorial-checklist.md

View on GitHub
# 技術記事の編集チェックリスト

該当する項目だけを適用し、読者への影響がある差を指摘する。

## メタデータと導入

- タイトルが技術と具体的な価値を示している
- `about` が背景、対象技術、読者の到達点を 2〜3 文で具体的に示している
- 導入が問題、変化、または実用的な結果から始まる
- 実験的な機能や重大な制約が、読者が手順へ進む前に示されている

## 構成と説明

- 前提、従来の方法、最小例、実用例の順序が自然である
- 見出しが実装内部の分類ではなく、読者の疑問や作業に沿っている
- 各段落が 1 つの主要な考えを進めている
- 原因、操作、結果の関係が明確である
- 抽象的な説明の後に必要な具体例がある

## コードと媒体

- コードの前に目的、後に重要な行と観測結果がある
- 静的な見た目、動き、操作に適切な媒体か `TODO(media)` コメントがある
- ローカルの媒体は `npm run upload:media` が処理できる `![代替テキスト](パス)` または `!v(パス)` で参照し、ファイルがある媒体を `TODO(media)` コメントの中に書いていない
- 媒体の前で見るべき点、後で確認できる結果を説明している
- 代替テキストとキャプションが内容を説明している
- 内部検証成果物のパス、ディレクトリ、起動コマンド、公開されないサンプルへ言及していない

## 言語と終わり方

- 日本語と英数字、数値、単位、インラインコードの間に半角スペースがある
- 同じ概念に同じ用語を使い、公式名称を維持している
- `です`・`ます` 調と筆者固有の語調が一貫している
- `## まとめ` が本文の具体的な結論を箇条書きで再掲している
- `## 参考` に一次情報があり、本文中の主張からも根拠へリンクしている
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 implementationStars: 323kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 fallbackStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 alwaysStars: 323kUpdated Claude CodeCodexVerifiedInstall