mino-reproducible-development

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Reproducible Development Router

可复现开发Router

実装詳細が変わっても、同じproblem、requirement、contract、model整合性、quality constraint、public boundaryを満たす変更を生成・判定する。

このrouterを使う基準は行数や抽象的な「規模」ではない。二つ以上の専門成果物を統合する必要がある、または実装・reviewを複数の成果物へend-to-endでtraceする必要がある場合に使う。単一成果物なら対応する専門Skillだけを使う。

即使实现细节发生变化，也能生成并判定符合相同problem、requirement、contract、模型一致性、quality constraint、public boundary的变更。

使用此Router的标准并非代码行数或抽象的「规模」。当需要整合两个以上的专业成果物，或需要端到端地追踪多个成果物的实现与评审过程时使用。若仅涉及单一成果物，只需使用对应的专业Skill即可。

Modes

```
design
```
: Implementation Specと未解決gateを作る。read-only。
```
implementation
```
: Implementation Spec内で変更し、独立検証する。変更権限が必要で、高impactな未承認判断には依存しない。
```
review
```
: 既存code / diffを要件と専門成果物へ照合する。read-only。
```
reproduction-test
```
: fresh contextの複数runを比較する。live workspaceは変更しない。

```
design
```
: 生成Implementation Spec和未解决的gate。只读模式。
```
implementation
```
: 在Implementation Spec内进行变更并独立验证。需要变更权限，且不依赖高影响的未批准决策。
```
review
```
: 将现有code / diff与需求及专业成果物进行比对。只读模式。
```
reproduction-test
```
: 对比fresh context下的多次运行结果。不修改实时工作区。

Outcome Contract

modeに応じた一つの主成果物を返す。

```
design
```
:
```
Implementation Spec
```
```
implementation
```
:
```
Verified Change
```
```
review
```
:
```
Review Result
```
```
reproduction-test
```
:
```
Reproduction Report
```

主成果物には、必要な範囲だけ次を統合する。

Problem Frame、Context Packet、AI restatement
Requirement Catalog、rejection criteria、end-to-end traceability
applicableなArchitecture / Completeness / Contract / Boundary package
Change Safety、Platform Context、platform別validation
independent verification、human approval、canonical
```
decision
```

Function packageを要約するときも、stable ID、Evidence、applicability、authority、coverage、subject verdictを失わない。schemaを全文複製するのではなく、losslessなpackageを参照可能な形で保持する。

根据不同mode返回对应的主成果物。

```
design
```
:
```
Implementation Spec
```
```
implementation
```
:
```
Verified Change
```
```
review
```
:
```
Review Result
```
```
reproduction-test
```
:
```
Reproduction Report
```

主成果物会在必要范围内整合以下内容：

Problem Frame、Context Packet、AI restatement
Requirement Catalog、拒绝准则、端到端可追踪性
适用的Architecture / Completeness / Contract / Boundary package
Change Safety、Platform Context、各平台专属validation
独立验证、人工审批、标准
```
decision
```

在总结Function package时，不得丢失stable ID、Evidence、适用性、权威性、覆盖范围、主题判定结果。无需复制完整schema，只需以可引用的形式保留无损的package。

Reference Routing

内部pathは、配置先にかかわらず、インストールされた
```
skills/
```
directoryを参照rootとして解決する。

最初に

skills/mino-core/references/core.md

、

skills/mino-core/references/shared-policies.md

、

skills/mino-core/references/requirements-and-traceability.md

を読む。

routing、Function package、mode別成果物、統合traceでは
```
skills/mino-reproducible-development/references/integrated-workflow.md
```
を読む。
filesystem、process、shell、toolchain、test実行、複数platform対応を扱うときだけ
```
skills/mino-core/references/platform-compatibility.md
```
を読む。
Skill更新またはreproduction-testでは
```
skills/mino-core/references/benchmark.md
```
を読む。
domain discovery、code design、existing changeは対応するmino-core referenceを必要時だけ読む。

専門Skillは

$mino-architecture-quality-strategy

、

$mino-domain-model-completeness

、

$mino-design-by-contract

、

$mino-interface-implementation-separation

から必要なものだけを依存順に呼ぶ。

各callへ

routing_context.origin: integrated

、

requested_by: router

、

requested_artifact

、

return_to: router

を渡し、専門Skillに再routingさせない。

router schema、Function package、platform matrix、benchmarkはsuite operationalizationまたはrepository policyとして扱う。

内部路径无论部署位置如何，均以已安装的
```
skills/
```
目录作为根目录进行解析。

首先读取

skills/mino-core/references/core.md

、

skills/mino-core/references/shared-policies.md

、

skills/mino-core/references/requirements-and-traceability.md

