levnikolaevich/claude-code-skills

# Claude Code 技能    [](https://github.com/levnikolaevich/claude-code-skills) [插件](#plugins) · [安装](#installation) · [快速开始](#quick-start) · [工作流](#workflow) · [VPS 代理](#vps-agent) · [MCP](#mcp-servers-optional) · [AI 审查](#ai-review-models-optional) · [常见问题](#faq) · [完整技能树](#whats-inside) · [链接](#links) ## 插件 添加一次市场，然后只安装你需要的插件。每个插件独立工作。 ``` # Claude Code：添加一次 marketplace /plugin marketplace add levnikolaevich/claude-code-skills # Claude Code：安装任何你需要插件 /plugin install agile-workflow@levnikolaevich-skills-marketplace /plugin install documentation-pipeline@levnikolaevich-skills-marketplace /plugin install codebase-audit-suite@levnikolaevich-skills-marketplace /plugin install project-bootstrap@levnikolaevich-skills-marketplace /plugin install optimization-suite@levnikolaevich-skills-marketplace /plugin install community-engagement@levnikolaevich-skills-marketplace /plugin install setup-environment@levnikolaevich-skills-marketplace ``` ``` # Codex CLI：添加 marketplace，然后从 /plugins 安装 codex plugin marketplace add levnikolaevich/claude-code-skills codex /plugins ``` | 插件 | 描述 | |--------|-------------| | **agile-workflow** | 范围分解、故事/任务管理、执行、质量门控、编排 | | **documentation-pipeline** | 完整项目文档管道，支持自动检测（后端/前端/DevOps）| | **codebase-audit-suite** | 文档、安全、构建、代码质量、测试、架构、性能 | | **project-bootstrap** | 创建或转换项目为生产就绪的清洁架构 | | **optimization-suite** | 性能优化、依赖升级、代码现代化 | | **community-engagement** | GitHub 社区管理：分类、公告、RFC、响应 | | **setup-environment** | 安装 CLI 代理、配置 MCP 服务器、对齐市场插件、审计指令文件 | 在 [skills.sh](https://skills.sh/LevNikolaevich/claude-code-skills) 浏览和发现各个技能。 ## 安装 **前置条件：** [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 或 [OpenAI Codex CLI](https://developers.openai.com/codex) ``` # Claude Code /plugin marketplace add levnikolaevich/claude-code-skills /plugin install setup-environment@levnikolaevich-skills-marketplace # Codex CLI codex plugin marketplace add levnikolaevich/claude-code-skills codex /plugins ``` 验证：运行 `ln-010-dev-environment-setup` ## 快速开始 **独立模式**（立即可用，无需设置）： ``` ln-010-dev-environment-setup # Set up agents, MCP, and marketplace plugins ln-620-codebase-auditor # Audit your code for issues ln-100-documents-pipeline # Generate documentation ``` **完整敏捷工作流**（Linear、GitHub Issues 或文件模式 — 在 ln-010 设置期间选择，持久化在 `.hex-skills/environment_state.json`）： ``` ln-200-scope-decomposer # Scope -> Epics -> Stories ln-1000-pipeline-orchestrator # Artifact-driven pipeline: tasks → validation → execution → quality gate ``` **手动分步执行**（如果你更喜欢控制每个阶段）： ``` ln-400-story-executor # Execute Story tasks ln-500-story-quality-gate # Quality gate + test planning ``` ## 工作流 ``` ln-010-dev-environment-setup # 0. Set up dev environment (once) ↓ ln-100-documents-pipeline # 1. Documentation ↓ ln-200-scope-decomposer # 2. Scope -> Epics -> Stories ↓ ln-1000-pipeline-orchestrator # 3. Full artifact-driven pipeline: 300 → 310 → 400 → 500 → Done ``` 协调器将生命周期状态与循环健康状态分开：`status` 表示运行到哪里，产物/检查点证明完成，`loop_health` 决定是否值得重试。程序性技能使用 SOP/TWI 风格的使用点检查清单，使风险步骤包含操作、关键点、原因、证据、异常和防护，靠近使用时刻。 ## VPS 代理 `ln-030-vps-bootstrap` 是 VPS 代理协调器。它通过四个独立的运行时工作线程将 Linux VPS 转换为始终在线的 Claude Code + Codex 操作环境：共享主机设置、项目运行时设置、`hex-relay` 生命周期和环境诊断。 `hex-relay` 是由 `ln-030` 部署的 Telegram 和 HTTP 控制平面。它作为独立 TypeScript 产品运行在 [`agents/hex-relay/`](agents/hex-relay/) 下，具有 SQLite 支持的状态、Telegram 入口、Claude 钩子接收、`/tasks` 交接、内存、调度审计、每用户会话和持久的出站回复。 重要的设计要点：一个 VPS 可以共享单个代理用户和共享的 Claude/Codex 认证，同时保持项目和 Telegram 用户运行时状态隔离。每个允许的 Telegram 用户获得自己的 `${SERVICE_PREFIX}-god-` tmux 目标、沙盒 HOME 在 `${PROJECT_DIR}/.agent-home/users//` 下、会话缓存、恢复状态和访问控制的 `/sessions` 视图。工作区无法读取提供商令牌、Telegram 令牌、relay 数据库文件、兄弟项目目录或主机 systemd；`hex-relay` 拥有该控制平面边界。 面向操作员的功能： - `/tasks` 使用控制平面凭证列出提供商问题，并将恰好一个选中的任务注入到点击用户当前会话中。 - `/new_session` 和 `/sessions` 管理每用户 Claude 会话，而不混合用户历史。 - `/users` 支持从 Telegram 进行待处理/允许/阻止的访问管理。 - Claude 最终回复、进度状态、调度审计和持久内存通过 SQLite 支持的队列流动，而不是临时聊天抓取。 当你想让一个 VPS 托管可以从 Telegram 监督的自主项目工作时，使用此路径。同一入口处理新 VPS、现有 VPS 上的第二个项目、`hex-relay` 重新部署、诊断以及来自 VPS 本地 `/etc/agent-fleet/environments/*.yaml` 注册表的声明式 fleet `plan/apply`。 ``` ln-030-vps-bootstrap # coordinator: host runtime + project runtime + optional hex-relay + diagnostics ``` 关键文档： - [ln-030 SKILL.md](plugins/setup-environment/skills/ln-030-vps-bootstrap/SKILL.md) — 协调器工作流、工作线程调用、fleet 模式和完成定义。 - [Fleet 注册表契约](plugins/setup-environment/skills/ln-030-vps-bootstrap/references/fleet_registry.md) — VPS 重用和 fleet `plan/apply` 的声明式环境注册表。 - [hex-relay README](agents/hex-relay/README.md) — 产品架构、环境、运行时行为、API、数据库和部署。 - [hex-relay Telegram 运行手册](agents/hex-relay/docs/telegram-operator-runbook.md) — BotFather 强化、菜单命令和多用户入职培训。 ## MCP 服务器（可选） 捆绑的 MCP 服务器扩展代理能力 — 哈希验证编辑、代码智能和远程访问。所有技能都可以在没有 MCP 的情况下工作（回退到内置工具），但 MCP 服务器可以提高准确性并节省 token。MCP 错误保持为 `status: "ERROR"`，并包含 `failure_class`、`next_action` 和恢复字段，以便技能可以将传输/工具/认证/速率限制信号输入循环健康，而无需发明第二个重试循环。 ### 捆绑服务器 | 服务器 | 功能 | 工具 | 文档 | |--------|-------------|-------|------| | **[hex-line-mcp](mcp/hex-line-mcp/)** | 每一行都携带内容哈希 — 编辑证明代理看到了当前内容。防止过时上下文损坏。包括验证钩子。 | 9 | [README](mcp/hex-line-mcp/README.md) · [npm](https://www.npmjs.com/package/@levnikolaevich/hex-line-mcp) | | **[hex-graph-mcp](mcp/hex-graph-mcp/)** | 将代码库索引到确定性 SQLite 图中，具有框架感知的覆盖层、优先功能的质量工具、可选的 SCIP 互操作以及架构/引用分析。 | 14 | [README](mcp/hex-graph-mcp/README.md) · [npm](https://www.npmjs.com/package/@levnikolaevich/hex-graph-mcp) | | **[hex-ssh-mcp](mcp/hex-ssh-mcp/)** | 通过 SSH 进行哈希验证的远程文件编辑和 SFTP 传输。规范化输出以最小化 token 使用。 | 8 | [README](mcp/hex-ssh-mcp/README.md) · [npm](https://www.npmjs.com/package/@levnikolaevich/hex-ssh-mcp) | 确定性范围规则：`hex-line` 和 `hex-graph` 将 `path` 作为项目锚点。在正常使用中，代理自动从活动文件或项目根目录填充它，因此用户通常不需要手动输入。`hex-ssh` 在 Windows/macOS/Linux 主机上运行；远程 shell 工具保持 POSIX 导向，而 SFTP 传输支持平台感知的远程路径。 `hex-graph-mcp` 质量快照：`106/106` 测试通过，`1` 个精选语料库，`1` 个固定外部语料库，解析器优先 `green`。 ### 外部服务器 | 服务器 | 用途 | API 密钥 | 使用者 | |--------|---------|---------|---------| | **[Context7](https://context7.com)** | 库文档、API、迁移指南 | 可选（[仪表板](https://context7.com/dashboard)）| ln-310、ln-511、ln-640+ | | **[Ref](https://docs.ref.tools/install)** | 标准、RFC、最佳实践 | 需要（[ref.tools/keys](https://ref.tools/keys)）| ln-310、ln-511、ln-640+ | | **[Linear](https://linear.app/docs/mcp)** | 问题跟踪（敏捷工作流）| 通过浏览器 OAuth | ln-300+、ln-400+、ln-500+ | **CLI 设置：** ``` # hex-line — 哈希验证的文件编辑（已捆绑） npm i -g @levnikolaevich/hex-line-mcp claude mcp add -s user hex-line -- hex-line-mcp # hex-ssh — 带哈希验证的 token 高效 SSH（已捆绑） npm i -g @levnikolaevich/hex-ssh-mcp claude mcp add -s user hex-ssh -- hex-ssh-mcp # hex-graph — 代码知识图谱（已捆绑） npm i -g @levnikolaevich/hex-graph-mcp claude mcp add -s user hex-graph -- hex-graph-mcp # Context7 — 库文档（HTTP，可选 API key） claude mcp add -s user --transport http --header "CONTEXT7_API_KEY: YOUR_KEY" context7 https://mcp.context7.com/mcp # Ref — 标准与最佳实践（HTTP，需要 API key） claude mcp add -s user --transport http --header "x-ref-api-key: YOUR_KEY" Ref https://api.ref.tools/mcp # Linear — 问题跟踪（HTTP，通过浏览器 OAuth） claude mcp add -s user --transport http linear-server https://mcp.linear.app/mcp ``` ### 代理引导 MCP 服务器可能安装正确但在实践中仍输给内置工具。`hex-line-mcp` 通过一种输出样式和五个 Claude 钩事件保持 Claude 一致： | 机制 | 工作方式 | |-----------|-------------| | **[输出样式](mcp/hex-line-mcp/output-style.md)** | 注入系统提示 — 将内置工具映射到 MCP 等价物（`Read` → `hex-line read_file`，`Edit` → `hex-line edit_file`）| | **SessionStart 钩子** | 注入紧凑的引导提示，并在存在活动 `hex-line` 输出样式时推迟使用它 | | **PreToolUse 钩子** | 硬重定向项目文本 `Read`/`Edit`/`Write`/`Grep`/`Glob`，重定向 Bash 文件检查命令，阻止危险命令，对 mutating MCP 工具强制执行计划模式 | | **PostToolUse 钩子** | 过滤冗长的 Bash 输出（50+ 行）：规范化、去重、截断到前 15 行 + 后 15 行 | | **ConfigChange 钩子** | 在会话中设置更改时使缓存状态失效 | | **PermissionDenied 钩子** | 可观察性：记录 Claude 在重定向提示后拒绝工具调用时的情况 | 钩子和输出样式在 `hex-line-mcp` 启动时自动同步。安装后的首次运行自动执行初始同步。 ## AI 审查模型（可选） 审查使用两个 CLI 代理：Claude Code 和 OpenAI Codex。活动主机不会将自己称为顾问；Claude 托管的运行委托给 Codex，而 Codex 托管的运行委托给 Claude。 | 模型 | CLI | 版本 | 使用者 | 设置 | |-------|-----|---------|---------|----------| | **[Codex](https://developers.openai.com/codex)** | `codex` | 用户配置 | ln-310、ln-510、ln-813 | `codex exec --full-auto` | | **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | `claude` | 用户配置 | ln-310、ln-510、ln-813 | `claude -p --dangerously-skip-permissions` | **审查工作流：** 1. **主机感知路由** — 选择其他 CLI 作为外部顾问 2. **关键验证** — 主机代理在接受每个建议之前验证它 3. **过滤** — 仅显示支持的高影响建议 4. **回退** — 如果外部顾问不可用，则进行自我审查 **安装：** ``` # Codex (OpenAI) npm install -g @openai/codex codex login # Claude Code npm install -g @anthropic-ai/claude-code claude auth login ``` **配置：** 审查代理使用复制到每个技能本地 `references/agents/` 目录中的提示模板和架构。无需手动设置。 **审计跟踪：** 所有提示/结果保存到 `.agent-review/{agent}/` 以保持透明： ``` .agent-review/ ├── codex/ │ ├── PROJ-123_storyreview_prompt.md │ ├── PROJ-123_storyreview_result.md │ └── PROJ-123_session.json └── claude/ └── (same structure) ``` 其他配置的代理使用相同的每代理目录结构。

