Skills for Real Engineers

路由器：描述你的处境，它告诉该用哪个 Skill 或流程——本仓库的入口向导。

Ask which skill or flow fits your situation. A router over the skills in this repo.

招牌 Skill 的工程版：拷问式访谈打磨计划，同时顺手沉淀文档——更新 CONTEXT.md 术语表与 ADR 决策记录。

A relentless interview to sharpen a plan or design, which also creates docs (ADRs and glossary).

工单分诊状态机：分类 → 验证 → 打标签，推动 issue 和外部 PR 在分诊角色间流转。

Move issues and external PRs through a state machine of triage roles.

屎山救援：扫描代码库的“深模块”改造机会，生成可视化 HTML 报告，再针对你选中的方向展开拷问。作者建议每隔几天跑一次。

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

每个仓库运行一次的配置器：设定 issue 追踪器（GitHub/Linear/本地）、分诊标签词汇、文档存放位置——使用其他工程 Skill 的前提。

Configure this repo for the engineering skills — issue tracker, triage labels, docs layout.

把当前对话直接合成为规格文档并发布到 issue 追踪器——不做访谈，只提炼已经讨论过的内容；生成前会追问你涉及哪些模块。

Turn the current conversation into a spec and publish it to the project issue tracker.

把计划、规格或对话拆成一组“曳光弹”工单，每个工单声明自己的阻塞依赖边——写成文本或追踪器上的原生阻塞链接。

Break a plan, spec, or conversation into tracer-bullet tickets, each declaring its blocking edges.

按规格或工单集实现功能：在预先约定的接缝处驱动 /tdd，提交前以 /code-review 收尾。

Implement a piece of work based on a spec or set of tickets.

规划超过单个代理会话容量的大型工作：拆成 issue 追踪器上的“调查工单共享地图”，逐个解决直到通往目标的路径清晰。

Plan a huge chunk of work as a shared map of investigation tickets on the issue tracker.

用一次性原型回答设计问题：状态/逻辑问题做可运行的终端程序，UI 问题做多个可一键切换的迥异变体。

Build a throwaway prototype to answer a design question.

疑难 Bug 与性能回退的诊断循环：复现 → 最小化 → 假设 → 插桩 → 修复 → 回归测试。

Diagnosis loop for hard bugs and performance regressions.

针对高可信一手资料调查问题， findings 落成仓库内带引用的 Markdown 文件，以后台代理方式运行。

Investigate a question against high-trust primary sources, capture findings as a cited Markdown file.

测试驱动开发：红-绿-重构循环，一次实现一个垂直切片，内含好测试与坏测试的判别指导。

Test-driven development with a red-green-refactor loop.

主动构建和打磨项目领域模型：对照术语表挑战用词、用边界场景压测、就地更新 CONTEXT.md 与 ADR。

Build and sharpen a project's domain model — challenge terms, stress-test with edge cases.

“深模块”设计纪律与共享词汇：小接口背后承载大行为、落在干净的接缝上、可仅通过接口测试。

Shared discipline and vocabulary for designing deep modules.

双轴审查 diff：规范轴（仓库标准 + Fowler 坏味道基线）与规格轴（是否忠实实现原始 issue/PRD），由并行子代理执行互不污染。

Two-axis review: Standards and Spec, run as parallel sub-agents.

逐块解决进行中的 git merge/rebase 冲突，每个块追溯到冲突双方的原始意图来解决，绝不 --abort。

Work through a merge/rebase conflict hunk by hunk, resolving by intent — never --abort.

本仓库最出圈的 Skill：无情拷问你的计划或设计，直到决策树的每个分支都有答案。每次改动前都应该用。

A relentless interview to sharpen a plan or design.

grill-me 的模型自动触发版：当代理判断当前计划/决策/想法需要打磨时，自动开始拷问。

Grill the user relentlessly about a plan, decision, or idea — model-invoked.

把当前对话压缩成交接文档，让另一个代理（或下一个会话）无缝接手继续工作。

Compact the conversation into a handoff document for another agent to pick up.

跨多个会话教你一项新技能或概念，教学内容基于当前工作区的真实代码。

Teach the user a new skill or concept, within this workspace.

写好 Skill 的参考手册：让 Skill 真正生效的词汇与原则——写自己的 Skill 前必读。

Reference for writing and editing skills well.

配置 Claude Code hooks 拦截危险 git 命令（push、reset --hard、clean、branch -D 等），给代理装上护栏。

Set up Claude Code hooks to block dangerous git commands.

把测试文件中的 as 类型断言迁移到 @total-typescript/shoehorn（更安全的测试数据构造方式）。

Migrate test files from `as` type assertions to @total-typescript/shoehorn.

创建教学练习目录结构：章节、题目、答案、讲解四件套。

Create exercise directory structures with sections, problems, solutions, explainers.

配置 Husky pre-commit 钩子：lint-staged（Prettier）+ 类型检查 + 测试，提交前自动把关。

Set up Husky pre-commit hooks with lint-staged, type checking, tests.

编辑改进文章：重构章节结构、提升表达清晰度、收紧行文。

Edit and improve articles by restructuring sections and tightening prose.

在 Obsidian 笔记库中搜索、创建、管理笔记，维护 wikilinks 与索引笔记（绑定作者个人环境）。

Search, create, and manage notes in the Obsidian vault.

grill-me 的批处理版：一次性抛出所有前沿问题，逐轮拷问。

A relentless interview that asks every frontier question at once, round by round.

handoff 的后台版：把当前对话交给一个全新的后台代理，立即继续工作。

Hand the conversation off to a fresh background agent.

围绕你想构建的工作流进行规格拷问，帮你设计自动化流程。

Grill me about specs for the workflows I want to build.

把 dependency-cruiser 接入 TypeScript 仓库，用工具强制每个 package 保持深模块结构。

Wire dependency-cruiser into a TypeScript repo so each package is a deep module.

遇到一个你答不了的决策？把它变成一份问卷，交给能回答的人填写。

Turn a decision you can't fully answer into a questionnaire for someone else.

生成一个交互式 bash 向导，一步步引导真人完成手工操作流程。

Generate an interactive bash wizard that walks a human through a manual procedure.

写作·探索阶段：挖掘原始素材片段，暂不做结构化。

Writing, explore — mine raw fragments, no structure yet.

写作·组装阶段：把素材组织成“节拍”叙事线，每个术语先落地再推进。

Writing, exploit — assemble raw material into a journey of beats.

写作·成文阶段：把素材逐段塑形成完整文章。

Writing, exploit — shape raw material into an article, paragraph by paragraph.

（已废弃）用并行子代理为一个模块生成多个迥异的接口设计。

Generate multiple radically different interface designs via parallel sub-agents.

（已废弃）对话式 QA 会话：用户口头报告 bug，代理定位并修复。

Interactive QA session where user reports bugs conversationally.

（已废弃）通过访谈制定小步提交的重构计划，归档为 GitHub issue。

Create a detailed refactor plan with tiny commits via user interview.

（已废弃）从对话中提取 DDD 式统一语言术语表——能力已并入 grill-with-docs 与 domain-modeling。

Extract a DDD-style ubiquitous language glossary from the conversation.