。

在路由、Function package、各mode成果物、整合追踪过程中，需读取
```
skills/mino-reproducible-development/references/integrated-workflow.md
```
。
仅在处理filesystem、process、shell、toolchain、测试执行、多平台适配时，读取
```
skills/mino-core/references/platform-compatibility.md
```
。
在Skill更新或reproduction-test时，读取
```
skills/mino-core/references/benchmark.md
```
。
仅在必要时读取对应mino-core reference，用于domain discovery、code design、现有变更处理。

专业Skill仅按依赖顺序调用

$mino-architecture-quality-strategy

、

$mino-domain-model-completeness

、

$mino-design-by-contract

、

$mino-interface-implementation-separation

中的必要内容。

向每个调用传递

routing_context.origin: integrated

、

requested_by: router

、

requested_artifact

、

return_to: router

，避免专业Skill进行二次路由。

router schema、Function package、platform matrix、benchmark需作为套件运营规则或仓库策略处理。

Default Routing

Request	Route
Problem Frame / Context Packetだけ	`$mino-problem-framing` へhand offし、routerを継続しない
統合依頼だがproblem、meaning、change boundaryが曖昧	Coreでframingし、必要なら `blocked` またはProblem Frameを返す
concept、state、failureの欠落	discovery as needed → completeness
pre / post / invariant、retry / duplicate / idempotency	contract。意味が未確定ならcompletenessを先行
技術漏出、caller分岐、long script	completeness / contract as needed → boundary
複数module、system-wide data authority、quality trade-off	architecture → completeness / contract / boundary as needed
legacyのend-to-end実装	Core → relevant Functions → change safety → implementation → verification
diffの要件適合review	Core → relevant Functions → independent verification。変更しない
private mechanical rename	このrouterを使わない

请求内容	路由目标
仅提供Problem Frame / Context Packet	转交至 `$mino-problem-framing` ，不再继续使用本router
整合请求，但problem、meaning、变更边界模糊	由Core进行框架梳理，必要时返回 `blocked` 状态或Problem Frame
缺少concept、state、failure相关信息	按需执行discovery → completeness
涉及pre / post / invariant、retry / duplicate / idempotency	走contract流程。若含义未确定，优先执行completeness
技术泄露、调用方分支、长脚本	按需执行completeness / contract → boundary
多模块、系统级数据权限、质量权衡	走architecture流程 → 按需执行completeness / contract / boundary
遗留系统的端到端实现	Core → 相关Functions → change safety → implementation → verification
验证diff是否符合需求的评审	Core → 相关Functions → 独立验证。不进行变更
私有机械重命名	不使用本router

Workflow

mode、decision scope、変更権限、可逆性、host / target platformを確認し、Evidence状態とdecision maturityを記録する。
Coreでproblem、premise、meaning、Context Packet、AI restatementを記録する。
Requirement Catalogとtest-first rejection criteriaを作る。
```
run_if
```
を明示して必要な専門Skillだけを依存順に実行する。
専門成果物をImplementation Specまたはmode別主成果物へ統合し、canonical ownerが重複していないか確認する。
```
mode == implementation && mutation_authorized
```
の場合だけ、小さな可逆stepで実装する。
実装者の説明と独立して、test、analysis、traceability、failure、change scenarioをrequired platformごとに検証する。
artifact readiness、subject verdict、engineering status、release status、human acceptanceを分けて返す。
reproduction-testではfresh contextのrunを同じgateで比較する。

确认mode、决策范围、变更权限、可逆性、host / target platform，记录Evidence状态与决策成熟度。
在Core中记录problem、前提、meaning、Context Packet、AI restatement。
创建Requirement Catalog与测试优先的拒绝准则。
明确
```
run_if
```
条件，仅按依赖顺序执行必要的专业Skill。
将专业成果物整合至Implementation Spec或对应mode的主成果物中，确认标准所有者无重复。
仅当
```
mode == implementation && mutation_authorized
```
时，以小型可逆步骤进行实现。
独立于实现者的说明，针对所需平台分别验证test、analysis、可追踪性、failure、变更场景。
分别返回artifact readiness、主题判定结果、工程状态、发布状态、人工验收情况。
在reproduction-test中，对比fresh context下的运行结果是否通过相同关卡。

Platform Compatibility

共通problem、requirement、contract、test oracleを維持し、shellやphysical pathだけをplatform adapterへ分ける。
Windows、Linux、macOSのうち複数がrequiredなら、各platformの実行結果を独立Evidenceとして保持する。
一部を実行できない場合は
```
unexecuted_validation
```
と
```
platform_validation.parity_result: incomplete
```
を返し、required platform全体をverifiedとしない。

