evolutionary-naming
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseEvolutionary Naming
渐进式命名
Overview
概述
Naming is a process, not a single step. Names evolve through 7 progressive steps grouped into 3 phases. Match the depth of work to the user's actual story — don't run the full pipeline every time.
Based on Arlo Belshee's "Naming as a Process" (CC BY 3.0). Updated edition: digdeeproots.com.
命名是一个过程，而非单一步骤。 命名会通过7个递进步骤演进，分为3个阶段。根据用户实际需求调整工作深度——无需每次都执行完整流程。
基于Arlo Belshee的《命名即过程》（CC BY 3.0）。更新版本：digdeeproots.com。
The Three Phases
三个阶段
| Phase | Steps | Nature |
|---|---|---|
| Phase 1: Insight → Name | Missing → Nonsense → Honest → Honest and Complete | Universal. Pure naming. No structural change. Safe to walk continuously. |
| Phase 2: Name → Structure | Honest and Complete → Does the Right Thing | Codebase-specific. Requires structural refactoring. Ask permission. |
| Phase 3: Combine for Design | Does the Right Thing → Intent → Domain Abstraction | Requires reading call sites and domain context. Ask permission. |
| 阶段 | 步骤 | 特性 |
|---|---|---|
| 阶段1：洞察→命名 | 缺失→无意义→如实→如实且完整 | 通用阶段。纯命名调整。无需修改代码结构。可随时安全进行。 |
| 阶段2：命名→结构 | 如实且完整→做正确的事 | 针对特定代码库。需要进行结构性重构。需征得用户许可。 |
| 阶段3：结合以实现设计 | 做正确的事→意图→领域抽象 | 需要阅读调用场景和领域上下文。需征得用户许可。 |
Choose Your Mode
选择工作模式
This skill operates in two modes. Pick the one that matches the user's request.
| User signal | Mode | File |
|---|---|---|
Specific identifier named (" | improve-mode | |
| One clear target inside a code block + "リファクタリング" / "改善" | improve-mode | |
| "全体の命名を見直したい", "改善余地ある?", "命名レビュー", "scan", "audit", "リストだけほしい" | audit-mode | |
| Audit followup: "X だけ直して" after audit output | improve-mode (target = X) | |
| Ambiguous (large code paste, no specific target, no "全体" language) | Ask the user: "全体を監査しますか、特定の識別子を改善しますか?" |
Mode = audit: Read . Produce a structured table of all naming opportunities. Do not execute changes.
audit-mode.mdMode = improve: Read . Walk one identifier through phase transitions. Pause at phase boundaries.
improve-mode.mdBoth modes share diagnostic criteria, transition mechanics, and red flags from .
reference.md此技能有两种工作模式。请根据用户的请求选择对应模式。
| 用户信号 | 模式 | 文件 |
|---|---|---|
指定了具体标识符（如“改善 | 改进模式 | |
| 代码块中有明确的优化目标 + “重构”/“改善” | 改进模式 | |
| “想要重新审视整体命名”、“有改进空间吗？”、“命名评审”、“扫描”、“审计”、“只要列表” | 审计模式 | |
| 审计后续：审计输出后用户提出“只修改X” | 改进模式（目标=X） | |
| 需求模糊（粘贴大段代码、无特定目标、无“整体”相关表述） | 询问用户：“您需要对整体进行审计，还是改进特定标识符？” |
模式=审计： 阅读。生成包含所有命名优化点的结构化表格。不执行修改操作。
audit-mode.md模式=改进： 阅读。针对单个标识符逐步完成阶段转换。在阶段边界处暂停。
improve-mode.md两种模式均共享中的诊断标准、转换机制和警示标志。
reference.mdWhen to Stop (improve-mode depth signals)
何时停止（改进模式的深度信号）
| User signal | Stop at |
|---|---|
| "急いでる" / "bug fix" / "とりあえず" | Honest (mid Phase 1) |
| "改善して" / generic rename | Honest and Complete (end of Phase 1) |
| "リファクタリング" | Does the Right Thing (Phase 2) |
| "設計から見直したい" / "ドメイン的に整理" | Intent or Domain Abstraction (Phase 3) |
"You take the minimum steps to get the name to meet your need for the current story." — leaving names incomplete for colleagues to extend is a feature, not a flaw.
| 用户信号 | 停止阶段 |
|---|---|
| “赶时间” / “bug修复” / “先凑合用” | 如实（阶段1中期） |
| “进行改进” / 通用重命名 | 如实且完整（阶段1结束） |
| “重构” | 做正确的事（阶段2） |
| “想从设计层面重新审视” / “按领域整理” | 意图或领域抽象（阶段3） |
“你只需采取最少步骤让名称满足当前任务需求。”——让名称处于未完成状态以便同事后续扩展，这是一种设计优势，而非缺陷。
Files in This Skill
此技能包含的文件
- — this file. Router and overview.
SKILL.md - — shared 7-step diagnosis table, transitions, red flags, applesauce/probably_/AndStuff guidance.
reference.md - — exhaustive scan workflow + output template.
audit-mode.md - — interactive single-target workflow + pause protocol.
improve-mode.md
Read the mode file you selected, plus for diagnosis details.
reference.md- —— 本文件。路由与概述。
SKILL.md - —— 共享的7步诊断表、转换规则、警示标志、applesauce/probably_/AndStuff相关指南。
reference.md - —— 全面扫描工作流 + 输出模板。
audit-mode.md - —— 交互式单目标工作流 + 暂停规则。
improve-mode.md
请阅读你选择的模式文件，以及获取详细诊断信息。
reference.md