Agent skill · software engineering · affaan-m
plankton-code-quality
使用Plankton进行编写时代码质量强制执行——通过钩子在每次文件编辑时自动格式化、代码检查和Claude驱动的修复。
Why this skill is useful
Adds a multi-stage executable script for automatic code formatting, linting, and error correction that enhances the AI's capabilities in code quality enforcement.
What it needs
Requires jaq, ruff, uv installed locally. About 3k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
Plankton 代码质量技能 Plankton（作者：@alxfazio）的集成参考，这是一个用于 Claude Code 的编写时代码质量强制执行系统。Plankton 通过 PostToolUse 钩子在每次文件编辑时运行格式化程序和 linter，然后生成 Claude 子进程来修复代理未捕获的违规。 何时使用 你希望每次文件编辑时都自动格式化和检查（不仅仅是提交时） 你需要防御代理修改 linter 配置以通过检查，而不是修复代码 你想要针对修复的分层模型路由（简单样式用 Haiku，逻辑用 Sonnet，类型用 Opus） 你使用多种语言（Python、TypeScript、Shell、YAML、JSON、TOML、Markdown、Dockerfile） 工作原理 三阶段架构 每次 Claude Code 编辑或写入文件时，Plankton 的 multilinter.sh PostToolUse 钩子都会运行： 主代理看到的内容 场景 代理看到 钩子退出码 ---------- ----------- ----------- 无违规 无 0 全部由子进程修复 无 0 子进程后仍存在违规 [hook] N violation(s) remain 2 建议性警告（重复项、旧工具） [hook:advisory] ... 0 主代理只看到子进程无法修复的问题。大多数质量问题都是透明解决的。 配置保护（防御规则博弈） LLM 会修改 .ruff.toml 或 biome.json 来禁用规则，而不是修复代码。Plankton 通过三层防御阻止这种行为： 1. PreToolUse 钩子 — protectlinterconfigs.sh 在编辑发生前阻止对所有 linter 配置的修改 2. Stop 钩子 — stopconfigguardian.sh 在会话结束时通过 git diff 检测配置更改 3. 受保护文件列表 — .ruff.toml, biome.json, .shellcheckrc, .yamllint, .hadolint.yaml 等 包管理器强制执行 Bash 上的 PreToolUse 钩子会阻止遗留包管理器： pip, pip3, poetry, pipenv → 被阻止（使用 uv） npm, yarn, pnpm → 被阻止（使用 bun） 允许的例外：npm audit, npm view, npm publish 设置 快速开始 无需安装命令，无需插件配置。当你运行 Claude Code 时，.claude/settings.json 中的钩子会在 Plankton 目录中被自动拾取。 按项目集成 要在你自己的项目中使用 Plankton 钩子： 1. 将 .claude/hooks/ 目录复制到你的项目 2. 复制 .claude/settings.json 钩子配置 3. 复制 linter 配置文件（.ruff.toml, biome.json 等） 4. 为你使用的语言安装 linter 语言特定依赖 语言 必需 可选 ---------- ---------- ---------- Python ruff, uv ty（类型）, vulture（死代码）, bandit（安全） TypeScript/JS biome oxlint, semgrep, knip（死导出） Shell shellcheck, shfmt — YAML yamllint — Markdown markdownlint-cli2 — Dockerfile hadolint (>= 2.12.0) — TOML taplo — JSON jaq — 与 ECC 配对使用 互补而非重叠 关注点 ECC Plankton --------- ----- ---------- 代码质量强制执行 PostToolUse 钩子 (Prettier, tsc) PostToolUse 钩子 (20+ linter + 子进程修复) 安全扫描 AgentShield, security-reviewer 代理 Bandit (Python), Semgrep (TypeScript) 配置保护 — PreToolUse 阻止 + Stop 钩子检测 包管理器 检测 + 设置 强制执行（阻止遗留包管理器） CI 集成 — 用于 git 的 pre-commit 钩子 模型路由 手动 (/model opus) 自动（违规复杂度 → 层级） 推荐组合 1. 将 ECC 安装为你的插件（代理、技能、命令、规则） 2. 添加 Plankton 钩子以实现编写时质量强制执行 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/plankton-code-quality--eefeb0