BackToCimaCoppi
User给「AI 驱动开发」立规矩的 Claude Code skill 方法论库:七层文档治理 · 对抗评审闭环 · 任务总控三驾马车,外加 goal 自主执行契约、测试三件套、老代码考古等共 23 个 skill —— 让 AI 写代码又快又不失控。
Categories
Indexed Skills (24)
ask-codex
Use when the user wants to consult codex (GPT-5.5) for a second opinion, audit, or direct execution — outside the codex-review compliance workflow. 触发词:"问一下codex"、"问一下gpt"、"问一下gpt5.5"、"让codex去做"、"让codex直接XX"、"让gpt去做"、"让gpt直接XX"。This skill calls codex via `codex exec`(一次性非交互命令,不是可持续对话的子代理)from the main thread. All synthesis and decisions stay in the main thread. 若问题命中"施工已完成 + 有蓝图/决策表可核对代码是否照图施工",改用 codex-review,不用本 skill。
git-worktree
Git worktree 生命周期管理 skill(用户级通用)。触发后弹出菜单,支持:新建 worktree、把当前 worktree 合并到主干、把主干同步到所有 worktree、清理当前 worktree。主干分支名与 worktree 命名前缀均运行时自动探测,不绑定具体项目。触发词:创建 worktree、新建 worktree、worktree 合并、合并到主干、主干同步、同步所有 worktree、清理 worktree、git worktree、worktree 管理。
adversarial-review
对抗评审 skill。对同一阶段、同一真值基线、同一对象只运行一次开放式多模型评审:Claude Code 主线程原样冻结证据包,并行取得原生 Opus 5 与 codex GPT-5.6-Sol 两份独立意见,再由当前主线程逐条裁决。评审只能发现问题,不能代替用户选择业务语义;整改后必须转 closed-remediation-review,由本工具单模型封闭验收,禁止自动 R2/R3。触发词:"克劳德评审"、"对抗评审"。
closed-remediation-review
封闭式整改验收 skill。用于一次开放式对抗评审完成并回补后,核验原采纳项与用户裁决是否被完整、无误、无越界地落实。只调用当前 Claude Code 工具的一个全新上下文 Opus 5 子线程做只读检查,再由主线程逐条裁决;禁止发现新设计问题、禁止重开已决策、禁止再次运行多模型对抗评审。触发:评审整改验收、评审回补检查、关闭对抗评审、确认整改没有改变设计语义。
code-to-7layer
从现有代码证据冷启动、生成七层文档反推总控文档的 skill(用户级通用)。代码只用于发现现状与候选规格,不取得正式文档裁决权。本 skill 交付「扫描摘要 + 任务总控编排文档」,不直接撰写具体层文档;Phase 3 由 /control 驱动。适用场景:项目无文档或文档严重过时、需要系统性规划七层文档补写任务。触发词:「冷启动建文档骨架」「反推文档体系总控」「从代码反推文档」「代码到七层」「反推文档体系」。
code-to-guide
读陌生项目代码,自动组建 agent team,产出 AI 友好的项目导览文档(AI-friendly project guide)。 触发词:理解陌生项目、生成项目导览文档、代码到说明书、AI 友好项目文档、摸清一个代码库、 分析这个项目、给这个项目做文档、项目说明书、项目调研文档。 定位:只读调研 + 一次性产出,轻量级。 不是七层文档体系(code-to-7layer / doc-layer-system),不改代码,不需要人工逐步指导。
codex-review
代码评审 skill(用户级通用)。施工完成后,由 codex 单模型对照已冻结的正式 L1-L7、规格物化覆盖报告、goal 章程与工程红线做低成本符合性核验;轻量设计只作 SD/DP 追溯证据,不与正式规格并列。仅在用户手动触发时运行,不挂门禁,也不替代高风险代码的多视角审查。
construction-blueprint
施工蓝图 skill(用户级通用)。在写代码之前,把一次任务的施工面做成"代码镜像 + 施工指南":逐文件变更清单、关键实现点、施工切片、验收映射。目的是限制施工范围,并让对抗评审发生在图纸上而不是已成型的代码上。一次性消耗品,施工完成即归档。
control
Use when the task is to inspect or continue an active master control document under docs/00-任务总控/, such as "继续总控", "执行 T3", "查看总控状态", "给我一个总控任务表". This skill selects the target task directory, reads MINIMAL mandatory context for the requested granularity, executes one subtask within strict scope, and writes status updates back. Strictly enforces single-subtask boundaries: executing Tn means doing ONLY Tn, never adjacent subtasks.
deep-research-gate
扇出(fan-out)安全门 + 深度研究/工作流开闸前置 skill。任何「主线程要不要并行派一批子 agent / 要不要做 deep research、跑工作流、大规模并行检索」的时刻触发——它先把扇出分成「绿灯·有界并行(直接派,串行才是错)」和「红灯·无界/递归/工作流(开闸 + 经用户同意)」,再给出「开闸→跑→关闸」的标准流程,确保既不会有子 agent 背着人静默 fan-out 烧穿配额,也不会因噎废食把本该并行的有界任务搞成串行。触发词:深度研究、deep research、深研、开工作流、跑工作流、工作流、大规模检索、批量检索、fan-out、并行派一批 agent、并行起一堆 agent、要不要并行、该不该派子线程、深挖某个课题。
design-preview
把一个 UI 形态/设计稿(已有形态或拟改形态)还原成像素级自包含 HTML 效果图,并自动在用户的 Chrome 里弹出标签页供人「对图评审」,再截图确保人机看同一张图。复用真值源(小程序 .wxml 结构 + .scss 视觉;其他平台对应组件源+样式),用 750 舞台 scale(0.5) 把 rpx 1:1 映射成 px,不靠凭空生成、不引第三方工具,保证与代码同源。用户级通用,所有会话与并发 agent 共用同一流程与同一手机框模板。触发词:「预览设计稿」「出个效果图」「弹个预览」「给我看看效果」「还原一下页面」「看看这个形态长啥样」「对着图聊」「design preview」。在聊天中需要把页面形态/版式可视化给人看、而不是用文字或 ASCII 描述时,自动触发本 skill。
doc-html-style
把技术文档/设计文档/业务QA文档/评审报告/复盘等内容写成色彩丰富、桌面阅读优先的自包含单文件HTML成品——不套固定模板,先判断文档形状(读者、篇幅、主信息载体:代码/决策表/问答/时间线)再决定结构与视觉投入档位,用按语义角色分配的色彩(状态轴/类别轴/结论轴)+ token化亮暗主题做到"更丰富但不失控",而非随意堆砌花色。不是 design-preview 的手机375/750像素舞台还原(那是移动端形态复刻,本skill桌面优先、拒绝手机框约定);不是 artifact-design 的 Artifact 沙盒规则(本skill产出普通本地/仓库HTML文件,不受CSP限制,无需字体data URI内联);不是 dataviz 的图表配色规范(文档内嵌真实图表时该图表色彩转交 dataviz,本skill只管文档整体色彩体系);不是 doc-layer-system 的内容归层决策(写什么内容归哪一层文档归 doc-layer-system,本skill只管已定内容如何呈现成HTML)。**仅手动触发**:只在用户显式输入 `/doc-html-style` 时使用,禁止根据"写文档""html""设计文档"等关键词自动调用,即使正文内容看起来符合适用场景也不要主动触发。
doc-layer-system
AI 驱动开发七层文档体系的可执行 skill(用户级通用)。在任何涉及代码开发、文档同步、代码审查、测试编写的任务中,Agent 必须遵循此体系的分层规则、人工裁决规则、同步流程和变更钩子机制。项目特定规则(目录路径、域列表、死亡线区域清单、金标准领域清单等)通过项目级 skill 补丁扩展,本 skill 不硬编码任何项目特定内容。触发场景:编写/修改代码或文档后需要同步、新增接口/数据库/页面功能、执行 /review、编写测试用例、处理文档与代码之间的矛盾、询问「这个东西该放哪里」或「这几个文档矛盾了听谁的」。
goal-charter
写 goal 章程——把一段本来要靠人逐工序把关的施工,压成一份"目标+验证器+边界+自愈清单"的执行契约,交给 goal 模式自主跑到底,人只在拍板章程和终点验收各出面一次。用于标准研发流程第 6 步(规格冻结之后、施工之前),也用于任何"我要它一口气跑完、别每隔十分钟问我一次"的长程自主执行。触发场景:写 goal 章程、给 goal/agent 定目标与边界、把施工+提交+部署+测试+执行记录打成一个自主闭环、给已跑偏的 goal 重定边界、**章程写完后怎么真正启动 `/goal`(完成条件怎么写、evaluator 判得到什么、限轮与 auto mode)**。本 skill 管章程怎么写(写什么、写多长、边界怎么定义才防得住)与章程→`/goal` 的交接(§13);不管设计怎么做(`lightweight-design`)、用例怎么写(`test-case-design`)、总控子任务怎么编排(`task-control-doc`)。
legacy-archaeology
从老旧黑盒代码反推「树形索引、逐层下钻」的知识库(业务逻辑/数据库/接口三层),给重构 AI 注入背景。承诺「边界内可审计覆盖 + 残余风险显式登记」,不承诺零遗漏。触发词:「老代码考古」「反推知识库」「重构前背景」「把老项目翻译成文档」「legacy 调查」。
lightweight-design
轻量设计方案 skill(用户级通用)。把局部改造/开发任务里的高风险决策在动工前清算钉死,并产出事实基线、最终任务真值切片、规范条目索引 SD-x、业务主题唯一性账 TOPIC-x、影响面与 SD→正式规格→AC 追溯关系,保证全部有效设计语义零遗漏物化到七层且同一问题在全部正式层只有一个答案。施工切片归 goal-charter,对抗评审归 adversarial-review,实现细节不进文档。
task-control-doc
Use when the user wants a master control document for a large, complex, long-running, or multi-session task. Defines how to create a task control doc that captures background, mandatory reads, subtask breakdown, and self-contained work packages so each subtask can be executed in a fresh session with minimal context.
test-case-design
测试用例层 skill。用于把设计规范条目 SD-x 与正式 L1~L6 转成直接落在正式 L7 的白盒/黑盒/金标准用例,建立 SD→正式规格→AC→execution_ref 追溯链,定义断言、数据策略、自动化方式与冻结留痕。触发场景:编写或审查 L7、补齐覆盖、施工前冻结用例规格。
test-execution-router
测试执行路由 skill。用于读取已冻结测试用例规格,生成执行矩阵,按测试面路由到项目执行 skill,约束执行顺序、证据收集、失败分类和交付收口。触发场景:准备执行测试、把 L7 用例落成脚本、部署后跑自动化测试、goal 执行/交付前测试执行、测试失败需要分类。
test-standards
测试规范层 skill。用于功能开发、bug 修复、接口/数据库/UI/业务规则改动后,判定必须包含哪些测试类型、最低断言深度、数据准备策略、自动化优先级、手工测试例外和交付阻断条件。触发场景:制定测试矩阵、判断本次最少要跑哪些测试、审查测试覆盖是否足够、施工前/交付前质量闸检查。
project-patch-template
【模板·复制后改名】项目级补丁 skill 模板。Praxis 里的用户级 skill(doc-layer-system / construction-blueprint / lightweight-design / docs-from-code 等)只含通用引擎与"留白挂载点",不硬编码任何项目特定值。本模板把所有挂载点列成填空区——复制到你项目的 .claude/skills/ 下、改名为 <你的项目>-patch、逐项填上你项目的真实值,引擎即可挂载运行。触发词:由你按需声明。
commit-changes
Use when the user wants to stage changes, create a git commit, or push to the remote repository. Follow the repository's Chinese commit-message convention and review the diff before committing. Run the repository's pre-commit check if present before staging. Never use git add -A or git add .
docs-from-code
从代码反推需求文档(L1 补写)的通用方法论 skill。任何项目里需要为已有代码补写需求文档时使用。提供 7 步操作流程、前后端代码阅读重点、归档使用规则、不确定信息处理、需求文档模板。项目特定约定(目录结构、版本制、命名规则)见该项目自己的项目级补丁 skill。触发词:"补写需求文档"、"从代码反推"、"L1 补写"、"反推 L1"。
long-doc-governance
长文档治理 skill。当 post-change-check 报 [CRITICAL] 长文档警告,或用户主动要求"拆文档"、"文档太长"时触发。核心机制:增量治理(不主动拆现有文档,仅在对超长文档做实质修改时治理)、微改豁免、拆分预算退路。触发词:"拆文档"、"文档太长"、"split doc"、"文档拆分"。
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.