mold
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese/mold
/mold
Two modes, by analogy to :
/culture- User-invoked full ceremony (default). The user typed (or
/moldrouted an explicit fuzzy-design ask straight here). Runs the full Explore/Ground/Shape/Sketch/Grill/Diagnose dialogue and the two-key handshake before any spec is written; the Flow below describes it./cheese - Agent-invoked mini-spec mode. calls into
/cheeseat tier 1 of its escalation (/mold§ Escalation) when the cook fast-path checks all pass and a spec must materialise beforeskills/cheese/SKILL.mdruns. No dialogue, no handshake. See/cook --autobelow.## Agent-invoked mini-spec mode
类比,该技能有两种模式:
/culture- 用户触发的完整流程(默认模式)。用户输入了(或
/mold将明确的模糊设计请求直接转发至此)。在撰写任何规范前,会完整执行探索/锚定/塑形/草图/推敲/诊断的对话流程,以及双密钥确认环节;下方的“流程”部分将详细描述。/cheese - Agent触发的迷你规范模式。当执行前必须生成规范,且所有快速路径检查均通过时,
/cook --auto会在其升级流程的第1层(见/cheese§ 升级)调用skills/cheese/SKILL.md。此模式无对话、无确认环节。详见下方的/mold。## Agent触发的迷你规范模式
Flow
流程
- Bounds pass — before routing, run one Explore-style bounds round for every input shape: map the problem's edges to candidate goals and non-goals, asking the user rather than assuming. Open the per-round decision ledger (; see
Decided / Asking / [AGENT-DECIDED]). Tier it — a clear input gets a single fast confirm, not a full A/B/C/D menu — but never skip it. When the dialogue reveals full-spec-sized work, warn to upgrade tier (harness-detected: claude## Rules+/model opus; codex/OMP equivalent; generic fallback) before continuing./effort - Route — pick the secondary mode from the input shape (see ) and announce it in one line. If the user's framing rests on a false premise or a loaded assumption, name it before routing.
references/modes.md - Dialogue — build shared understanding: every consequential fork is the user's to pick, surfaced as a choice, never settled for them. Contribute full depth (options, edge cases, evidence) to inform each question, never to replace asking it. Ground every critical claim via the selected source-code search/read backend, a Validate Cycle (), or — for an ungrillable design unknown — a Prototype Cycle (
references/validate-cycle.md); both are sub-agent-spawnable mid-dialogue, in parallel, context-bounded (soft backstop of 10). Track and resolve contradictions across turns before continuing. After 3 consecutive fork questions, or on "what forks are left?", render the decision map (references/prototype-cycle.md§ Decision map).## Rules - Sketch — for any feature touching >1 module or a new public interface, run the shape check () on the touched symbols, then lock seams in pseudocode signatures before talking spec content. While the code is open, bind every identity/ownership-role noun to a code referent per
references/shape-check.md§ Entity-referent binding — a search hit of a different referent is an alias, not a pass.references/handshake.md - Decompose for approval — once the draft spec and any pre-Curdle follow-up disposition are complete, dispatch the fresh-context curd-block decomposer on the draft text and validate its result before requesting approval. Retry an invalid result once; if it is still invalid, stop before the handshake rather than approving a block that cannot be persisted. Present the validated curd block as at the handshake. See
N curds / M waves§ "Pre-approval decomposer dispatch".references/curdle.md - Two-key handshake — both the user (explicit verb) and the agent (coherence self-check) must agree to the draft spec and displayed curd plan before extraction. Neither key changes or disappears. See .
references/handshake.md - Curdle — resolve the durable spec path with (bundle-only host fallback:
SPEC=$(python3 shared/scripts/artifact_path.py specs <slug>)). The resolver anchors specs at the per-project durable corpus (python3 skills/mold/scripts/mold.pyz artifact-path specs <slug>§ Corpus location); never hardcode a repo-local spec path. Phase one writes every local artifact and write-ahead prepared state before any external call: the approved spec at../cheese/references/formatting.md, the same approved curd block as"$SPEC", any local issue drafts, and the session's non-obvious decisions as durable ADRs. Phase two then publishes approved follow-ups, retains prepared recovery state when an external capability is unavailable or publication fails, and reconciles their state and references into the durable spec. Never re-dispatch or mutate the approved curd block during Curdle. Format, slug, publication, reconciliation, corpus-resolution, and curd-block persistence rules:## Curdsandreferences/curdle.md.references/adr.md - Count and hand off — only after phase-two publication attempts and reconciliation finish, run for the recommended downstream skill (procedure in
python3 skills/mold/scripts/mold.pyz curd-count "$SPEC" --blast-radius <low|medium|high>), then prompt viareferences/curd-count.md. Never dispatch before the user selects; after a non-stop selection, run the selected skill immediately.## Handoff
Portability reference: . It covers helper resolution, sub-agent dispatch, GitHub operations, and handoff transitions; prefer the bundled or repo-local helper first, and treat as optional host-provided fallback.
The handoff blocks below are the portable contract; slash commands are host renderings, not the control model.
../cheese/references/harness-portability.md${CLAUDE_SKILL_DIR}- 边界确认 —— 在转发前,针对所有输入类型执行一轮探索式边界确认:将问题的边界映射为候选目标和非目标,需询问用户而非自行假设。开启每轮的决策记录(;见
已确定 / 待询问 / [AGENT已确定])。根据输入情况分层处理——清晰的输入只需快速确认,无需提供A/B/C/D选项菜单——但绝不能跳过此步骤。当对话显示需要生成完整规范的工作量时,需提醒用户升级层级(系统检测:Claude## 规则+/model opus;Codex/OMP等效工具;通用备选方案)后再继续。/effort - 转发 —— 根据输入类型选择次要模式(见),并以一行文字告知用户。如果用户的表述基于错误前提或带有诱导性假设,需在转发前指出。
references/modes.md - 对话 —— 建立共识:每个关键分支都由用户选择,需以选项形式呈现,绝不能替用户决定。为每个问题提供充分的信息(选项、边缘情况、证据)以辅助决策,而非直接给出答案。通过选定的源代码搜索/读取后端、验证循环()或——针对无法推敲的未知设计——原型循环(
references/validate-cycle.md)来锚定所有关键主张;这两种循环均可在对话中并行生成子Agent,且受上下文限制(软上限为10)。在继续对话前,需跟踪并解决各轮对话中的矛盾点。在连续3次分支问题后,或用户询问“还剩哪些分支?”时,需生成决策图谱(references/prototype-cycle.md§ 决策图谱)。## 规则 - 草图绘制 —— 对于涉及多个模块或新公共接口的功能,需对涉及的符号执行塑形检查(),然后在讨论规范内容前,用伪代码签名锁定接口边界。在打开代码时,需按照
references/shape-check.md§ 实体-引用绑定规则,将每个身份/所有权角色名词绑定到代码引用——搜索到的不同引用视为别名,而非有效绑定。references/handshake.md - 分解以获取批准 —— 一旦草稿规范和任何预固化后续处理完成,需在请求批准前,对草稿文本调用新上下文的固化块分解器并验证结果。无效结果可重试一次;若仍无效,需在确认环节前停止,而非批准无法持久化的块。在确认环节展示已验证的固化块,格式为。详见
N个固化单元 / M个阶段§ “预批准分解器调用”。references/curdle.md - 双密钥确认 —— 用户(明确指令)和Agent(一致性自检)必须同时同意草稿规范和显示的固化计划,才能提取成果。两者缺一不可。详见。
references/handshake.md - 固化 —— 通过(仅捆绑主机的备选方案:
SPEC=$(python3 shared/scripts/artifact_path.py specs <slug>))确定持久化规范的路径。解析器将规范锚定在每个项目的持久化语料库中(python3 skills/mold/scripts/mold.pyz artifact-path specs <slug>§ 语料库位置);绝不能硬编码本地仓库的规范路径。第一阶段:在进行任何外部调用前,写入所有本地工件和预写入的准备状态:获批规范存储在../cheese/references/formatting.md,获批的固化块存储为"$SPEC",任何本地问题草稿,以及会话中非显而易见的决策作为持久化ADR。第二阶段:发布获批的后续内容,当外部功能不可用或发布失败时保留准备好的恢复状态,并将其状态和引用协调到持久化规范中。固化过程中绝不能重新调用或修改获批的固化块。格式、别名、发布、协调、语料库解析和固化块持久化规则:见## 固化单元和references/curdle.md。references/adr.md - 统计与移交 —— 仅在第二阶段发布尝试和协调完成后,运行以推荐下游技能(流程见
python3 skills/mold/scripts/mold.pyz curd-count "$SPEC" --blast-radius <low|medium|high>),然后通过references/curd-count.md提示用户。绝不能在用户选择前自动分发;用户选择非停止选项后,立即运行选定的技能。## 移交
可移植性参考:。它涵盖了助手解析、子Agent调用、GitHub操作和移交过渡;优先使用捆绑或本地仓库的助手,并将视为可选的主机提供的备选方案。
下方的移交块是可移植契约;斜杠命令是主机渲染内容,而非控制模型。
../cheese/references/harness-portability.md${CLAUDE_SKILL_DIR}Follow-up candidates
后续候选项
Every non-goal and explicit dialogue deferral enters the session's follow-up candidate set, logged as . When candidates exist, the pre-Curdle disposition batch must complete before the two-key handshake can pass; omit it when none exist. Ledger notation, dialogue-state semantics, and Curdle-ordering detail: § Follow-up disposition.
[FOLLOW-UP?]references/handshake.md所有非目标和明确推迟的对话内容都会进入会话的后续候选集,记录为。当存在候选项时,必须完成预固化处理,双密钥确认才能通过;若无候选项则可省略。记录符号、对话状态语义和固化顺序细节:见 § 后续处理。
[FOLLOW-UP?]references/handshake.mdModes
模式
| Mode | Use when | Goal |
|---|---|---|
| Explore | The idea is vague | Identify the real problem and pain point |
| Ground | A file, bug, or existing doc is named | Verify facts against evidence |
| Shape | The goal is known but approach is open | Compare viable options (Do Nothing always included) |
| Sketch | Interfaces or module boundaries matter | Lock responsibilities and seams |
| Grill | A favoured approach needs stress-testing | Steelman each item, then put every design-changing call to the user as a fork |
| Diagnose | A symptom, failure, or trace is supplied | Build a Loop → reproduce → hypothesize → confirm root cause |
Full mode definitions, exit criteria, and user knobs: . Trigger and trace evals, including the Grill user-fork checks: .
references/modes.mdreferences/evals.md| 模式 | 使用场景 | 目标 |
|---|---|---|
| Explore | 想法模糊不清时 | 识别真实问题与痛点 |
| Ground | 提及了文件、Bug或现有文档时 | 根据证据验证事实 |
| Shape | 目标明确但实现方案未定 | 比较可行的选项(始终包含“不做任何修改”选项) |
| Sketch | 接口或模块边界至关重要时 | 锁定职责与边界 |
| Grill | 偏好的方案需要压力测试时 | 强化每个细节,然后将所有影响设计的决策交由用户选择 |
| Diagnose | 提供了症状、故障或追踪信息时 | 构建循环 → 复现 → 假设 → 确认根本原因 |
完整的模式定义、退出标准和用户可调参数:见。触发和追踪评估,包括Grill模式的用户分支检查:见。
references/modes.mdreferences/evals.mdAgent-invoked mini-spec mode
Agent触发的迷你规范模式
/cheese/mold/cheese/cook --auto <spec-path>The two-key handshake does not fire in this mode; the agent-introduced-scope check still runs implicitly — every distinguishing noun in the mini-spec must come from the user's input or the tier-2 / synthesis, never a silent agent addition.
/culture/briesearchFull procedure, the mini-spec schema, and the rules: .
## Provenancereferences/mini-spec-mode.md当调用方的快速路径检查已通过时,的第1层升级会调用,无需面向用户的对话即可生成规范。此模式完全跳过上述流程:生成别名,撰写迷你规范,返回解析后的规范路径,以便调用。
/cook/cheese/mold/cheese/cook --auto <spec-path>此模式不触发双密钥确认;但仍会隐式执行Agent引入范围检查——迷你规范中的每个独特名词必须来自用户输入或第2层/的合成结果,绝不能由Agent静默添加。
/culture/briesearch完整流程、迷你规范 schema 和规则:见。
## 来源references/mini-spec-mode.mdPreferred tools and fallbacks
首选工具与备选方案
Call source-code search, read, and edit backends directly according to . Shape checks use semantic caller search plus dependency context; procedure: .
code-intelligence-routing.mdreferences/shape-check.mdBeyond source-code routing there are mold-specific tools:
| Need | Prefer | Fallback |
|---|---|---|
| External validation | | user-provided docs, repo docs, or note as unverified |
Wiki grounding (Ground entry + decision points; scope per | | skip; proceed with code evidence only; cap at |
Optional tools accelerate the work but never block the dialogue. When evidence is unavailable, mark the claim until settled.
[?]根据直接调用源代码搜索、读取和编辑后端。塑形检查使用语义调用者搜索加依赖上下文;流程见。
code-intelligence-routing.mdreferences/shape-check.md除源代码路由外,还有专用工具:
/mold| 需求 | 首选工具 | 备选方案 |
|---|---|---|
| 外部验证 | 带Context7/Tavily的 | 用户提供的文档、仓库文档,或标记为未验证 |
Wiki锚定(锚定环节+决策点;范围见 | | 跳过;仅依据代码证据继续;当设计理由为核心内容时,上限标记为 |
可选工具可加速工作,但绝不能阻塞对话。当证据不可用时,将主张标记为直至解决。
[?]Sub-agent context gate
子Agent上下文限制
/moldexplorerresearcher/briesearchreferences/context-budget.md/moldexplorerresearcher/briesearchreferences/context-budget.mdGate graph
限制图谱
Mold's gate state machine is one machine-readable model, rendered via . / need no binary; / use Graphviz when present and degrade to mermaid. A test keeps its gate nodes in lockstep with the coherence checklist, so a gate cannot be dropped from prose. Details: .
python3 skills/mold/scripts/mold.pyz gate-graph --render dot|svg|png|mermaiddotmermaidsvgpngdothandshake.mdreferences/gate-graph.mdMold的限制状态机是一个机器可读模型,可通过渲染。/无需二进制文件;/在有Graphviz 时使用,否则降级为mermaid。测试会使其限制节点与的一致性检查清单保持同步,因此限制条件不会从文本中遗漏。细节见。
python3 skills/mold/scripts/mold.pyz gate-graph --render dot|svg|png|mermaiddotmermaidsvgpngdothandshake.mdreferences/gate-graph.mdApproval gate
批准限制
Curdle requires the two-key handshake: an explicit user verb (e.g. , ) plus the agent's coherence self-check, with the validated curd block's presented alongside the final approval request (Flow step 5). Checklist, mandatory gates, and override semantics: .
curdleship itN curds / M wavesreferences/handshake.mdBefore the handshake fires, also run the agent-introduced-scope check — flag any noun in Approach / Decisions / Interface sketches the user did not type, and require explicit per-term approval before extraction. Full procedure and the single-chokepoint guarantee in § Agent-introduced scope.
references/handshake.mdIf any gate is unmet or the curd block remains invalid after one retry, propose the smallest next question, evidence check, or decomposer correction. Write artifacts only after both keys pass.
固化需要双密钥确认:用户明确指令(如、)加上Agent的一致性自检,同时在最终批准请求中展示已验证固化块的(流程步骤5)。检查清单、强制限制和覆盖语义:见。
curdleship itN个固化单元 / M个阶段references/handshake.md在确认环节触发前,还需执行Agent引入范围检查——标记出方案/决策/接口草图中用户未提及的任何名词,并要求在提取前获得明确的逐项批准。完整流程和单点阻塞保证见 § Agent引入范围。
references/handshake.md若任何限制未满足,或固化块在一次重试后仍无效,需提出最小化的下一个问题、证据检查或分解器修正。仅在双密钥均通过后才写入工件。
--hard
--hard
/mold --hard--hard/cook/cureskills/hard-cheese/SKILL.md../hard-cheese/references/composition.md/mold --hard--hard/cookcook/cureskills/hard-cheese/SKILL.md../hard-cheese/references/composition.mdHandoff
移交
Pipeline: culture → [mold] → cook → press → age → cure → plate
After Curdle's phase two finishes, run the curd-count script (procedure and rules in ), then render the branch menu below and prompt via the shared handoff gate. Never pre-select an autonomous option.
--blast-radiusreferences/curd-count.mdRead the JSON digest. is the uniform (recommended) option; the digest's field (, , or ) is orientation-only — it explains why a branch recommends the autonomous chain and is never rendered as a skill name. Ask via the shared handoff gate (), leading each option with the verb and the skill command (spec path plus any in-scope ) as backing detail.
/cookmodeparallellinearnull../cheese/references/handoff-gate.md--hardThe three blast-radius branches — decomposable, non-decomposable high-blast-radius, and non-decomposable low/medium — each render a fixed menu keyed off the digest's , , , and fields. Menu wording, the recommended/manual/stop options per branch, and 's role in choosing the branch: .
decomposablecandidate_curdsverdictmodemodereferences/handoff-menus.md流水线: culture → [mold] → cook → press → age → cure → plate
固化第二阶段完成后,运行固化单元统计脚本(流程和规则见),然后渲染下方的分支菜单,并通过共享移交限制提示用户。绝不能预先选择自主选项。
--blast-radiusreferences/curd-count.md读取JSON摘要。是统一的*(推荐)*选项;摘要中的字段(、或)仅用于说明——它解释了为何某个分支推荐自主链,绝不会作为技能名称显示。通过共享移交限制()询问用户,每个选项前需加上动词和技能命令(规范路径加任何范围内的)作为支持细节。
/cookmodeparallellinearnull../cheese/references/handoff-gate.md--hard三种影响范围分支——可分解、高影响范围不可分解、低/中等影响范围不可分解——各自根据摘要的、、和字段渲染固定菜单。菜单措辞、各分支的推荐/手动/停止选项,以及在分支选择中的作用:见。
decomposablecandidate_curdsverdictmodemodereferences/handoff-menus.mdRules
规则
- Dialogue first; artifacts are the by-product.
- Tiered lettered options. Consequential forks (scope, approach, non-goals, interface/seam, trade-offs) go to the user as choices via the question transport at
A/B/C/D— never resolved silently. Minor mechanical calls are logged../cheese/references/ask-user-question.mdinline with a one-line vetoable alternative (ADR-003). A fork is valid only after its depth was contributed in-dialogue first. Visible-prose gate (hard): every structured question MUST be preceded, same visible turn, by prose naming the fork, weighing options, and citing evidence — never in a thinking block, never straight from the user's message to the picker. One open picker: never emit a second structured question before the first is answered.[AGENT-DECIDED] - Per-round decision ledger. Each dialogue round prints . At curdle the ledger persists to the ADR(s) (
Decided / Asking / [AGENT-DECIDED]) plus a one-line minor decision-log on the spec; no separate ledger file (ADR-004).references/adr.md - Decision map. After 3 consecutive fork questions, or on "what forks are left?", render a compact map from the ledger: Done forks (from ), remaining-before-curdle forks split into required (
Decided§ Mandatory gates) vs optional, and a one-line curdle-readiness verdict (ready, or blocked naming the unmet gate). It renders existing state — not a new artifact, file, or script.references/handshake.md - Do not implement code.
- Do not write production files before the approval gate.
- Do not silently settle uncertain claims.
- Apply the shared voice kernel (lives at ): correct false premises, flag confidence as
../age/references/voice.mdon each critical claim, steelman before dismissing, and put the design-shaping decisions to the user — depth informs each question, it never replaces asking it.certain | speculating | don't know
- 对话优先;工件是副产品。
- 分层字母选项。关键分支(范围、方案、非目标、接口/边界、权衡)需通过的提问机制以
../cheese/references/ask-user-question.md选项形式呈现给用户——绝不能静默解决。次要机械决策需内联记录为A/B/C/D,并提供一行可否决的替代方案(ADR-003)。分支仅在对话中充分讨论后才有效。**可见文本限制(强制):**每个结构化问题必须在同一可见轮次中,先以文本说明分支、权衡选项并引用证据——绝不能在思考块中,也不能直接从用户消息跳到选项选择器。**单个待处理选择器:**在第一个问题得到答复前,绝不能发出第二个结构化问题。[AGENT已确定] - 每轮决策记录。每轮对话需打印。固化时,记录会持久化到ADR(
已确定 / 待询问 / [AGENT已确定])以及规范中的一行次要决策日志;无需单独的记录文件(ADR-004)。references/adr.md - 决策图谱。连续3次分支问题后,或用户询问“还剩哪些分支?”时,需从记录中生成紧凑图谱:已完成的分支(来自)、固化前剩余的分支分为必填(
已确定§ 强制限制)与可选,以及一行固化就绪 verdict(就绪,或指出未满足的限制)。它仅渲染现有状态——不生成新工件、文件或脚本。references/handshake.md - 不得实现代码。
- 不得在批准限制通过前写入生产文件。
- 不得静默解决不确定的主张。
- 应用共享语音内核(位于):纠正错误前提,将每个关键主张的置信度标记为
../age/references/voice.md,在否定前先强化对方观点,并将设计决策交由用户——充分的信息用于辅助提问,而非替代提问。确定 | 推测 | 未知
Agent resolution
Agent解析
Resolve delegates through .
../cheese/references/agent-resolution.md| Work | Preferred types | Permissions/isolation | Minimum power | Effort | Fallback |
|---|---|---|---|---|---|
| Explore the codebase | explorer | read-only, fresh-context | default | medium | compatible explorer, then general |
| Research external constraints | researcher | read-only, fresh-context | default | medium | compatible researcher, then general |
| Decompose for approval | planner, general | read-only, fresh-context | powerful | high | compatible planner, then general |
The canonical mold spec or mini-spec carries the shared block.
agent_resolution通过解析委托任务。
../cheese/references/agent-resolution.md| 工作内容 | 首选类型 | 权限/隔离 | 最低权限 | 工作量 | 备选方案 |
|---|---|---|---|---|---|
| 探索代码库 | explorer | 只读、新上下文 | 默认 | 中等 | 兼容的explorer,通用Agent |
| 研究外部约束 | researcher | 只读、新上下文 | 默认 | 中等 | 兼容的researcher,通用Agent |
| 分解以获取批准 | planner, general | 只读、新上下文 | 高权限 | 高 | 兼容的planner,通用Agent |
标准的mold规范或迷你规范包含共享的块。
agent_resolution