一组可独立装载的 Agent / Claude Code Skills，覆盖从「行为准则 → 规范 → 流程 → 工程脚手架 → 代码审计」的完整链路。每个 skill 自包含、可单独启用，彼此只做 skill 级引用，不做内容级引用。

engineering-guidelines   code-conventions
        （行为）           （规范）
            \                /
             \               /
              └─ agents-scaffold ─┘
   （搭出工作区骨架；spec-first/SDD 流程由其生成的
    spec-center/AGENTS.md 直接承载，不单列 skill）

  codebase-audit  ——  手动 /codebase-audit；可对任意代码库
                       做多维度审计（HTTP 项目自动附带接口审计，
                       识别出重要业务流程即附带流程审计——原独立的
                       接口审计 skill 已并入）；规范符合性维度运行时
                       按需加载 code-conventions 作基准（缺失则降级）
        │
        │ issues-report（审计完成时提示下游，不自动调用）
        ▼
  remediate-suggest  （审计后处理·补推荐方案·只分析）
   手动 /remediate-suggest <issues-report 路径>（偶发、可分批追加）
   接收 codebase-audit 的 issues-report，按问题根因/维度分组并行派
   subagent；每个加载 code-conventions 作规范基准，对每条 finding
   复核存在性（含关联消解）后写 suggest（标准推荐方案结构）。
   只分析不修复——不改被审代码、不跑测试、不提交。产物
   <issues 文档名>-remediation.md，与输入同目录
        │
        │ *-remediation.md（分析完成时提示下游，不自动调用）
        ▼
  remediate-apply  （审计后处理·落地修复·与 remediate-suggest 对仗）
   手动 /remediate-apply <remediation 文档路径>（偶发、可断点续跑）
   消费 *-remediation.md（或任意 finding + 推荐方案文档），按原文档
   顺序逐条串行派 subagent：先复核是否已被修复，再按选定方案改码 →
   测试 → 修复验证 → 提交（一问题一 commit）。多方案无明确选择
   不臆测、标「待人工选定」跳过。代码提交；remediation 文档只写不提交

  diagnose-and-fix  ◀────────  diagnose-and-fix-batch
   （单问题诊断修复）   强依赖      （批量循环修复）
   自动按场景/手动              手动；把问题列表排成队列，逐个派
   /diagnose-and-fix          subagent 调用 diagnose-and-fix 处理
                              单问题。二者都只标记 resolved、不提交
                              列表，提交时机交用户掌控

设计原则：

