age
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese/age
/age
Review a diff or scoped path before merging, after , or whenever the user wants evidence-backed observations rather than an approval verdict. Do not apply fixes here — owns application.
/press/cure在合并前、执行后,或用户需要基于证据的观察而非批准结论时,审查代码差异或限定范围的路径。请勿在此处应用修复——修复操作由负责。
/press/cureInputs
输入参数
text
/age [<ref-or-range>] [--scope <path>] [--comprehensive] [--full] [--safe] [--open-pr] [--auto] [--html]
/age <slug> [--full] [--safe] [--open-pr] [--auto] [--html]--full## Low--safe--open-pr/cure/plate/plateWhen called with a , resolve (if present) for press context and review the current working diff. When called with a , review that range. Default to the current working diff when neither is supplied. If the base branch is unclear, ask or use the repository's documented default.
<slug>.cheese/press/<slug>.md<ref-or-range>--auto/cook --auto## Handoff## Auto mode--hard/cure/plate/plate/hard-cheese--html.cheese/age/<slug>.mdpython3 src/age/age-html-report.py --report .cheese/age/<slug>.md --slug <slug>age.pyz html-reportshared/scripts/html_report.render_documentPortability reference: covers helper resolution, sub-agent dispatch, GitHub operations, and handoff transitions; prefer the bundled or repo-local helper first, 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}text
/age [<ref-or-range>] [--scope <path>] [--comprehensive] [--full] [--safe] [--open-pr] [--auto] [--html]
/age <slug> [--full] [--safe] [--open-pr] [--auto] [--html]--full## Low--safe--open-pr/cure/plate/plate当传入时,解析(如果存在)以获取press上下文,并审查当前工作差异。当传入时,审查该范围。若两者均未提供,默认审查当前工作差异。若基准分支不明确,询问用户或使用仓库文档中指定的默认分支。
<slug>.cheese/press/<slug>.md<ref-or-range>--auto/cook --auto## Handoff## Auto mode--hard/cure/plate/plate/hard-cheese--html.cheese/age/<slug>.mdpython3 src/age/age-html-report.py --report .cheese/age/<slug>.md --slug <slug>age.pyz html-reportshared/scripts/html_report.render_document可移植性参考:涵盖了助手解析、子代理调度、GitHub操作和交接转换;优先使用捆绑包或仓库本地助手,将视为可选的宿主提供的备用方案。以下交接块是可移植契约;斜杠命令是宿主呈现形式,而非控制模型。
../cheese/references/harness-portability.md${CLAUDE_SKILL_DIR}Review dimensions
审查维度
Dimensions answer what kind of problem. Severity () is per-finding, computed from base + location + compounding modifiers (see § Severity computation).
blocker / high / medium / lowreferences/dimensions.md| Dimension | Base range |
|---|---|
| correctness | low → blocker |
| security | low → blocker |
| encapsulation | low → blocker |
| spec | low → blocker |
| complexity | low → high |
| deslop | low → high |
| assertions | low → blocker |
| nih | low → high |
| efficiency | low → blocker |
| telemetry | low → blocker |
Per-dimension base-severity tables, location-sensitivity, fix-cost-now / fix-cost-later, and recommendation shapes live in — read it before computing any finding's severity. This reduced workflow intentionally omits the git-history/precedent dimension.
references/dimensions.md维度用于说明问题类型。严重程度()针对每个发现,由基础值+位置+复合修正项计算得出(详见中的“严重程度计算”章节)。
blocker / high / medium / lowreferences/dimensions.md| 维度 | 基础范围 |
|---|---|
| correctness | low → blocker |
| security | low → blocker |
| encapsulation | low → blocker |
| spec | low → blocker |
| complexity | low → high |
| deslop | low → high |
| assertions | low → blocker |
| nih | low → high |
| efficiency | low → blocker |
| telemetry | low → blocker |
各维度的基础严重程度表、位置敏感性、即时修复成本/后续修复成本以及建议形态均收录于——在计算任何发现的严重程度前,请先阅读该文档。此简化工作流程有意省略了git历史/先例维度。
references/dimensions.mdFlow
流程
-
Identify the diff, scope, and relevant spec or issue. Mode check: compute the review range'sscore and risk flags, then call
review_surface(age_route.route(score=..., risk_flags=..., entry="age")).src/fanout/age_route.py— steps 2–4 below, unchanged. Anyn=1— readn>1first; itsreferences/fan-out.mdlist, not a fixed label, sets worker count. Fan-out also requireslensesnot itself be a sub-agent — stay single-parent when it is. Thread the router's/ageinto the reviewer dispatch.effort -
Gather evidence: diff, touched files, tests, callers/imports. If a press report exists for this slug, read it via(bundle fallback:
python3 shared/scripts/read_handoff_slug.py --phase press --slug <slug>) and summarise unresolved items in acommon.pyz read_handoff_slug --phase press --slug <slug>sub-section —## Press findingsonly reads/cure..cheese/age/<slug>.mdNo press report but a cook handoff exists: record(seepress: skipped) and print the warning at handoff. No cook artifact either: skip the marker and continue.## OutputIfexists, read it so naming drift can be flagged as a deslop finding..cheese/glossary/<slug>.md -
Review every dimension; dimensions with no findings simply omit themselves. Report every defect, however minor — never self-filter on perceived significance; filtering happens downstream in the verifier pass () or in severity computation (single-parent). Do not raise a finding for a gate failure identical to the diff's recorded
n>1block — seebaseline:; flag only new or changed failures.../cook/references/quality-gates.md -
Compute severity per finding (base + location bump + compounding bump, capped at). Group findings by severity (
blocker); within a severity group, order by file.## Blocker → ## High → ## Medium → ## Low -
Write the report (see), then
## Output(bundle fallback:python3 shared/scripts/write_handoff_artifact.py --phase age --slug <slug> --status ok --next cure --artifact "" --orientation "<one-line orientation>" --durable-flags "<none | one line per flag>" --body-file "$report_file"with the same flags). Print the path.${CLAUDE_SKILL_DIR}/scripts/common.pyz write_handoff_artifact -
Hand off (seebelow).
## Handoff
-
识别差异、范围及相关规范或问题。模式检查:计算审查范围的分数和风险标志,然后调用
review_surface(age_route.route(score=..., risk_flags=..., entry="age"))。若src/fanout/age_route.py,则执行以下步骤2-4,流程不变。若n=1,请先阅读n>1;其中的references/fan-out.md列表(而非固定标签)决定了工作者数量。扇出还要求lenses本身不是子代理——当它是子代理时,保持单父结构。将路由器的/age参数传入审查器调度。effort -
收集证据:差异、被修改文件、测试、调用者/导入项。如果该slug存在press报告,通过(备用捆绑包:
python3 shared/scripts/read_handoff_slug.py --phase press --slug <slug>)读取并在common.pyz read_handoff_slug --phase press --slug <slug>子章节中总结未解决的问题——## Press findings仅读取/cure。.cheese/age/<slug>.md若不存在press报告但存在cook交接记录:记录(详见press: skipped)并在交接时打印警告。若也不存在cook工件,则跳过标记并继续。## Output若存在,读取该文件以便将命名偏差标记为deslop发现。.cheese/glossary/<slug>.md -
审查所有维度;无发现的维度直接省略。报告所有缺陷,无论多细微——切勿自行过滤认为不重要的问题;过滤操作会在下游的验证阶段()或严重程度计算(单父结构)中进行。对于与diff中记录的
n>1块完全相同的闸门失败,请勿提出发现——详见baseline:;仅标记新出现或已更改的失败。../cook/references/quality-gates.md -
计算每个发现的严重程度(基础值+位置提升+复合提升,上限为)。按严重程度分组(
blocker);在同一严重程度组内,按文件排序。## Blocker → ## High → ## Medium → ## Low -
撰写报告(详见),然后执行
## Output(备用捆绑包:python3 shared/scripts/write_handoff_artifact.py --phase age --slug <slug> --status ok --next cure --artifact "" --orientation "<单行描述>" --durable-flags "<none | 每行一个标志>" --body-file "$report_file"并使用相同参数)。打印报告路径。${CLAUDE_SKILL_DIR}/scripts/common.pyz write_handoff_artifact -
交接(详见下方)。
## Handoff
Preferred tools and fallbacks
首选工具及备选方案
Call source-code backends directly according to the shared contract. For caller graphs, use the selected semantic backend's caller query plus when available.
code-intelligence-routing.mdtilth_deps| Need | Prefer | Fallback |
|---|---|---|
| Diff inspection | | |
| Caller/dependency impact + curated review context | semantic caller search + | manual scoping; note the precision loss |
| Architecture / hotspot framing for large diffs | changed-file map + caller/dependency evidence | skip and note in confidence |
| Design rationale for encapsulation/spec dimensions (optional) | | skip; omit |
| GitHub/PR context | | local git commands or user-provided PR data |
| Merge/conflict awareness | mergiraf | manual conflict checks |
Optional MCPs: hallouminate and milknado follow the detect-and-degrade contract in — state absence once, fall back, reduce confidence only if evidence quality suffers, never block.
../cheese/references/optional-plugins.md根据共享的契约直接调用源代码后端。对于调用图,优先使用所选语义后端的调用查询+(如果可用)。
code-intelligence-routing.mdtilth_deps| 需求 | 首选方案 | 备选方案 |
|---|---|---|
| 差异检查 | | |
| 调用者/依赖影响 + 精心整理的审查上下文 | 语义调用搜索 + | 手动范围界定;记录精度损失 |
| 大型差异的架构/热点框架 | 修改文件映射 + 调用者/依赖证据 | 跳过并记录置信度 |
| 封装/规范维度的设计原理(可选) | | 跳过;省略 |
| GitHub/PR上下文 | | 本地git命令或用户提供的PR数据 |
| 合并/冲突感知 | mergiraf | 手动冲突检查 |
可选MCP:hallouminate和milknado遵循中的检测降级契约——仅声明一次缺失,然后降级;仅当证据质量受影响时降低置信度,绝不阻塞流程。
../cheese/references/optional-plugins.mdSub-agent fan-out
子代理扇出
/agesrc/fanout/age_route.py../cheese/references/agent-resolution.mddegraded: truereferences/fan-out.mdreferences/packet.mdreferences/sub-agent-gate.md/agesrc/fanout/age_route.py../cheese/references/agent-resolution.mddegraded: truereferences/fan-out.mdreferences/packet.mdreferences/sub-agent-gate.mdOutput
输出
Cross-cutting house style and citation form: . This section owns the findings-report shape; formatting.md owns the voice rules and the footnote primitive.
../cheese/references/formatting.mdWrite to with a minimum handoff slug at the top — , , , , , one-line orientation. is the first body line after the blank separator when a cook artifact exists but no press report does; omit it otherwise.
.cheese/age/<slug>.mdstatusnextartifactdurable_flagsbaselinepress: skippedBody, in order: ; (1-2 sentences); (omit unless a press report exists); (omit unless hallouminate grounding hit); severity sections (, then , then ); ; . See for the full skeleton plus a worked instantiation.
# Age Report — <slug>## Orientation## Press findings## Wiki context**[dim:sev]** path:line — claimlocation: <tier> · fix-cost-now: <tier> · fix-cost-later: <tier> · confidence: <tier>recommendation: <action>## Confidence## Next stepreferences/report-example.mdEmpty severity sections are omitted entirely. When ten or more findings exist, collapse the section to a single line:
low## Lowmarkdown
undefined跨领域格式规范及引用形式:。本节定义了发现报告的结构;formatting.md定义了表述规则和脚注格式。
../cheese/references/formatting.md写入,顶部包含最少交接信息——、、、、、单行描述。当存在cook工件但无press报告时,在空白分隔符后的第一行写入;否则省略。
.cheese/age/<slug>.mdstatusnextartifactdurable_flagsbaselinepress: skipped正文顺序:;(1-2句话);(仅当存在press报告时保留);(仅当hallouminate找到相关内容时保留);严重程度章节(,然后是,最后是);;。完整框架及示例详见。
# Age Report — <slug>## Orientation## Press findings## Wiki context**[dim:sev]** path:line — 问题描述location: <层级> · fix-cost-now: <层级> · fix-cost-later: <层级> · confidence: <层级>recommendation: <操作建议>## Confidence## Next stepreferences/report-example.md空的严重程度章节将完全省略。当存在10个及以上发现时,将章节折叠为单行:
low## Lowmarkdown
undefinedLow
Low
N low-severity findings suppressed. Re-run with (or ) to see them.
--full/age --full
Per-finding `confidence:` uses the voice-kernel scale (`references/voice.md` § Reasoning posture): `certain` — verified by direct evidence (diff/code read, command output); `speculating` — inferred from indirect signal. A `don't know` grading never ships as a finding row — gather the missing evidence or drop the claim. Suppressed lows feed the cure-selection table only when `--full` is passed.
`status: ok` when the review completed; `status: halt: <reason>` when evidence was unreachable. `next: cure` when any finding meets the **medium+ floor**; `next: done` otherwise. `durable_flags:` mirrors cook's gate: default `none`.
Then print `Age report: .cheese/age/<slug>.md`. When `press: skipped` is set, also print: `Warning: no /press report for <slug> — hardening was skipped. Run /press <slug> first, or continue with /cure.` When `--html` is passed, also print the HTML path returned by `html-report` (render command under `--html` in `## Inputs`).已隐藏N个低严重程度发现。使用(或)重新运行以查看详情。
--full/age --full
每个发现的`confidence:`使用核心表述尺度(`references/voice.md`中的“推理姿态”章节):`certain`——由直接证据验证(差异/代码阅读、命令输出);`speculating`——由间接信号推断。`don't know`评级绝不会作为发现行输出——要么收集缺失证据,要么放弃该结论。仅当传递`--full`时,被隐藏的低严重程度发现才会纳入修复选择表。
当审查完成时,`status: ok`;当证据无法获取时,`status: halt: <原因>`。当任何发现达到**medium及以上**标准时,`next: cure`;否则`next: done`。`durable_flags:`与cook的闸门一致:默认值为`none`。
然后打印`Age report: .cheese/age/<slug>.md`。当设置了`press: skipped`时,还需打印:`Warning: no /press report for <slug> — hardening was skipped. Run /press <slug> first, or continue with /cure.`当传递`--html`时,还需打印`html-report`返回的HTML路径(`## Inputs`中`--html`下的渲染命令)。Handoff
交接
Pipeline: culture → mold → cook → press → [age] → cure → plate
Compute the recommended set. Composite : the medium floor (blocker+high+medium) unioned with every at .
all-medium, cheapLowfix-cost-now: containedDecide act vs ask:
- Empty set — write , print the report path, stop.
next: done - Reason to ask — a set member has or
fix-cost-now: sprawling, findings conflict, orfix-cost-later: structuralwas passed: read--safeand render the gate perreferences/handoff-detail.md, pre-selecting the composite and flagging heavy rows.../cheese/references/handoff-gate.md - Otherwise — act: announce the selection and dispatch per
/cure§ Dispatch. No gate.references/handoff-detail.md
--auto## Auto modereferences/handoff-detail.md/cook流水线:culture → mold → cook → press → [age] → cure → plate
计算推荐集:合并:即medium及以上严重程度(blocker+high+medium)加上所有的发现。
all-medium, cheapfix-cost-now: containedLow决定执行还是询问:
- 空集——写入,打印报告路径,停止流程。
next: done - 需要询问的情况——集合中存在或
fix-cost-now: sprawling的发现、发现存在冲突,或传递了fix-cost-later: structural:阅读--safe并根据references/handoff-detail.md呈现闸门,预先选择推荐集并标记复杂项。../cheese/references/handoff-gate.md - 其他情况——执行:宣布选择结果并根据中的“调度”章节调度
references/handoff-detail.md。无需闸门。/cure
--auto## Auto modereferences/handoff-detail.md/cookAuto mode
自动模式
When invoked with :
--auto- Skip the handoff gate.
- If two cure passes have already completed (cap reached), stop and surface the final report — do not invoke again even if findings remain.
/cure - Otherwise, if any finding meets the medium+ floor — invoke (forward
/cure <slug> --auto --stake medium+when it is in scope) and increment the cure-pass count when it returns.--open-pr - If no finding meets the medium+ floor, stop the chain with a one-line "auto chain clean" note and the report path.
当使用调用时:
--auto- 跳过交接闸门。
- 若已完成两次cure流程(达到上限),停止并展示最终报告——即使仍有发现,也不再调用。
/cure - 否则,若任何发现达到medium及以上标准——调用(若适用则传递
/cure <slug> --auto --stake medium+),并在返回时增加cure流程计数。--open-pr - 若没有发现达到medium及以上标准,以一行“auto chain clean”提示和报告路径停止流程链。
Within cook's own fan pathway
在cook自身的扇出路径中
/cookreferences/handoff-detail.md/cookreferences/handoff-detail.mdRules
规则
- Review is not a verdict; explain where to look and why.
- Do not edit production files; owns application.
/cure - Do not raise a finding for a gate failure identical to the diff's recorded block; flag only new/changed failures per
baseline:.../cook/references/quality-gates.md - Default to acting: auto-select the recommended set, dispatch without a gate. Ask first only on a genuine reason or
/cure. An empty recommended set is a clean stop, not a question.--safe - Do not invent evidence; cite files, diffs, commands, or unavailable-source notes.
- Agree when the diff is fine — an empty dimension is a valid outcome, not a gap to fill.
- Keep confidence qualitative () at both the report and per-finding level; never a numeric score.
certain | speculating | don't know - Findings carry location + recommendation, not JSON sidecars or tag-anchored fix payloads — reads the markdown directly.
/cure - Apply (output discipline, reasoning posture, confidence vocabulary).
references/voice.md
- 审查并非裁决;需说明问题位置及原因。
- 请勿编辑生产文件;负责应用修复。
/cure - 对于与diff中记录的块完全相同的闸门失败,请勿提出发现;仅根据
baseline:标记新出现或已更改的失败。../cook/references/quality-gates.md - 默认执行:自动选择推荐集,无需闸门直接调度。仅在确实需要或传递
/cure时才先询问。空推荐集表示流程干净结束,而非需要询问。--safe - 请勿编造证据;需引用文件、差异、命令或无法获取源的说明。
- 若diff无问题则确认——空维度是有效结果,而非需要填补的空白。
- 在报告和每个发现层面保持定性的置信度();绝不使用数字评分。
certain | speculating | don't know - 发现需包含位置+建议,而非JSON附加数据或带标签的修复负载——直接读取markdown。
/cure - 遵循(输出规范、推理姿态、置信度词汇)。
references/voice.md
References
参考文档
- — before grading any finding: rubrics, location sensitivity, fix-cost tables, recommendation shapes.
references/dimensions.md - — before any
references/fan-out.mddispatch: router mechanics, lens partitions, six-seam sequence, verifier pass.n>1 - — when assembling the Seam-2 shared context packet for a fan-out run.
references/packet.md - — before any sub-agent dispatch: digest contract, harness-agnostic selection, what the parent never delegates.
references/sub-agent-gate.md - — before the selection gate or a
references/handoff-detail.mddispatch: gate menu, dispatch payload, cook-fan-pathway no-chain override./cure - — alongside
references/report-example.md: worked rendering plus the full placeholder skeleton.## Output - — when writing the report: output discipline, reasoning posture, confidence vocabulary.
references/voice.md - ,
references/deslop-rust.md,references/deslop-typescript.md,references/deslop-python.md,references/deslop-shell.md— when gradingreferences/deslop-go.mdin that language: pattern catalogs with lint-rule mappings.deslop
- ——在对任何发现评分前阅读:评分标准、位置敏感性、修复成本表、建议形态。
references/dimensions.md - ——在任何
references/fan-out.md调度前阅读:路由器机制、透镜分区、六阶段流程、验证阶段。n>1 - ——当为扇出运行组装Seam-2共享上下文包时阅读。
references/packet.md - ——在任何子代理调度前阅读:摘要契约、与 harness 无关的选择、父代理绝不委托的内容。
references/sub-agent-gate.md - ——在选择闸门或调度
references/handoff-detail.md前阅读:闸门菜单、调度负载、cook扇出路径的无链覆盖规则。/cure - ——结合
references/report-example.md阅读:示例渲染及完整占位符框架。## Output - ——撰写报告时阅读:输出规范、推理姿态、置信度词汇。
references/voice.md - 、
references/deslop-rust.md、references/deslop-typescript.md、references/deslop-python.md、references/deslop-shell.md——在对对应语言的references/deslop-go.md评分时阅读:带有lint规则映射的模式目录。deslop
Agent resolution
代理解析
Resolve every dimension worker and fresh-context review through .
../cheese/references/agent-resolution.md| Work | Preferred types | Permissions/isolation | Minimum power | Effort | Fallback |
|---|---|---|---|---|---|
| Review a diff or one dimension | reviewer | read-only, fresh-context | powerful | high | compatible reviewer, then general |
The canonical age report/handoff carries the shared block.
agent_resolution通过解析所有维度工作者和fresh-context审查器。
../cheese/references/agent-resolution.md| 工作内容 | 首选类型 | 权限/隔离 | 最低能力 | 工作量 | 备选方案 |
|---|---|---|---|---|---|
| 审查差异或单个维度 | reviewer | 只读、新鲜上下文 | 强能力 | 高 | 兼容reviewer,然后是通用代理 |
标准的age报告/交接包含共享的块。
agent_resolution