Community编程与开发github.com

tderoussel/codebase-audit

对产品、代码库或子系统进行基于排名和证据的审计,并以验证清单结尾,区分已证实发现与推断发现。

codebase-audit 是什么?

该技能用于对产品、代码库或子系统进行结构化、基于排名和证据的审计。它强调审计的价值在于排名和证据,而非长度。技能要求审计师将发现与具体文件路径、查询结果、PR编号或行数关联起来,未关联的只能标记为假设。审计从项目文档开始,但必须通过实际代码、数据库状态和PR检查进行验证。审计输出遵循标准模板,包括TL;DR、盲点、缺失能力、需改进的能力、架构变更、未来30天计划和验证清单。最后,审计以验证清单结尾,列出无法解决的不一致之处及其解决方式。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tderoussel/agent-skills/tree/main/skills/codebase-audit

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

代码库审计

审计的价值在于排名和证据,而非长度。没有文件路径、查询结果、PR编号或行数的发现是假设——将其标记为假设。

将审计立足于代码和生产,而非文档

项目笔记、计划和状态文档是检查点,而非权威。从它们入手来了解声称的内容,然后对照现实进行验证:当前提交、数据库状态、PR检查、分支头部。

当文档与代码不一致时,这种不一致本身就是一条发现——通常是审计中最有价值的一条。

关于生产的声明需要进行针对生产的查询。将此技能与验证门技能结合以完成具体操作。

结构

# <范围> 审计 (YYYY-MM-DD)

## 概要
<最重要的三件事,以及你会首先做什么。>

## 第一部分——你没看到的东西(盲点,按排名)
## 第二部分——缺失的能力(按排名,每个附有粗略的工作量估算)
## 第三部分——需要改进的现有能力(按排名)
## 第四部分——架构变更(按排名,用通俗语言描述)
## 第五部分——如果我来掌控接下来的30天
## 验证清单(审计过程中发现的差异)

**对所有内容进行排名。**一个未排名的40条发现列表就是40条无法行动的发现。

在估算前检查是否存在休眠脚手架

为每个缺口附上粗略的工作量估算,并说明使其低成本或高成本的原因。

最有价值的审计发现通常是这个:**大多数高价值的“缺口”只需要几天的工作量,而非数周,因为脚手架已存在于仓库中,只是没有调用者。**一个已完成了80%的功能与一个完全没有开发的功能,决策完全不同。

在声明某物缺失之前,先 grep 查找。零调用者的函数是典型情况——代码存在,但没有任何调用,而所有状态文档都描述该功能为缺失。

验证清单

每次审计都以无法解决的差异结尾。每个条目包括:

  • 声称的内容
  • 观察到的内容
  • 哪种查询或检查可以解决它

**这是后续会话真正会使用的部分。**即使内容很短,也请务必写出。

明确表示不值得做的部分

说明你检查过并有意拒绝的内容,附上原因。

只会在待办清单上增加内容的审计会让待办清单变得无用。一个你查看过并驳回的发现比一个你从未提及的发现更有价值,因为它能阻止下一次审计再次提出相同问题。

保留项不是缺口

任何已明确标记为有意推迟、或等候人为决策的内容,都是有目的地保留的。不要将其列为缺口。

将一个有意保留项作为发现重新提出,会导致保留的决策被意外执行。

输出

将审计结果写在项目保存审计的地方。如果它取代了之前的审计,需说明哪个审计被取代以及什么发生了变化——审计文件夹应保持按顺序可读,而非堆积。

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

tderoussel/competitive-teardown

Researches a competing product against your own and produces a ranked build-or-ignore verdict, plus optional comparison-page copy. Use when the user names a competitor or asks how their product stacks up against one. Trigger phrases include "vs us", "competitor", "what does X have", "should we copy", "competitive gap", "teardown", "are we behind". Produces a ranked verdict with effort estimates and an explicit not-worth-copying list.

tderoussel/decision-council

Run a structured multi-perspective review of a decision instead of getting one agreeable answer. Use when the user says run a council, get me perspectives on this, should I do X, stress-test this decision, or is this a good idea.

tderoussel/fleet-brief

Authors a workstream brief for dispatching multiple parallel build agents across one codebase, with per-lane file ownership, shared-ground warnings, and a derived DO-NOT list. Use whenever work is about to be split across concurrent agents, workers, lanes, or waves — even if the user does not say "write a brief". Trigger phrases include "fan out", "parallel agents", "orchestrate this", "split into lanes", "workstreams", "run these in parallel", "review-gated build". Produces the brief; does not dispatch.

tderoussel/inbox-triage

Triage an email inbox — sort what needs a reply, draft the replies, flag what needs a decision, and surface what can be ignored or unsubscribed. Use when the user says triage my inbox, do my email, what's in my inbox, or clean up my email.

tderoussel/overnight-build

Composes an autonomous unattended Claude Code build prompt that survives usage-limit resets via BUILD_LOG.md checkpointing, plus the launcher that restarts it. Use when the user asks for an overnight build, an autonomous build, a build to run while they sleep, an unattended or unsupervised session, or any long build they will not be monitoring. Trigger phrases include "overnight build", "run overnight", "build while I sleep", "autonomous build", "let it run", "unattended". Produces a single copyable prompt; does not run the build.

tderoussel/session-log

Write a durable record of a work session — what was built, root-caused, or shipped — into the project's notes. Use when the user says log this session, write a session log, record this, or when a substantial piece of work has just finished and needs to be handed off to a future session.

tderoussel/ship-gate

Verification gate for a Next.js-on-Vercel + Supabase + GitHub Actions stack, to run before claiming anything is shipped, deployed, live, merged, passing, or done. Use before saying a change is in production, before merging a PR, before reporting CI green, and before writing any status into a document — even if the user does not ask for verification. Trigger phrases include "is it live", "did it deploy", "ship it", "merge it", "is CI green", "confirm prod", "did that work". Encodes traps where the obvious check returns a false pass.

tderoussel/vault-doctor

Audits and repairs an Obsidian vault's structural health — broken [[wikilinks]], ambiguous duplicate filenames, missing or malformed frontmatter, stale status markers, and hub notes whose state sections have gone cold. Use when the user asks about vault health, broken links, vault cleanup, dead links, orphan notes, tag consistency, or says the vault feels messy or out of date. Trigger phrases include "vault health", "broken links", "clean up the vault", "audit the vault", "is the vault current". Read-only by default; every repair is proposed before it is made.

相关技能