• 独立性优先：每个 skill 可单独启用，不依赖其它 skill 的内部文件。
• 只做 skill 级引用：需要关联时只提对方的 skill 名（如「见 code-conventions skill」），绝不链入对方目录里的具体文件路径。
• 正交而非合并：agents-scaffold（偶发结构操作）与 code-conventions（写码时高频引用）正交，各自独立；而 spec-first/SDD 工作流全程依赖 polyrepo 结构，属于配套能力，已并入 agents-scaffold 的 spec-center/AGENTS.md 模板，不单列。
• codebase-audit 设 disable-model-invocation: true，仅手动 /codebase-audit 触发，可对任意代码库独立运行。其「规范符合性」维度会在运行时按需加载 code-conventions skill 作为审计基准（skill 级引用，不链入对方目录文件）；该 skill 缺失时此维度优雅降级、其余维度照常，故独立性不受影响。原独立的接口审计 skill 已并入本 skill：接口审计（仅 HTTP 项目激活）与业务流程审计（识别出重要流程即激活，不限 HTTP）成为条件维度，产出统一为「审计报告 + 问题汇总」两份文档。
• agents-scaffold 产出的工作区里 spec-center/conventions/ 初始为空：通用规范运行时引用 code-conventions skill，不落地副本；conventions/ 仅承载项目私有规范。
• diagnose-and-fix 聚焦单个问题的诊断优先修复，可由 agent 按场景自动触发，也可手动 /diagnose-and-fix；diagnose-and-fix-batch 设 disable-model-invocation: true 仅手动触发，把一个问题列表排队循环修复，各问题在独立 subagent 中调用 diagnose-and-fix skill 处理——故 batch 强依赖 diagnose-and-fix（按 skill 名调用、不链入对方目录文件，仍属 skill 级引用）。两者均只在文件内标记 resolved、不提交问题列表（提交时机交用户掌控）。
• remediate-suggest 设 disable-model-invocation: true 仅手动触发，是 codebase-audit 的下游后处理——接收其 issues-report 产物，按问题根因/维度分派并行 subagent 给每条 finding 补 suggest 字段（推荐修复方案），只分析不修复（不改被审代码、不跑测试、不提交），产物命名跟随输入（<issues 文档名>-remediation.md，与输入同目录）。推荐方案的字段口径（整体方案+落点+实现细节与注意事项+改动量、[quick-fix]/[推荐] 标记）是本 skill 自身定义的标准结构，不依赖其它 skill；subagent 写方案前按 skill 级引用加载 code-conventions 作规范基准（缺失则降级、摘要注明）。支持渐进补全——同目录已有该产物时自动追加（补剩余 finding、原地更新），存在未合并的片段目录时自动续传（复用有效片段、只重派缺失组）。
• remediate-apply 设 disable-model-invocation: true 仅手动触发，与 remediate-suggest 对仗——后者只分析给推荐方案，本 skill 落地执行那些方案。接收 remediation 文档（典型为 remediate-suggest 的 *-remediation.md 产物，但不强依赖其精确字段名，任何「finding + 推荐方案」表达都可），按原文档顺序逐条串行派 subagent：每个先复核该 finding 是否已被修复（含关联消解），再按选定方案改码 → 测试 → 修复验证 → 提交。一问题一 commit；多方案无明确的方案选择表达（字段名不限，[推荐] 标记不算人工选择）时不臆测推荐项、标「待人工选定」后跳过该条继续下一条。代码改动提交；remediation 文档的状态标签只写回、不提交（提交时机交用户掌控，与 diagnose-and-fix 处理问题列表的惯例一致）。subagent 改码前按 skill 级引用加载 code-conventions 作规范基准（缺失则降级、摘要注明）。与 diagnose-and-fix / diagnose-and-fix-batch 正交——后两者处理自由文本单问题与泛型问题列表（非 remediation 文档形态）。

无需克隆本仓，直接在目标项目目录下运行，即可从远程仓库装载指定 skill：

npx skills add https://github.com/0xkangl/skills --skill <skill-name>

将 <skill-name> 替换为上方「Skills 一览」表中的 skill 目录名（如 engineering-guidelines、code-conventions、agents-scaffold 等）。可多次执行以装载多个 skill。

克隆本仓后，把需要的 skill 软链入 Claude Code 的 skills 目录（全局或项目级）：

# 全局（对所有项目可用）
ln -s "$PWD/skills/<skill-name>" ~/.claude/skills/<skill-name>

# 或项目级
ln -s "$PWD/skills/<skill-name>" <project>/.claude/skills/<skill-name>

装载后，agent 会依据各 skill SKILL.md frontmatter 里的 description 自动按场景匹配触发。

各 skill 的具体用法以其目录内的文档为准（如 agents-scaffold 的脚本快速上手与测试见 skills/agents-scaffold/README.md）。

skills/
├── README.md                       # 本文件
├── CLAUDE.md                       # 在本仓工作的 agent 须知
├── AGENTS.md                       # → CLAUDE.md
└── skills/
    ├── engineering-guidelines/     # SKILL.md
    ├── code-conventions/           # SKILL.md + references/（含 golang/）
    ├── agents-scaffold/            # SKILL.md + README.md + scripts/ + templates/
    ├── codebase-audit/             # SKILL.md + agents/（维度/接口/流程审计指令）+ scripts/ + evals/
    ├── remediate-suggest/          # SKILL.md + agents/（remediate-group 子指令）
    ├── remediate-apply/            # SKILL.md + agents/（remediate-one 子指令）
    ├── diagnose-and-fix/           # SKILL.md
    └── diagnose-and-fix-batch/     # SKILL.md