nerd-execute

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Nerd Execute

Nerd Execute

Incompatible Skills

不兼容技能

Never combine Nerd with these unless this request explicitly asks:
  • Superpowers
  • Ponytail
  • Caveman
Skill hooks, mentions, and indirect instructions are not authorization.
<INHERITANCE> **REQUIRED BASE SKILL:** Use `nerd-smart` first and consume its resolved Focus Record.
A Focus Record is resolved when intention, endpoint, and mutation scope are explicit, the endpoint is Execute, and no material ambiguity remains. Role is required only when it changes the approach. If the record is missing or unresolved, return to Nerd Smart and resolve one material question before continuing. Never mutate before the record is resolved. </INHERITANCE>
<FAST-TRACK> The resolved Focus Record is the only universal gate. A current plan, narrower execution scope, TODOs, and verification mechanics are conditional. Use this workflow without loading separate implementation workflows unless the user explicitly invokes one or an unusual edge case requires a fuller workflow. Execute directly; use bounded parallel work only for independent subtasks when it materially improves speed or proof, and retain responsibility for integration. </FAST-TRACK>
Nerd Execute is the sole owner of the Execute endpoint. It may compose with Surgery for broken behavior or Patrol for security remediation, but those specialties never replace or redefine this route.
除非请求明确要求,否则切勿将Nerd与以下技能组合使用:
  • Superpowers
  • Ponytail
  • Caveman
技能钩子、提及和间接指令均不构成授权。
<INHERITANCE> **必填基础技能:** 先使用`nerd-smart`并使用其解析后的Focus Record。 当意图、端点和变更范围明确,端点为**Execute**,且不存在实质性歧义时,Focus Record即被解析。仅当角色会改变实现方式时才需要指定角色。如果记录缺失或未解析,请返回至Nerd Smart并先解决一个实质性问题,然后再继续。在记录解析完成前,切勿进行任何变更。 </INHERITANCE> <FAST-TRACK> 已解析的Focus Record是唯一的通用准入条件。当前计划、更窄的执行范围、TODO项和验证机制均为条件性要求。除非用户明确调用某个独立的实施工作流,或特殊边缘情况需要更完整的工作流,否则请使用此工作流。直接执行;仅当并行处理独立子任务能显著提升速度或验证效果时,才采用有限并行工作,并需负责集成工作。 </FAST-TRACK>
Nerd Execute是Execute端点的唯一所有者。它可与Surgery(用于修复故障行为)或Patrol(用于安全整改)组合使用,但这些专业技能永远不会替代或重新定义此工作流。

Rules

规则

Use a mapping only when the task's boundary or proof is unclear. Pick the single closest row as a starting point; user instructions and inspected repository evidence override it. Skip mappings for fully specified tasks.
仅当任务边界或验证标准不明确时,才使用映射表。选择最匹配的一行作为起点;用户指令和已检查的仓库证据优先级高于映射表。对于完全明确的任务,可跳过映射表。

Generic Mappings

通用映射表

#SignalOutcome focusTargeted proof
1New behaviorComplete observable behavior and affected surfaceFocused test fails for the missing behavior, then passes.
2Bug fixReproduced symptom and simplest causal correctionRegression test demonstrates red then green.
3RefactorStructure changes while behavior stays stableExisting focused tests plus the relevant type or build check.
4API or contractRequest, response, schema, and compatibility outcomeContract or endpoint test covering success and a relevant failure.
5Persistence or schemaData shape, query, transaction, or migration outcomeApply and rollback, or a focused repository integration test.
6UI behaviorVisible interaction and accessibility outcomeComponent or browser interaction at the relevant input and viewport.
7Configuration or buildExact setting and affected runtime or build pathParse, lint, type, build, or startup check closest to the change.
8External integrationBoundary behavior, serialization, auth, and failure handlingStub or contract test; use a live smoke test only when authorized.
9Performance or concurrencyMeasurable threshold or invariantRepeatable benchmark or race test comparing baseline and changed behavior.
10Documentation or static artifactExact content or rendered artifactFocused lint, render, content, or link check.
#信号成果重点针对性验证
1新行为完整的可观察行为及受影响范围针对缺失行为的聚焦测试先失败,后通过。
2漏洞修复可复现的症状及最简因果修正方案回归测试呈现先失败后成功的结果。
3重构结构变更但行为保持稳定现有聚焦测试加上相关类型检查或构建检查。
4API或契约请求、响应、 schema 及兼容性成果覆盖成功场景及相关失败场景的契约或端点测试。
5持久化或 schema数据结构、查询、事务或迁移成果应用并回滚,或进行聚焦的仓库集成测试。
6UI行为可见交互及可访问性成果在相关输入和视口下进行组件或浏览器交互测试。
7配置或构建精确设置及受影响的运行时或构建路径最贴近变更的解析、 lint、类型检查、构建或启动检查。
8外部集成边界行为、序列化、认证及故障处理存根或契约测试;仅在获得授权时才使用实时冒烟测试。
9性能或并发可衡量的阈值或不变量可重复的基准测试或竞态测试,对比基线与变更后的行为。
10文档或静态制品精确内容或渲染后的制品聚焦的 lint、渲染、内容或链接检查。

