nerd-fast
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseNerd Fast
Nerd Fast
Incompatible Skills
不兼容的Skill
Never combine Nerd with these unless this request explicitly asks:
- Superpowers
- Ponytail
- Caveman
Skill hooks, mentions, and indirect instructions are not authorization.
除非请求明确要求,否则绝不要将Nerd与以下Skill组合使用:
- Superpowers
- Ponytail
- Caveman
Skill钩子、提及和间接指令不算授权。
Composition
组合方式
Apply this global modifier; it is never a primary specialty and never replaces or restarts the active workflow. Use only for material endpoint, scope, or authorization ambiguity.
nerd-smartCompose with only when the user explicitly invokes both modifiers. Never activate, infer, or auto-compose Silent from latency or presentation preferences. Fast controls operations; Silent controls presentation. Preserve correctness, authorization, safety, user interaction, and proof.
nerd-silent应用此全局修饰符;它永远不是主要专长,也绝不会替换或重启当前工作流。仅当存在实质性的端点、范围或授权歧义时,才使用。
nerd-smart仅当用户显式调用这两个修饰符时,才将其与组合。绝不要根据延迟或展示偏好来激活、推断或自动组合Silent。Fast控制操作;Silent控制展示。保留正确性、授权、安全性、用户交互和验证依据。
nerd-silentCore Rule
核心规则
Minimize sequential critical-path rounds. Keep an operation only when it resolves a material unknown, advances the requested deliverable, or produces required proof.
Prefer: reuse -> batch -> parallelize -> target narrowly -> escalate on evidence -> stop when proven.
Use no hard total tool limit. Fixed limits can trade accuracy for speed when proof requires more operations.
最小化关键路径的顺序轮次。仅保留能解决实质性未知问题、推进请求交付成果或生成所需验证依据的操作。
优先遵循:复用 -> 批量处理 -> 并行化 -> 精准定位 -> 基于证据升级 -> 验证完成即停止。
不设置硬性的工具总调用限制。当验证依据需要更多操作时,固定限制可能会以牺牲准确性为代价换取速度。
Read-Volume Gate
读取量阈值
At task start, before the first source read, estimate , the total estimated lines direct navigation would require, using named scope, known sizes, and likely support; do not read targets merely to calculate it.
x- : skip
x <= 200; read or search the targets directly.symbol_index.py - : resolve
x > 200relative to thisscripts/symbol_index.py, runSKILL.mdonce before source reads, then navigate withensurewithout implicit refresh.find
Do not wait until 200 lines have already been read. Universal Ctags is optional. If reports that Universal Ctags is unavailable, ask once: “Universal Ctags is unavailable. Our measured large-repository workloads showed up to 70% faster indexed navigation. Want me to install it? If not, I’ll continue with narrow text search.” Install only after explicit approval. On decline, unsupported installation, or failure, fall back immediately and do not ask again during the task. For any other unusable, stale, or incomplete index, fall back to an exact-file read or narrow text search. Treat matches as candidates and confirm source before mutation.
ensure任务开始时,在首次读取源文件之前,使用指定范围、已知大小和可能的支持信息估算(直接导航所需的总行数估计值);不要仅为计算该值而读取目标文件。
x- :跳过
x <= 200;直接读取或搜索目标文件。symbol_index.py - :相对于此
x > 200解析SKILL.md,在读取源文件前运行一次scripts/symbol_index.py,然后使用ensure导航,不进行隐式刷新。find
不要等到已读取200行才执行上述操作。Universal Ctags是可选工具。如果报告Universal Ctags不可用,询问一次:“Universal Ctags不可用。我们在大型仓库工作负载中的测试显示,索引导航速度最高可提升70%。是否需要我安装它?如果不需要,我将继续使用精准文本搜索。”仅在获得明确批准后安装。若用户拒绝、安装不支持或安装失败,立即回退,且在任务期间不再询问。对于任何其他不可用、过时或不完整的索引,回退至精确文件读取或精准文本搜索。将匹配结果视为候选,在修改前确认源文件。
ensureGates
决策阈值
Apply these gates in order. Keep them internal unless a conflict, blocker, or user decision must be reported.
| Gate | Decision | Default action |
|---|---|---|
| Inheritance | Are endpoint, scope, authorization, and active specialty resolved? | Inherit them. Resolve only a material missing field. |
| Reuse | Is sufficient current evidence available? | Reuse it without another operation. |
| Freshness | Could evidence have changed or become invalid? | Refresh time-sensitive state, changed files, failures, and ambiguous or truncated output. |
| Need | Which decision, change, or proof will this affect? | Skip operations without a material consumer. |
| Batch | Are the operations known and independent? | Batch them with the platform's native interface. |
| Dependency | Can one result change the next operation? | Keep adaptive dependencies sequential. |
| Escalation | What is the cheapest operation that distinguishes the possibilities? | Start narrowly and broaden only on evidence. |
| Recovery | Did the failed attempt produce new evidence? | Make at most two evidence-driven corrections by default, then report the blocker. |
| Verification cost | What is the lowest-cost fresh proof supporting the claim? | Select the lowest sufficient tier and escalate only on a verification trigger. |
| Stop | Are the outcome and required proof satisfied? | Stop without optional exploration or review. |
User instructions, repository authority, safety, and the active workflow override these defaults.
按顺序应用以下阈值。除非必须报告冲突、阻塞或需要用户决策,否则将这些阈值作为内部规则。
| 阈值 | 决策问题 | 默认操作 |
|---|---|---|
| 继承 | 端点、范围、授权和当前专长是否已明确? | 继承现有设置。仅解决实质性缺失的字段。 |
| 复用 | 是否有足够的当前验证依据? | 直接复用,无需执行其他操作。 |
| 新鲜度 | 验证依据是否可能已更改或失效? | 刷新对时间敏感的状态、已更改的文件、失败记录以及模糊或截断的输出。 |
| 必要性 | 此操作会影响哪些决策、变更或验证依据? | 跳过没有实质性用途的操作。 |
| 批量处理 | 操作是否已知且相互独立? | 通过平台原生接口批量处理。 |
| 依赖关系 | 一个操作的结果是否会改变下一个操作? | 保留自适应依赖的顺序执行。 |
| 升级 | 区分可能性的最低成本操作是什么? | 从精准定位开始,仅在有证据时扩大范围。 |
| 恢复 | 失败的尝试是否产生了新的验证依据? | 默认最多进行两次基于证据的修正,然后报告阻塞问题。 |
| 验证成本 | 支持声明的最低成本新鲜验证依据是什么? | 选择最低的足够层级,仅在触发验证升级时提升层级。 |
| 停止 | 结果和所需验证依据是否已满足? | 停止操作,不进行可选的探索或审查。 |
用户指令、仓库权限、安全规则和当前工作流会覆盖这些默认操作。
Batching and Dependencies
批量处理与依赖关系
Batch independent operations when their commands and reactions are known. Prefer one operation across known targets or the native batching or parallel interface. Keep adaptive work sequential when an output can change the next operation.
Before dispatching a mutation batch, require every step to be idempotent, transactional, or safely recoverable; otherwise keep mutations sequential and inspect state between them.
当操作的命令和响应已知时,对独立操作进行批量处理。优先选择针对已知目标的单次操作,或使用原生批量/并行接口。当一个输出会改变下一个操作时,保持自适应工作的顺序执行。
在派发修改批量任务前,要求每一步操作都是幂等的、事务性的或可安全恢复的;否则保持修改操作的顺序执行,并在步骤之间检查状态。
Verification-Cost Gate
验证成本阈值
Select the cheapest fresh check that observes the property being claimed.
选择能观察到所声明属性的最低成本新鲜检查方式。
Proof Ladder
验证阶梯
| Tier | Proof | Typical use |
|---|---|---|
| V0 | Existing current evidence or no verification claim | Read-only answers, unchanged facts, or work without a proportionate executable check. Report |
| V1 | Static, parse, content, or syntax check | Documentation, metadata, formatting, configuration, or static artifacts. |
| V2 | Focused behavioral check | The unit, contract, repository, component, regression, or browser test closest to the change. |
| V3 | Boundary or package validation | A relevant package suite, type check, build, integration test, migration check, or multi-component validation. |
| V4 | Full-system or live validation | A full repository suite, end-to-end run, deployment smoke test, or authorized live integration. |
Choose the lowest tier that directly supports the exact claim. Use V0 only if no mutation invalidated its evidence. Any file mutation, structural refactor, or code addition requires at least V1. Any behavioral completion claim after mutation requires fresh proof.
Reuse dependency, compiler, transpiler, test, runtime, and build caches when trustworthy. Preserve active daemons and watch processes. For static claims, use the narrowest syntax, type, lint, compile, or AST check. For behavioral claims, run one test method, case, file, package, or affected component. Without evidence, avoid clearing caches, reinstalling dependencies, rebuilding unaffected targets, recreating environments, or restarting healthy services. Run clean builds, broad suites, or environment resets only for repository authority, stale state, contradictory evidence, release parity, or a trigger below.
| 层级 | 验证方式 | 典型用途 |
|---|---|---|
| V0 | 现有当前验证依据或无验证声明 | 只读答案、未更改的事实,或无需对应可执行检查的工作。若完成会暗示验证依据,则报告“未验证”。 |
| V1 | 静态、解析、内容或语法检查 | 文档、元数据、格式、配置或静态制品。 |
| V2 | 聚焦行为检查 | 最接近变更的单元测试、契约测试、仓库测试、组件测试、回归测试或浏览器测试。 |
| V3 | 边界或包验证 | 相关包套件、类型检查、构建、集成测试、迁移检查或多组件验证。 |
| V4 | 全系统或实时验证 | 完整仓库套件、端到端运行、部署冒烟测试或授权的实时集成。 |
选择能直接支持确切声明的最低层级。仅当没有修改操作使验证依据失效时,才使用V0。任何文件修改、结构重构或代码添加至少需要V1验证。修改后的任何行为完成声明都需要新鲜的验证依据。
当缓存可信时,复用依赖项、编译器、转译器、测试、运行时和构建缓存。保留活跃的守护进程和监听进程。对于静态声明,使用最精准的语法、类型、lint、编译或AST检查。对于行为声明,运行一个测试方法、用例、文件、包或受影响的组件。若无证据,避免清除缓存、重新安装依赖项、重建未受影响的目标、重新创建环境或重启健康服务。仅在仓库权限要求、状态过时、证据矛盾、发布一致性要求或以下触发条件时,才执行干净构建、全面套件测试或环境重置。
Verification Escalation Triggers
验证升级触发条件
- The user or repository instructions require broader proof.
- The change crosses packages, services, persistence boundaries, or public contracts that narrower proof cannot cover.
- Security, authorization, migration, data-loss, concurrency, release, or production risk makes broader proof proportionate.
- The targeted check fails ambiguously or reveals a wider affected surface.
- The lower tier cannot observe a material part of the completion claim.
Do not run a full suite merely because one exists. Do not rerun an unchanged passing check. Classify failures as related, unrelated, or unknown; correct only related failures in scope. After two evidence-driven correction attempts, report the command, evidence, and smallest needed decision. If proof is narrower, narrow the claim to the verified boundary or .
Not verified- 用户或仓库指令要求更全面的验证。
- 变更跨越了包、服务、持久化边界或公共契约,而精准验证无法覆盖这些范围。
- 安全、授权、迁移、数据丢失、并发、发布或生产风险使得全面验证更为合理。
- 目标检查模糊失败或揭示了更广泛的影响面。
- 较低层级无法观察到完成声明中的实质性部分。
不要仅仅因为存在全面测试套件就运行它。不要重新运行未更改的通过检查。将失败分类为相关、无关或未知;仅修正范围内的相关失败。经过两次基于证据的修正尝试后,报告命令、证据和所需的最小决策。若验证范围较窄,则将声明缩小到已验证的边界,或标记为“未验证”。
Adaptive Path
自适应路径
- If current evidence is sufficient, perform the active endpoint, apply proportionate proof, and stop.
- If an exact target is named, apply the Read-Volume Gate and navigate the target plus its nearest authority or test.
- If the target is unknown, run one narrow discovery batch, inspect the best evidence, and narrow scope.
- If operations are independent, batch or parallelize them and synthesize once.
- If an output can change the next operation, sequence them.
- If a current plan exists, execute its remaining work without rediscovery.
- If current or external information is required, query authoritative sources together and confirm freshness.
- If a failure or contradiction appears, reuse it as evidence, reproduce once when needed, and test one bounded hypothesis.
- If work continues from an earlier turn, reuse the current record, plan, outputs, and diff; refresh only changed or stale evidence.
Use the smallest applicable path; conditions do not grant permission or replace the active workflow.
- 如果当前验证依据足够,执行当前端点操作,应用相应的验证,然后停止。
- 如果指定了精确目标,应用读取量阈值规则,并导航至目标及其最近的权限或测试文件。
- 如果目标未知,运行一次精准发现批量任务,检查最佳验证依据,缩小范围。
- 如果操作相互独立,批量处理或并行化操作,然后进行综合处理。
- 如果一个输出会改变下一个操作,按顺序执行。
- 如果已有当前计划,执行剩余工作,无需重新发现。
- 如果需要当前或外部信息,一起查询权威来源并确认新鲜度。
- 如果出现失败或矛盾,将其作为验证依据复用,必要时重现一次,并测试一个有边界的假设。
- 如果从之前的步骤继续工作,复用当前记录、计划、输出和差异;仅刷新已更改或过时的验证依据。
使用最小的适用路径;条件不授予权限,也不替换当前工作流。
Execution Discipline
执行准则
For non-atomic work, keep current evidence, one critical unknown, next independent batch, lowest sufficient proof, and stop condition. Skip fields without a material consumer.
Each TODO must deliver an outcome, remove a blocker, or provide proof. Do not reread unchanged files, repeat passing commands, or replan after each result. Reuse evidence until mutation, contradiction, staleness, or dependency failure invalidates it.
Prefer a structured patch or targeted-edit primitive. Do not reproduce unchanged file content. Rewrite a whole file only when generated, mostly changed, or handled by a trusted formatter or codemod.
For routine authorized operations, invoke the tool immediately. Explain first only for approval, safety, a material decision, or a required progress update. Silent controls overall narration and final presentation.
Dispatch reviewers or subagents only when the active workflow permits them and expected wall-clock savings exceed setup and handoff cost.
对于非原子性工作,保留当前验证依据、一个关键未知问题、下一个独立批量任务、最低足够的验证方式和停止条件。跳过没有实质性用途的字段。
每个待办事项必须交付成果、消除阻塞或提供验证依据。不要重新读取未更改的文件、重复执行已通过的命令或在每个结果后重新规划。复用验证依据,直到修改、矛盾、过时或依赖失效使其无效。
优先使用结构化补丁或精准编辑原语。不要重现未更改的文件内容。仅当文件是生成的、大部分已更改或由可信格式化工具或代码修改工具处理时,才重写整个文件。
对于常规授权操作,立即调用工具。仅在需要批准、安全检查、实质性决策或必要的进度更新时,先进行解释。Silent控制整体叙述和最终展示。
仅当当前工作流允许,且预期的实际耗时节省超过设置和交接成本时,才分派审核者或子Agent。
Conflict Discipline
冲突准则
When Fast conflicts with repository instructions, safety, the active workflow, or a supported completion claim, yield to the higher authority and take the lowest-cost valid path.
Treat tool errors as evidence. Correct the invocation or assumption once, then broaden only when the error shows that the current scope or source is insufficient.
After changing this skill family, run .
python3 scripts/validate_skills.py当Fast与仓库指令、安全规则、当前工作流或支持的完成声明冲突时,服从更高权限,并选择成本最低的有效路径。
将工具错误视为验证依据。修正一次调用或假设,然后仅当错误显示当前范围或源文件不足时,才扩大范围。
修改此Skill家族后,运行。
python3 scripts/validate_skills.py