跳到正文
cccskills
免费在 GitHub 公开

docs-audit

Comprehensive documentation audit and refresh. Checks code-documentation drift, generates prioritized report, then updates with approval. Use for: 'ドキュメント監査', 'docs audit', 'ドキュメント棚卸し', 'README全体見直し', 'documentation health check'.

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

查看安装方法

包含的文件(1)

  • SKILL.md2.3 KB

SKILL.md(原文)

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

Documentation Audit

ドキュメント全体を監査し、コードとの乖離を特定・修正する。

Workflow

Phase 1: 監査(自動)

Task tool (Explore agent) でコード-ドキュメント間の乖離を調査。

対象: README.md, CLAUDE.md, docs/*/.md, 設定ファイル

ファイル探索: git ls-files '*.md' でgit管理下のファイルを列挙する。Glob/Grepを使う場合は node_modules/, .git/, dist/, build/, coverage/ を必ず除外する。

チェック内容:

  • API/コマンド/設定の不一致(削除済み・未記載項目)
  • 存在しないファイル参照
  • 構造・依存関係の変化

出力: 優先度別分類(Critical/High/Medium/Low)+ ファイル:行番号

Phase 2: レポート

監査結果を優先度別に提示し、推奨アクションを示す。

Phase 3: 更新(承認後)

承認された問題をTask tool (general-purpose) で修正。

更新時の品質基準(@~/.claude/rules/code-quality.md Documentation Content セクション参照):

  • コンセプト優先: 目的・設計意図・使い方を書く
  • 陳腐化しやすい情報を避ける: ファイルツリー、タスクリスト、バージョン番号一覧等をハードコードしない
  • 自動導出可能な情報は書かない: tree、git ls-files、コード自体から得られる情報はドキュメントに複製しない
  • 既存の文体・フォーマットを維持

Variants

引数例動作
「レポートだけ」Phase 2で停止
「READMEだけ」スコープ限定
「設定との乖離だけ」特定カテゴリのみ

vs update-docs

スキル用途
update-docsコード変更に追従(コミット後)
docs-audit全体の健全性チェック(定期メンテ)

评价

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

评论

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

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

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

0 / 1000 字

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

同一仓库的技能

Migrate existing ADRs to YAML frontmatter format. Scans docs/decisions/ for ADRs without frontmatter, infers status from body text, shows dry-run for approval. Trigger: /adr-migrate

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

berlysia/dotfiles92026年10月20日 更新

Start or resume an ADR session. Without number: show status overview and recommend next actionable ADR. With number: provide phase-specific guidance. Trigger: /adr-session, /adr-session NNN, /adr-session new

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

berlysia/dotfiles92026年10月20日 更新

Analyze a project's harness maturity and guide staged adoption of Harness Engineering best practices (quality loops, safety gates, linters, CLAUDE.md optimization).

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

berlysia/dotfiles92026年10月20日 更新

bugfix

免费

Standardized bug fix workflow using TDD (Red-Green-Refactor). Use when fixing bugs, resolving issues, or when the user invokes /bugfix. Ensures root cause analysis, failing test first, then minimal fix.

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

berlysia/dotfiles92026年10月20日 更新

clarify

免费

Create detailed specifications by iteratively clarifying unclear points for Plan mode. Use when: After completing a plan when detailed requirements need clarification before implementation.

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

berlysia/dotfiles92026年10月20日 更新

Policy-enforcing installer that deploys hardened Claude Code Action workflows (`@claude` manual mention + dependency-bot auto-fix) into a personal GitHub repository the user administers. Use when asked to introduce Claude Code Action, apply `@claude` mention support, or set up automated CI auto-fix for dependency bot PRs, using the security-hardened templates shipped with this skill.

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

berlysia/dotfiles92026年10月20日 更新

查看 berlysia 的全部技能

报告此技能的问题