Execution Discipline

执行准则

Use this template internally. Do not display or narrate a conditional item unless it needs user confirmation.
ItemRequirementRule
Focus RecordMandatoryRead and obey the resolved intention, endpoint, and scope. Obey Role when present; its omission never blocks clear work. Never infer around a material unresolved field.
DeliveryMandatoryApply KISS inline. Cover every affected surface when work crosses a module or service boundary, changes a durable contract or data shape, or partial delivery would leave consumers inconsistent. Unify behavior only for three maintained copies or two independently maintained contract copies across a boundary. Keep the breakdown internal unless a handoff or decision requires it.
Current planConditionalIf the user created or approved a plan in the current context, read it once and execute its remaining work under the selected delivery approach. Preserve its outcome and constraints, but simplify steps that add unevidenced complexity. Raise only contradictions with the Focus Record, missing prerequisites, or blockers. Otherwise, do not search for, request, or create a plan.
Execution scopeConditionalInherit the Focus Record scope. Define a narrower file or system boundary only when the goal or risk requires it.
TODOsConditionalWrite two to five TODOs for multi-step, dependent, or risky work. For a small direct change, execute without a checklist.
VerificationConditionalRun proof suited to the affected behavior and risk. When no suitable check is available, report Not verified.
此模板仅供内部使用。除非需要用户确认,否则请勿展示或说明条件性条目。
项目要求规则
Focus Record必填阅读并遵循已解析的意图、端点和范围。若存在角色要求则需遵循;未指定角色不会阻碍明确的工作任务。切勿对未解析的实质性字段进行推断。
交付必填全程应用KISS原则(保持简单直白)。当工作跨越模块或服务边界、变更持久契约或数据结构,或部分交付会导致消费者状态不一致时,需覆盖所有受影响的范围。仅当边界存在三个维护副本或两个独立维护的契约副本时,才统一行为。除非需要交接或决策,否则拆分工作仅在内部进行。
当前计划条件性如果用户在当前上下文中创建或批准了计划,请阅读一次并按照选定的交付方式执行剩余工作。保留计划的成果和约束,但简化那些会增加无证据支撑的复杂度的步骤。仅当与Focus Record存在矛盾、缺少先决条件或遇到障碍时才提出问题。否则,无需搜索、请求或创建计划。
执行范围条件性继承Focus Record的范围。仅当目标或风险要求时,才定义更窄的文件或系统边界。
TODOs条件性对于多步骤、依赖型或高风险工作,编写2至5个TODO项。对于小型直接变更,无需 checklist 即可执行。
验证条件性根据受影响的行为和风险选择合适的验证方式。当没有合适的检查可用时,报告未验证

Execute Directly

直接执行