保持通用problem、requirement、contract、test oracle一致，仅将shell与物理路径交由platform adapter处理。
若需支持Windows、Linux、macOS中的多个平台，需将各平台的执行结果作为独立Evidence保存。
若部分平台无法执行，需返回
```
unexecuted_validation
```
与
```
platform_validation.parity_result: incomplete
```
，不得将整个required平台标记为已验证。

Hard Gates

以下のいずれかに該当する場合はimplementationまたはrelease判定へ進まず、現在modeで安全に返せるartifactと不足事項を返す。

単一成果物の依頼をrouterへ過剰routingしている。
Coreの往復trace、Requirement Catalog、rejection criteriaがないまま専門Skillまたは実装へ進んでいる。
Function schemaを埋めただけで、目的・要件・Evidenceから固有判断への因果を検証していない。
```
reversibility: unknown
```
または未解決Selection Gateに依存する実装を進めている。
Function packageから
```
run_if
```
、stable ID、Evidence、applicability、condition別authority、coverage、subject verdictを落としている。
domain discoveryがapplicableなのに、termのactor / purpose / rule / Evidence、canonical term / context / translation / relationship ID、reference integrity、relationshipごとのfailure semantics、unknownの確認方法・影響をfree textや改名fieldへ圧縮している。
上流Skillに未作成の後続IDを作らせている。
peer / router間で再routingまたはping-pongが起きている。
mode外mutation、無承認の公開契約・data meaning・不可逆変更を行っている。
design planと実行成功、artifact readinessと対象systemの良否、engineeringとreleaseを混同している。

若符合以下任一情况，不得推进至implementation或发布判定，需返回当前mode下安全的成果物及缺失事项：

将单一成果物的请求过度路由至本router。
未完成Core的往返追踪、Requirement Catalog、拒绝准则，即直接调用专业Skill或进行实现。
仅填充Function schema，未验证从目标、需求、Evidence到具体决策的因果关系。
推进依赖
```
reversibility: unknown
```
或未解决Selection Gate的实现。
遗漏Function package中的
```
run_if
```
、stable ID、Evidence、适用性、分场景权威性、覆盖范围、主题判定结果。
当domain discovery适用时，将术语的actor / purpose / rule / Evidence、标准术语/上下文/翻译/关系ID、引用完整性、各关系的failure语义、未知项的确认方法与影响压缩至自由文本或重命名字段中。
让上游Skill生成未创建的后续ID。
出现peer / router间的二次路由或来回推诿情况。
进行mode外的修改、未批准的公开契约/data meaning变更、不可逆变更。
混淆设计计划与执行成功、artifact readiness与目标系统状态、工程状态与发布状态。

Completion

Core、Requirement Catalog、必要な専門成果物、Verificationのgate結果がある。
各専門Skillの
```
run_if
```
と固有packageが同じ成果物内で解決し、固有hard gateをrouterの要約が迂回していない。
applicableなChange Safety、Platform Context / Validation、causal chain、Selection Gateが最終成果物へlosslessに残る。
applicableなdomain discoveryのterm、ambiguous meaning、translation、relationship参照がcanonical fieldのまま解決し、reference integrityがpassする。
modeごとの主成果物が一つあり、Problem Frame、Evidence付きpremise / unknown、AI restatementと、全requirementのpurpose、model、contract、boundary、change、testへの必要範囲のtraceを保持する。
invalid state、failure、retry、migration、代表変更の必要経路を検証する。
required platformごとのtest / build / analysis結果とcontract parity判定がある。
mode外の書換え、scope外cleanup、将来用abstractionを行わない。
未実行検証、unknown、contradiction、residual risk、human approvalを隠さない。
現在modeのstatus、次phaseの可否、release statusを分ける。

具备Core、Requirement Catalog、必要的专业成果物、Verification的关卡结果。
各专业Skill的
```
run_if
```
条件与专属package在同一成果物内得到解决，router的总结未绕过专属hard gate。
适用的Change Safety、Platform Context / Validation、因果链、Selection Gate无损保留在最终成果物中。
适用的domain discovery术语、模糊含义、翻译、关系引用以标准字段形式得到解决，引用完整性验证通过。
具备对应mode的单一主成果物，且保留Problem Frame、带Evidence的前提/未知项、AI restatement，以及所有需求到purpose、model、contract、boundary、change、test的必要追踪内容。
验证无效状态、failure、重试、迁移、典型变更的必要路径。
具备各required平台的test / build / analysis结果及contract parity判定。
不进行mode外的改写、范围外的清理、面向未来的抽象设计。
不隐藏未执行的验证、未知项、矛盾点、残留风险、人工审批需求。
区分当前mode的状态、下一阶段的可行性、发布状态。