القائمة
当需要清理代码库中的死代码、未使用导出、重复代码或未使用依赖时使用 - 安全地识别和删除无用代码
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
何时使用需要为编程项目、monorepo 或多级目录创建/更新 AGENTS.md、CLAUDE.md 软链接、项目级 agent 操作手册、子目录局部规则、验证命令和 Coding Agent 上下文边界时使用。
分析代码库结构并生成中文 token-lean 架构文档。
用于构建或维护个人 LLM 驱动的知识库。触发词：将资料导入 wiki、查询 wiki 知识、检查 wiki 质量、'添加到 wiki'、'我了解什么关于'，或任何提到 'LLM wiki' 的场景。
当有书面实施计划要在单独会话中执行并带审查检查点时使用
用户明确要求隔离工作区、并行分支验证或临时试验时使用 - 创建隔离的 git worktree
开始开发编程相关对话时使用 - 建立如何查找和使用 skills，在做出任何响应前要求先检查适用的 skill
| name | dev-code-cleanup |
| description | 当需要清理代码库中的死代码、未使用导出、重复代码或未使用依赖时使用 - 安全地识别和删除无用代码 |
系统化识别和删除死代码、未使用依赖和重复代码。通过工具检测、分级分类和测试验证确保安全清理。
核心原则： 工具检测 → 风险分级 → 测试验证 → 安全删除
开始时宣布： "I'm using the dev-code-cleanup skill to clean up dead code."
使用场景：
不使用场景：
| 工具 | 语言/框架 | 检测内容 | 命令 |
|---|---|---|---|
| knip | TypeScript/JavaScript | 未使用文件、导出、依赖 | npx knip |
| depcheck | Node.js | 未使用 npm 依赖 | npx depcheck |
| ts-prune | TypeScript | 未使用 TypeScript 导出 | npx ts-prune |
| vulture | Python | 未使用 Python 代码 | vulture src/ |
| deadcode | Go | 未使用 Go 代码 | deadcode ./... |
| cargo-udeps | Rust | 未使用 Rust 依赖 | cargo +nightly udeps |
无工具时： 使用 Grep 搜索导出定义，然后检查是否有导入引用
| 级别 | 示例 | 处理方式 |
|---|---|---|
| SAFE | 未使用的工具函数、内部辅助函数、测试工具 | 可安全删除 |
| CAUTION | 组件、API 路由、中间件 | 检查动态导入和外部调用者 |
| DANGER | 配置文件、入口点、类型定义 | 深入调查后再操作 |
运行适合项目的检测工具：
# TypeScript/JavaScript
npx knip
npx depcheck
npx ts-prune
# Python
vulture src/
# Go
deadcode ./...
将发现的问题按风险分级归类。
对每个 SAFE 项目：
git checkout -- <file> 恢复并跳过删除前检查：
import(), require(), __import__删除死代码后，检查：
未经测试直接删除
批量删除多个项目
忽略动态导入
import() 和字符串引用清理时顺便重构
死代码清理报告
──────────────────────────────
已删除:
- 12 个未使用函数
- 3 个未使用文件
- 5 个未使用依赖
已跳过:
- 2 个项目 (测试失败)
节省:
- 约 450 行代码
- 约 200KB 构建产物
状态: 所有测试通过 ✅
──────────────────────────────