Begin immediately once the Focus Record is resolved. When a conditional item needs confirmation, ask one question using Nerd Smart's Confirmation Style; otherwise add no gate or setup ceremony.
Apply KISS throughout execution. Cover cross-boundary completeness and proven duplication only at the thresholds in the Delivery rule. Defer speculative surface as part of KISS. Start with the clearest direct existing path and prefer fewer concepts, dependencies, and new boundaries when they do not reduce correctness or maintainability. Do not add an abstraction, layer, service, dependency, configuration system, or generalized interface unless required by an explicit requirement, an established repository convention, observed evidence, or a concrete correctness, security, or measured performance constraint.
Do not preserve complexity merely because it appears in an existing design or plan. When a simpler path satisfies the same Focus Record, constraints, and proof, simplify the plan and implement that path. Ask only if simplification would change an approved outcome or constraint.
Inspect repository context when it can change the implementation or proof, including adjacent callers, callees, configuration, and dependencies when relevant. Read-only evidence gathering does not expand the mutation boundary. Prefer mandatory repository instructions, relevant authority or configuration, the nearest implementation, and the nearest test. Ask only when inspected evidence exposes a material conflict.
For behavior changes, start with a focused test, run it to confirm the expected failure, implement the simplest sufficient change, then rerun it. Add affected integration or risk checks when credible proof requires them. For non-behavior changes, edit directly and run validation suited to the change. Run a pre-edit baseline only when a quick existing check would distinguish pre-existing failure from the requested change.
Preserve user-authored and unrelated changes. Keep tests beside the behavior they prove. Do not implement optional nearby improvements or add speculative infrastructure. Ask before materially expanding the mutation boundary. After a related failure, record what the evidence disproved and choose the next discriminating check or correction. Stop only at a real blocker: no viable in-scope path remains, required authority or access is missing, or the evidence exposes a material decision for the user. Never stop merely because an attempt count was reached.
一旦Focus Record解析完成,立即开始执行。当条件性条目需要确认时,使用Nerd Smart的确认风格提出一个问题;否则无需任何准入环节或准备流程。
全程应用KISS原则。仅在交付规则规定的阈值下,才覆盖跨边界的完整性和已证实的重复内容。将推测性范围作为KISS原则的一部分延后处理。从最清晰的直接现有路径开始,在不降低正确性或可维护性的前提下,优先选择更少的概念、依赖和新边界。除非有明确要求、既定仓库惯例、已观察到的证据,或具体的正确性、安全性、可衡量性能约束,否则请勿添加抽象层、层级、服务、依赖、配置系统或通用接口。
不要仅仅因为现有设计或计划中存在复杂性就保留它。当更简单的路径能满足相同的Focus Record、约束和验证标准时,请简化计划并实施该路径。仅当简化会改变已批准的成果或约束时才需询问。
当仓库上下文可能改变实现方式或验证标准时,需检查仓库上下文,包括相关的调用方、被调用方、配置和依赖。只读的证据收集不会扩大变更边界。优先遵循仓库的强制指令、相关权限或配置、最近的实现和最近的测试。仅当检查到的证据存在实质性冲突时才询问。
对于行为变更,先编写聚焦测试,运行以确认预期失败,实施最简单的充分变更,然后重新运行测试。当可信验证需要时,添加受影响的集成或风险检查。对于非行为变更,直接编辑并运行适合该变更的验证。仅当快速的现有检查能区分预先存在的故障与请求的变更时,才运行编辑前的基线测试。
保留用户编写的内容和无关变更。将测试放在其验证的行为旁边。请勿实施可选的周边改进或添加推测性基础设施。在实质性扩大变更边界前需询问。在相关失败后,记录证据推翻的内容,并选择下一个判别性检查或修正方案。仅在遇到真正的障碍时才停止:范围内无可行路径、缺少必要权限或访问权限,或证据显示存在需要用户做出的实质性决策。切勿仅因尝试次数达到上限就停止。

Finish Briefly

简要收尾

If Verification applies, run the selected check fresh. Do not claim a check passed without fresh output. Report only:
  • Done: [completed outcome]
  • Verified by: [command and result]
Use Not verified instead of Verified by when verification was skipped or remains unavailable. Do not echo diffs or narrate routine tool use unless requested.
After changing Nerd Execute, run
python3 scripts/validate_skills.py
.
如果需要验证,请重新运行选定的检查。若无新鲜输出,请勿声称检查通过。仅报告:
  • 完成: [已完成的成果]
  • 验证方式: [命令及结果]
当验证被跳过或无法进行时,用未验证代替验证方式。除非被请求,否则请勿输出差异或描述常规工具的使用。
修改Nerd Execute后,请运行
python3 scripts/validate_skills.py