跳到正文
cccskills
免费在 GitHub 公开

comment-analysis

コードコメントの正確性、完全性、長期的な保守性を分析する。JSDoc、コメント、README等のドキュメントが変更された場合に使用。

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.0 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Comment Analysis スキル

目的

コードコメントの正確性、完全性、長期的な保守性を分析し、技術的負債を防ぐ。

検証プロセス

1. 事実精度の確認

  • 関数署名(パラメータ、戻り値の型)が一致しているか
  • 説明された動作が実際のコードと一致しているか
  • 参照されている型、関数、変数が存在するか

2. 完全性の評価

  • 重要な仮定がドキュメント化されているか
  • 副作用が記載されているか
  • エラー状態が説明されているか
  • 複雑なアルゴリズムの解説があるか

3. 長期的価値の評価

  • 「なぜ」を説明しているか(「何を」だけでなく)
  • 非自明なロジックを説明しているか
  • 過度に冗長でないか

4. 誤解要素の特定

  • 曖昧な表現の有無
  • 古い参照の有無
  • 時代遅れな仮定の有無

出力形式

# Comment Analysis Results

## Critical Issues(事実として不正確)

### [ファイル名:行番号]

- コメント: "..."
- 問題: コメントが実際のコードと矛盾している
- 実際のコード: ...
- 推奨修正: ...

## Improvement Opportunities(改善可能)

### [ファイル名:行番号]

- コメント: "..."
- 問題: 情報が不完全
- 推奨追加内容: ...

## Positive Findings(良い例)

### [ファイル名:行番号]

- コメント: "..."
- 評価: 「なぜ」を適切に説明している

## Summary

- Critical Issues: X
- Improvement Opportunities: X
- Positive Findings: X

注意事項

  • 変更されたファイルのコメントのみを分析
  • 事実の不正確さを最優先で報告
  • 良い例も報告して学習を促進
  • 主観的な「スタイル」の指摘は避ける

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

プロジェクトガイドラインへの準拠をチェックし、バグ、スタイル違反、コード品質問題を検出する。PRレビュー時に使用。

中文简介正在准备中。当前显示原文说明。

feel-flow/ai-spec-driven-development72026年10月18日 更新

Enforces project coding standards during code review: naming conventions (PascalCase for classes, camelCase for methods/variables, UPPER_SNAKE_CASE for constants, kebab-case for files), standard file structure, anti-magic-number policy, file size limits (500/800 lines), security patterns, and design patterns. Use when reviewing code, writing new code, or checking adherence to project conventions.

中文简介正在准备中。当前显示原文说明。

feel-flow/ai-spec-driven-development72026年10月18日 更新

機能を保持したまま不要な複雑性を排除し、コードの簡潔性と可読性を向上させる。30行超の関数や3段以上のネスト検出時に使用。

中文简介正在准备中。当前显示原文说明。

feel-flow/ai-spec-driven-development72026年10月18日 更新

サイレント失敗を検出し、堅牢なエラーハンドリングを確保する。PRレビューでのエラーハンドリング検査時に使用。

中文简介正在准备中。当前显示原文说明。

feel-flow/ai-spec-driven-development72026年10月18日 更新

Enforces error handling standards: silent error prohibition, custom error class hierarchy (AppError base with category never-fallback / transient / permanent, cause preservation, ValidationError / UnauthorizedError / UpstreamError etc. — canonical definitions in ERRORS.md), external-boundary normalization (normalizeExternalError), Result pattern (Result.ok/Result.fail), proper try-catch with error type checking, structured error logging with a single Logger contract, fallback prohibition categories (isNeverFallback), and HTTP status code mapping. Use when implementing error handling, reviewing catch blocks, or designing error responses.

中文简介正在准备中。当前显示原文说明。

feel-flow/ai-spec-driven-development72026年10月18日 更新

Creates and reviews agent skills safely by enforcing deletion-prevention harness rules: no fixed absolute temp paths, no cwd-dependent cleanup, no wildcard deletes, no workspace-external file operations, no silent cleanup failures, and mandatory temp-root validation before any destructive command. Use when creating a new skill, updating an existing SKILL.md, or reviewing prompts/runbooks that include temp files, extraction, cleanup, PowerShell, bash, rm, del, Remove-Item, or archive expansion.

中文简介正在准备中。当前显示原文说明。

feel-flow/ai-spec-driven-development72026年10月18日 更新

查看 feel-flow 的全部技能

报告此技能的问题