使用外部 AI 审查的技能

- **ln-310-multi-agent-validator** — 故事/任务验证，具有主机感知的 Claude/Codex 审查 - **ln-510-quality-coordinator** — 代码实现审查，具有主机感知的 Claude/Codex 审查 - **ln-813-optimization-plan-validator** — 优化计划审查，在执行前进行 所有技能支持： - 会话恢复用于多轮辩论 - 零超时（等待完成） - 只读分析（无项目修改） - 互联网访问用于研究

在代理之间共享技能和 MCP

**为每个代理独立安装技能。** 不要将一个代理的插件根目录符号链接到另一个代理的发现根目录。 Claude Code 使用 `.claude-plugin/marketplace.json`。Codex 使用 `.agents/plugins/marketplace.json` 以及每个插件的 `.codex-plugin/plugin.json` 清单。两个表面都指向 `plugins/*` 下的相同插件优先捆绑；根 `shared/` 是开发阶段的规范源，用于 2 个或更多技能重用的文件，并通过 `tools/marketplace/shared-registry.json` 分发到技能本地的 `references/`。 **MCP 设置位置**（用于手动共享）： | 代理 | 配置文件 | 格式 | 文档 | |-------|------------|--------|------| | **Claude Code** | `~/.claude/settings.json` | JSON（`mcpServers: {}`）| [文档](https://docs.anthropic.com/en/docs/claude-code) | | **Codex CLI** | `~/.codex/config.toml` | TOML（`[mcp_servers.name]`）| [文档](https://developers.openai.com/codex/mcp) | **注意：** Claude 和 Codex 使用不同的配置格式和原生插件流程。`ln-013-config-syncer` 为两个代理独立安装或验证选定的市场插件，默认为 `agile-workflow`，并以非破坏性方式对齐 MCP/策略设置。

## 常见问题

什么是 Claude Code 技能？

一个用于 [Claude Code](https://claude.ai/code) 的插件，提供生产就绪的技能，自动化完整的敏捷开发生命周期 — 从项目引导和文档到范围分解、任务执行、质量门控和全面代码审计。

它是免费和开源的吗？

是的。MIT 许可证，完全开源。无需 API 密钥，无需付费服务。Claude Code CLI 是唯一的前置条件。

它支持哪些语言和框架？

引导技能将 React、.NET 和 Python 项目脚手架到清洁架构。审计和执行技能与语言无关 — 适用于 Claude Code 可以读取的任何代码库。依赖审计器覆盖 npm、NuGet 和 pip 生态系统。

如何安装它？

``` # 添加一次 marketplace /plugin marketplace add levnikolaevich/claude-code-skills # 安装一个插件 /plugin install agile-workflow@levnikolaevich-skills-marketplace # 或安装完整套件 /plugin install agile-workflow@levnikolaevich-skills-marketplace /plugin install documentation-pipeline@levnikolaevich-skills-marketplace /plugin install codebase-audit-suite@levnikolaevich-skills-marketplace /plugin install project-bootstrap@levnikolaevich-skills-marketplace /plugin install optimization-suite@levnikolaevich-skills-marketplace /plugin install community-engagement@levnikolaevich-skills-marketplace /plugin install setup-environment@levnikolaevich-skills-marketplace ```

我需要哪个插件？

| 如果你想... | 安装 | |---|---| | 运行完整敏捷管道（计划 → 执行 → 审查）| `agile-workflow` | | 生成项目文档 | `documentation-pipeline` | | 审计现有代码问题 | `codebase-audit-suite` | | 脚手架新项目或重构现有项目 | `project-bootstrap` | | 优化性能、依赖、捆绑大小 | `optimization-suite` | | 管理 GitHub 社区（分类、公告、RFC、响应）| `community-engagement` | | 设置多代理开发环境 | `setup-environment` | | 全部 | `/plugin marketplace add levnikolaevich/claude-code-skills` + 所有 7 个 `/plugin install ...@levnikolaevich-skills-marketplace` 命令 | 添加一次市场，然后只安装你需要的。

它是否需要 Linear、GitHub 或任何外部依赖？

不。所有技能都可以在没有外部跟踪器的情况下工作。Linear 和 GitHub Issues 集成是可选的 — 你在 `ln-010` 设置期间选择跟踪器提供商，选择持久化在 `.hex-skills/environment_state.json` 中。文件模式（本地 markdown + `kanban_board.md`）始终可用，无需 API 密钥或付费服务。

我可以在现有项目上使用它吗？

可以。`ln-700-project-bootstrap` 具有转换模式，可以将现有项目重构为清洁架构，而无需从头开始。审计技能（`ln-6XX`）可以独立于任何代码库工作 — 无需设置。

它如何自动化敏捷工作流？

技能形成完整管道：`ln-700` 引导项目 → `ln-100` 生成文档 → `ln-200` 将范围分解为史诗和故事 → `ln-1000` 通过协调器阶段产物驱动 `ln-300 -> ln-310 -> ln-400 -> ln-500`。任务计划、执行、质量和测试规划工作线程是有状态和可恢复的，而协调器仅从机器可读的产物中做出决策。

我可以运行单个技能而不使用完整管道吗？

可以。大多数技能可以独立工作 — 只需直接调用它们（例如，`/ln-620-codebase-auditor` 进行完整代码审计）。管道编排器（`ln-1000`、`ln-400`、`ln-510`、`ln-520`）协调其他技能，但不是必需的，它们的工作线程仍然可以独立工作。在托管运行中，协调器传递确定性 `runId` 和精确的 `summaryArtifactPath`；在独立运行中，工作线程创建自己的运行时状态和摘要路径。

它可以自动生成测试吗？

可以。`ln-520-test-planner` 编排完整的测试规划管道，`ln--auto-test-planner` 创建基于风险的测试场景（E2E、集成、单元），`ln-404-test-executor` 实现测试任务。手动测试由 `ln-522-manual-tester` 覆盖，具有可执行的 bash 脚本。运行 `ln-630-test-auditor` 审计跨 7 个类别的现有测试套件。

它如何处理"差不多正确"的 AI 生成代码？

通过自动审查循环。`ln-402-task-reviewer` 检查每个任务输出，`ln-403-task-rework` 修复问题并重新提交审查，`ln-500-story-quality-gate` 运行 4 级门控（通过/担忧/失败/豁免），然后才将任何故事标记为完成。代码永远不会在未通过质量检查的情况下交付。

它是否取代人工代码审查？

不 — 它增强人工审查。Claude/Codex 交叉检查在人工审阅者看到代码之前捕获问题。人工批准点内置于工作流中，在故事验证（`ln-310`）和质量门控（`ln-500`）时。目标是减少审阅者负担，而不是消除监督。

它可以捕获 AI 生成代码中的技术债务吗？

可以。审计技能专门针对 AI 引起的技术债务：`ln-623` 检查 DRY/KISS/YAGNI 违规，`ln-626` 查找死代码和未使用的导入，`ln-640` 审计架构模式演变，`ln-644` 检测依赖循环和耦合指标，`ln-645` 查找可被经过实战测试的开源包替换的自定义代码，`ln-646` 根据框架特定约定验证项目结构。运行 `ln-620-codebase-auditor` 并行扫描所有 9 个类别。

审计技能可以检测什么？

5 组审计技能：文档质量（结构、语义、事实检查、内联代码文档）、代码库健康（安全、构建、DRY/KISS/YAGNI、复杂性、依赖、死代码、可观察性、并发、生命周期）、测试套件（业务逻辑、E2E 覆盖、价值评分、覆盖差距、隔离、手动测试质量、测试结构）、架构（模式、层边界、API 契约、依赖图、OSS 替换、项目结构、环境配置）和持久化性能（查询效率、事务、运行时、资源生命周期）。

它如何处理多栈或混合语言项目？

引导技能（`ln-7XX`）支持 React、.NET 和 Python 项目结构。审计技能具有语言感知能力 — `ln-622-build-auditor` 检查跨栈的编译器/类型错误，`ln-625-dependencies-auditor` 扫描 npm、NuGet 和 pip 包，`ln-651-query-efficiency-auditor` 捕获无论使用何种 ORM 的 N+1 查询。

它使用哪些 AI 模型？

活动主机模型执行编排和验证。对于代码和故事审查，技能可以委托给其他 CLI 代理：Claude 托管的运行使用 Codex 作为顾问，而 Codex 托管的运行使用 Claude 作为顾问。

包含哪些 MCP 服务器？

三个捆绑的 MCP 服务器，全部在 npm 上发布：`hex-line-mcp`（哈希验证文件编辑 — 每一行都携带内容哈希，防止过时上下文损坏）、`hex-graph-mcp`（具有符号搜索、引用、架构分析和 SCIP 互操作的代码知识图）和 `hex-ssh-mcp`（通过 SSH 进行哈希验证的远程编辑和 SFTP）。技能可以在没有 MCP 服务器的情况下工作（回退到内置工具），但 MCP 可以提高编辑准确性并减少 token 使用。参见 [MCP 服务器](#mcp-servers-optional) 了解设置。

什么是哈希验证编辑，为什么它很重要？

`hex-line-mcp` 读取的每一行都携带内容哈希。当代理编辑时，它必须引用这些哈希 — 证明它看到的是当前文件内容，而不是会话早期获取的过时版本。这消除了一种常见的失败模式，即 AI 代理用过时的上下文覆盖最近的更改。钩子自动将 Claude 从内置工具引导到 `hex-line` 等价物，因此保护始终处于活动状态。

它如何在大型代码库中保持上下文？

通过协调器-工作线程模式加上持久化的运行时状态。不是将整个代码库馈送到一个提示中，协调器从协调器产物推进阶段，协调器消费工作线程产物，工作线程以最小化、针对性的上下文执行。每一层只加载它需要的文件，并且可以从检查点恢复，而不是重放长聊天历史。

它使用多少上下文/token？

技能设计为 token 高效。每个工作线程只通过针对性上下文加载它需要的文件 — 没有全代码库提示。协调器从机器可读的产物推进阶段，而不是重放聊天历史，工作线程从检查点恢复，而不是重新处理。参见 [TOKEN_EFFICIENCY_PATTERNS.md](docs/standards/TOKEN_EFFICIENCY_PATTERNS.md) 了解使用的模式。

我可以自定义或创建自己的技能吗？

可以。技能是 `plugins//skills//` 下的 `SKILL.md` 文件。单技能支持文件位于该技能的 `references/` 中；可重用的共享资源位于根 `shared/` 中，并通过 `tools/marketplace/shared-registry.json` 复制到精确的技能本地目标，使用 `node tools/marketplace/shared.mjs sync`。使用 `node tools/marketplace/validate.mjs` 验证。可重用功能应使用插件优先的技能结构。参见 [SKILL_ARCHITECTURE_GUIDE.md](docs/architecture/SKILL_ARCHITECTURE_GUIDE.md) 了解开发工作流、共享资源规则、4 级层次结构（L0 -> L1 -> L2 -> L3）和编写指南。

我可以将这些技能与 OpenAI Codex 一起使用吗？

可以。Claude 和 Codex 在此仓库中有独立的原生市场表面。通过各自的插件流程独立安装每个代理；不要同时将两个表面暴露给同一运行时。参见 [AI 审查模型 > 在代理之间共享技能和 MCP](#ai-review-models-optional) 了解配置路径。

## 内容概览

完整技能树

``` claude-code-skills/ # MARKETPLACE |-- plugins/ # INSTALLABLE PLUGINS + SELF-CONTAINED SKILLS |-- shared/ # CANONICAL MULTI-SKILL DEVELOPMENT SOURCES |-- tools/marketplace/shared-registry.json # shared -> skill-local references map | | | | ┌─ Plugin: agile-workflow ──────────────────────┐ | | | |-- ln-2XX-*/ # PLANNING | |-- ln-200-scope-decomposer/ # TOP: scope -> Epics -> Stories (one command) | |-- ln-201-opportunity-discoverer/ # Traffic-First KILL funnel for growth direction | |-- ln-210-epic-coordinator/ # CREATE/REPLAN 3-7 Epics | |-- ln-220-story-coordinator/ # CREATE/REPLAN Stories + standards research | | |-- ln-221-story-creator/ # Creates from IDEAL plan | | |-- ln-222-story-replanner/ # Replans when requirements change | |-- ln-230-story-prioritizer/ # RICE prioritization + market research | |-- ln-3XX-*/ # TASK MANAGEMENT | |-- ln-300-task-coordinator/ # Artifact-first task planning coordinator | | |-- ln-301-task-creator/ # Stateful task-plan worker (create) | | |-- ln-302-task-replanner/ # Stateful task-plan worker (replan) | |-- ln-310-multi-agent-validator/ # 20 criteria (8 groups), penalty points system + inline agent review | |-- ln-4XX-*/ # EXECUTION | |-- ln-400-story-executor/ # Artifact-first execution coordinator | |-- ln-401-task-executor/ # Stateful implementation worker | |-- ln-402-task-reviewer/ # Stateful review worker and final task outcome | |-- ln-403-task-rework/ # Stateful rework worker | |-- ln-404-test-executor/ # Stateful test execution worker | |-- ln-5XX-*/ # QUALITY | |-- ln-500-story-quality-gate/ # Thin orchestrator: verdict + Quality Score | |-- ln-510-quality-coordinator/ # Artifact-first quality coordinator | | |-- ln-511-code-quality-checker/ # Stateful quality worker | | |-- ln-512-tech-debt-cleaner/ # Stateful autofix worker | | |-- ln-513-regression-checker/ # Stateful regression worker | | |-- ln-514-test-log-analyzer/ # Stateful log-analysis worker | |-- ln-520-test-planner/ # Artifact-first test-planning coordinator | | |-- ln-521-test-researcher/ # Stateful research worker | | |-- ln-522-manual-tester/ # Stateful manual-testing worker | | |-- ln-523-auto-test-planner/ # Stateful automated test-planning worker | |-- ln-10XX-*/ # ORCHESTRATION | |-- ln-1000-pipeline-orchestrator/ # L0 Meta: coordinator artifacts drive the 4-stage pipeline | | └──────────────────────────────────────────────┘ | ┌─ Plugin: documentation-pipeline ──────────────┐ | |-- ln-1XX-*/ # DOCUMENTATION | |-- ln-100-documents-pipeline/ # L1 Orchestrator: complete docs in one command | |-- ln-110-project-docs-coordinator/ # Detects project type, delegates to workers | | |-- ln-111-root-docs-creator/ # AGENTS.md, CLAUDE.md, principles.md | | |-- ln-112-project-core-creator/ # requirements.md, architecture.md | | |-- ln-113-backend-docs-creator/ # api_spec.md, database_schema.md | | |-- ln-114-frontend-docs-creator/ # design_guidelines.md | | |-- ln-115-devops-docs-creator/ # infrastructure.md, runbook.md | |-- ln-120-reference-docs-creator/ # ADRs, guides, manuals structure | |-- ln-130-tasks-docs-creator/ # kanban_board.md, task provider setup | |-- ln-140-test-docs-creator/ # testing-strategy.md | |-- ln-160-docs-skill-extractor/ # Scan docs, classify, extract to .claude/commands | | |-- ln-161-skill-creator/ # Transform doc sections into commands | | |-- ln-162-skill-reviewer/ # Review SKILL.md and .claude/commands quality | | └──────────────────────────────────────────────┘ | ┌─ Plugin: codebase-audit-suite ────────────────┐ | |-- ln-6XX-*/ # AUDIT | |-- ln-610-docs-auditor/ # Documentation audit coordinator (4 workers) | | |-- ln-611-docs-structure-auditor/ # Hierarchy, SSOT, compression, freshness | | |-- ln-612-semantic-content-auditor/ # Scope alignment | | |-- ln-613-code-comments-auditor/ # WHY-not-WHAT, density, docstrings | | |-- ln-614-docs-fact-checker/ # Claims extraction, cross-doc verification | |-- ln-620-codebase-auditor/ # 9 parallel auditors: | | |-- ln-621-security-auditor/ # Secrets, SQL injection, XSS | | |-- ln-622-build-auditor/ # Compiler/type errors | | |-- ln-623-code-principles-auditor/# DRY/KISS/YAGNI, TODOs, DI | | |-- ln-624-code-quality-auditor/ # Complexity, magic numbers | | |-- ln-625-dependencies-auditor/ # Outdated packages + CVE vulnerabilities | | |-- ln-626-dead-code-auditor/ # Unused code | | |-- ln-627-observability-auditor/ # Logging, metrics | | |-- ln-628-concurrency-auditor/ # Race conditions | | |-- ln-629-lifecycle-auditor/ # Bootstrap, shutdown | |-- ln-630-test-auditor/ # 7 test auditors: | | |-- ln-631-test-business-logic-auditor/ # Framework vs business logic tests | | |-- ln-632-test-e2e-priority-auditor/ # E2E coverage for critical paths | | |-- ln-633-test-value-auditor/ # Risk-based test value scoring | | |-- ln-634-test-coverage-auditor/ # Missing tests for critical paths | | |-- ln-635-test-isolation-auditor/ # Isolation + anti-patterns | | |-- ln-636-manual-test-auditor/ # Manual test quality (harness, golden files, fail-fast) | | |-- ln-637-test-structure-auditor/ # Test file organization + directory layout | |-- ln-640-pattern-evolution-auditor/ # Architectural pattern analysis + 4-score model | | |-- ln-641-pattern-analyzer/ # Pattern scoring worker | | |-- ln-642-layer-boundary-auditor/# Layer violations, I/O isolation | | |-- ln-643-api-contract-auditor/ # Layer leakage, missing DTOs | | |-- ln-644-dependency-graph-auditor/ # Cycles, coupling metrics (Ca/Ce/I) | | |-- ln-645-open-source-replacer/ # Goal-based OSS replacement audit + migration plan | | |-- ln-646-project-structure-auditor/ # Physical structure audit with framework-specific rules | | |-- ln-647-env-config-auditor/ # Env var config, sync, naming, startup validation | |-- ln-650-persistence-performance-auditor/ # DB performance coordinator: | | |-- ln-651-query-efficiency-auditor/ # N+1, over-fetching, missing bulk ops | | |-- ln-652-transaction-correctness-auditor/ # Scope, rollback, long-held txns | | |-- ln-653-runtime-performance-auditor/ # Blocking IO, allocations, sync sleep | | |-- ln-654-resource-lifecycle-auditor/ # Session scope mismatch, pool config, cleanup | | └──────────────────────────────────────────────┘ | ┌─ Plugin: project-bootstrap ───────────────────┐ | |-- ln-7XX-*/ # BOOTSTRAP | |-- ln-700-project-bootstrap/ # L1: CREATE or TRANSFORM project | |-- ln-720-structure-migrator/ # SCAFFOLD or RESTRUCTURE to Clean Architecture | | |-- ln-721-frontend-restructure/ # React component-based architecture | | |-- ln-722-backend-generator/ # .NET Clean Architecture from entities | | |-- ln-723-seed-data-generator/ # Generate seed data from ORM schemas | | |-- ln-724-artifact-cleaner/ # Remove platform-specific artifacts | |-- ln-730-devops-setup/ # Docker, CI/CD, env | | |-- ln-731-docker-generator/ # Dockerfiles, docker-compose | | |-- ln-732-cicd-generator/ # GitHub Actions | | |-- ln-733-env-configurator/ # .env.example | |-- ln-740-quality-setup/ # Linters, pre-commit, tests | | |-- ln-741-linter-configurator/ # ESLint, Prettier, Ruff, mypy | | |-- ln-742-precommit-setup/ # Husky, lint-staged, commitlint | | |-- ln-743-test-infrastructure/ # Vitest, xUnit, pytest setup | |-- ln-760-security-setup/ # Security scanning | | |-- ln-761-secret-scanner/ # Detect hardcoded secrets | |-- ln-770-crosscutting-setup/ # Logging, CORS, health checks | | |-- ln-771-logging-configurator/ # Structured JSON logging | | |-- ln-772-error-handler-setup/ # Global exception middleware | | |-- ln-773-cors-configurator/ # CORS policy config | | |-- ln-774-healthcheck-setup/ # K8s readiness/liveness probes | | |-- ln-775-api-docs-generator/ # Swagger/OpenAPI docs | |-- ln-780-bootstrap-verifier/ # Build, test, Docker verification | | |-- ln-781-build-verifier/ # Verify compilation | | |-- ln-782-test-runner/ # Run test suites | | |-- ln-783-container-launcher/ # Docker health check | | └──────────────────────────────────────────────┘ | ┌─ Plugin: optimization-suite ──────────────────┐ | |-- ln-8XX-*/ # OPTIMIZATION | |-- ln-810-performance-optimizer/ # Performance optimization: | | |-- ln-811-performance-profiler/ # Full-stack request tracing, bottleneck classification | | |-- ln-812-optimization-researcher/ # Competitive benchmarks, solution research, hypotheses | | |-- ln-813-optimization-plan-validator/ # Agent-validated plan review (Claude/Codex) | | |-- ln-814-optimization-executor/ # Strike-first hypothesis execution (keep/discard) | |-- ln-820-dependency-optimization-coordinator/ # Dependency upgrades: | | |-- ln-821-npm-upgrader/ # npm/yarn/pnpm with breaking change handling | | |-- ln-822-nuget-upgrader/ # .NET NuGet with migration support | | |-- ln-823-pip-upgrader/ # pip/poetry/pipenv with security audit | |-- ln-830-code-modernization-coordinator/ # Code modernization: | | |-- ln-831-oss-replacer/ # Replace custom code with OSS packages | | |-- ln-832-bundle-optimizer/ # JS/TS bundle size reduction | |-- ln-840-benchmark-compare/ # Canonical internal A/B: built-in vs hex-line, plus optional third Claude-compatible profile | | └──────────────────────────────────────────────┘ | ┌─ Plugin: community-engagement ───────────────┐ | |-- ln-9XX-*/ # COMMUNITY ENGAGEMENT | |-- ln-910-community-engagement/ # L2: Analyze health, consult strategy, delegate | |-- ln-911-github-triager/ # Triage issues/PRs/discussions | |-- ln-912-community-announcer/ # Compose + publish GitHub Discussion announcements | |-- ln-913-community-debater/ # Launch RFC/debate/poll discussions | |-- ln-914-community-responder/ # Respond to unanswered discussions/issues | | └──────────────────────────────────────────────┘ | ┌─ Plugin: setup-environment ────────────────────┐ | |-- ln-001-push-all/ # Commit and push all changes in one command |-- ln-002-session-analyzer/ # Analyze sessions for optimization opportunities |-- ln-0XX-*/ # SETUP ENVIRONMENT | |-- ln-010-dev-environment-setup/ # L2: Full environment setup coordinator | |-- ln-011-agent-installer/ # Install/update Codex and Claude CLI | |-- ln-012-mcp-configurator/ # Claude-side MCP setup: registration, hooks, permissions, migrations | |-- ln-013-config-syncer/ # Align marketplace plugins, MCP state, and Codex defaults | |-- ln-014-agent-instructions-manager/ # Single owner of CLAUDE.md/AGENTS.md creation and audit | |-- ln-015-hex-line-uninstaller/ # Standalone cleanup for Claude-side hex-line integration |-- ln-020-codegraph/ # Code knowledge graph for dependency analysis & impact checking |-- ln-030-vps-bootstrap/ # L2: VPS agent coordinator and fleet plan/apply entrypoint | |-- ln-031-vps-host-runtime/ # Shared VPS host runtime: users, packages, CLIs, MCP, plugins | |-- ln-032-vps-project-runtime/ # Per-project VPS runtime, god-session, provider creds, dispatcher | |-- ln-033-hex-relay-lifecycle/ # hex-relay deploy, redeploy, migration, health, Telegram users | |-- ln-034-vps-environment-diagnostics/ # One environment health, drift, and bounded safe repair | | └──────────────────────────────────────────────┘ | | |-- agents/ | |-- hex-relay/ # Telegram/HTTP control plane deployed by ln-030 |-- docs/ | |-- architecture/ # Skill patterns & delegation runtime | |-- best-practice/ # Claude Code usage tips & component selection | |-- standards/ # Documentation & README standards |-- AGENTS.md # Canonical agent-facing repo map |-- CLAUDE.md # Derived Anthropic entrypoint ```

## 链接 | | | |---|---| | **文档** | [AGENTS.md](AGENTS.md) | | **架构** | [SKILL_ARCHITECTURE_GUIDE.md](docs/architecture/SKILL_ARCHITECTURE_GUIDE.md) | | **代理委托** | [AGENT_DELEGATION_PLATFORM_GUIDE.md](docs/architecture/AGENT_DELEGATION_PLATFORM_GUIDE.md) | | **组件选择** | [COMPONENT_SELECTION.md](docs/best-practice/COMPONENT_SELECTION.md) | | **工作流技巧** | [WORKFLOW_TIPS.md](docs/best-practice/WORKFLOW_TIPS.md) | | **讨论** | [GitHub Discussions](https://github.com/levnikolaevich/claude-code-skills/discussions) | | **问题** | [GitHub Issues](https://github.com/levnikolaevich/claude-code-skills/issues) | | **贡献** | [CONTRIBUTING.md](CONTRIBUTING.md) | | **浏览技能** | [skills.sh](https://skills.sh/LevNikolaevich/claude-code-skills) |

研究与影响

在技能架构中研究和实施论文、文档和方法论。 | 来源 | 学到 | 改变 | |--------|---------|--------| | [STAR Framework](https://arxiv.org/abs/2602.21814)（2025）| 强制目标阐述：+85pp 准确率；结构化推理 > 上下文注入 2.83 倍 | [`goal_articulation_gate.md`](shared/references/goal_articulation_gate.md) — 相关技能和模板的定性目标阐述门控 | | [Building Effective Agents](https://www.anthropic.com/research/building-effective-agents)（Anthropic，2024）| 协调器-工作线程、提示链接、评估器-优化器模式 | 核心 4 级层次结构（L0→L3），每个技能单一职责 | | [Multi-Agent Research System](https://www.anthropic.com/engineering/multi-agent-research-system)（Anthropic，2025）| 生产编排：专业化代理带来 90.2% 性能提升 | `ln-1000` 管道协调器、并行代理审查（`ln-310`、`ln-510`）| | [Scheduler Agent Supervisor](https://learn.microsoft.com/azure/architecture/patterns/scheduler-agent-supervisor)（Microsoft）| 调度、执行监督分离 | `ln-400`/`ln-402`/`ln-500` 执行器-审查器-门控分离 | | [DIATAXIS](https://diataxis.fr)| 4 类文档：教程/操作方法/参考/解释 | AGENTS.md/docs 中的文档级别，渐进式披露 | | [Sinks, Not Pipes](https://ianbull.com/posts/software-architecture)（Ian Bull，2026）| "架构即提示" — AI 代理无法推理超过 2 层深度的副作用链；sink（自包含）> pipe（级联）| [`ai_ready_architecture.md`](shared/references/ai_ready_architecture.md) — 级联深度、架构诚实度、相关技能中的平面编排检查 | | [Test Desiderata](https://testdesiderata.com/)（Kent Beck，2019）| 有价值测试的 12 个属性 — 行为性、预测性、具体性、启发性、确定性... 无数值目标，只有有用性 | [`risk_based_testing_guide.md`](shared/references/risk_based_testing_guide.md) — 6 个测试有用性标准（风险优先级 ≥15、信心 ROI、行为性、预测性、具体性、非重复）| | 垂直切片（[Humanizing Work](https://www.humanizingwork.com/the-humanizing-work-guide-to-splitting-user-stories/)）| "永远不要按架构层分割" | 基础优先的任务排序 | | [Claude Code Picks](https://amplifying.ai/research/claude-code-picks)（Amplifying AI，2026）| Claude 的工具偏好是习得的成熟度信号，而非偏见 — Drizzle/Vitest/Zustand 因客观质量而被选中。20 个类别中 12 个构建而非购买。"纠正"有效偏好 = 推荐更差的工具 | AGENTS.md 中的研究到行动门控 — 需要具体缺陷才能将研究转化为技能更改 | | [autoresearch](https://github.com/karpathy/autoresearch)（Karpathy，2025）| Autoresearch 循环：修改 → 基准测试 → 二元保留/丢弃；复合基线；简单性标准（边际收益 + 丑陋代码 = 丢弃）| [`ln-814-optimization-executor`](plugins/optimization-suite/skills/ln-814-optimization-executor/SKILL.md) — 带自适应阈值的保留/丢弃、多文件支持、复合基线、实验日志 | | [The Complete Guide to Building Skills](https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf)（Anthropic，2026）| WHAT+WHEN 描述、触发测试、能力 vs 偏好分类、负面触发、3 级渐进式披露 | 检查 #14（触发质量）、负面触发模式、`metadata.skill-type` 分类、功能性 DoD、M6 建议 |

## 许可证 [MIT](LICENSE) **作者：** [@levnikolaevich](https://github.com/levnikolaevich)

标签：Agile Workflow, AI Review, AI代码审查, Automation, Claude Code, Codebase Audit, Code Graph, Code Quality, Codex CLI, Community Workflow, Dev Workflow, Documentation, Environment Setup, Hash Verification, MCP, MITM代理, Model Context Protocol, Multi-model AI, Performance Optimization, Project Bootstrap, SDLC, Security Audit, SSH远程连接, 中间件漏洞, 哈希验证, 多人体追踪, 多模型AI, 开发工作流, 性能优化, 敏捷开发, 文档生成, 暗色界面, 检测绕过, 环境配置, 社区工作流, 自定义脚本, 软件开发生命周期, 逆向工具, 项目启动