القائمة
Use when changing retikz contract layer code, XxxDefinition types, defineXxx helpers, DefinitionInput/AnyDefinition types, registry discriminators, extension contracts, author-facing capability APIs, or definition context naming.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when changing any retikz apps/docs content, route data, i18n, demo, SourceLinks, or schema reference before loading the matching page-type skill.
Use when retikz needs multiple independent LLMs to review the same fixed code, ADR, implementation plan, test contract, commit, or working-tree snapshot before a gate or delivery decision.
Use when an Alpha ADR needs a pre-implementation capability gate, or a Beta milestone needs code-based completeness and package-boundary auditing.
Use when planning a retikz architecture direction, version roadmap, or alpha feature that may need a long-lived ADR before implementation.
Use when retikz work is primarily refactoring, reorganization, renaming cleanup, modularization, or internal simplification and should start from a reviewed implementation plan before code changes.
Use when retikz implementation, adversarial testing, and docs are complete, and an ADR or beta TODO needs changelog, contract consistency review, roadmap status updates, or final human acknowledgement.
| name | standard-contract |
| description | Use when changing retikz contract layer code, XxxDefinition types, defineXxx helpers, DefinitionInput/AnyDefinition types, registry discriminators, extension contracts, author-facing capability APIs, or definition context naming. |
contract/ 是能力契约层：声明第三方作者和内置 provider 共同实现的抽象能力。它可以依赖 shared 和 schemas，不依赖具体 provider、pipeline 或 compile 实现。
XxxDefinition、必要的 XxxDefinitionInput、AnyXxxDefinition。defineXxx()。XxxResolveContext、XxxEmitContext、XxxCompileContext 等。不放内置 definition、registry 合并 / 诊断、pipeline / compile 状态或 IR schema 本身。
| 形态 | 规则 |
|---|---|
contract/<capability>/types.ts | definition、input、context、抽象协议类型 |
contract/<capability>/define.ts | defineXxx() 和必要的作者侧规范化 |
contract/<capability>/index.ts | barrel 导出 |
XxxDefinition | registry 存储和消费的能力契约，不代表 IR 节点 |
XxxDefinitionInput | 仅当作者侧输入不同于存储契约时使用 |
AnyXxxDefinition | 擦除泛型后的异构 definition，不表示任意 JSON |
defineXxx() 即使暂时只是 typed identity，也保留为稳定 contract hook；不要写成 @todo。
type：顶层领域实体或 plot 主判别。kind：能力内部子变体或操作变体。name：命名 provider，如 shape / boundary / arrow / pattern / path generator。同一能力内只选一个 key 字段；definition、schema、provider map、extract helper 和错误信息都跟它对齐。
@description 写主语义、生命周期、跨字段规则、回调协议或 registry 消费契约。@remarks 只写设计理由、typed identity / future hook 这类非主路径补充。@default，tag 值直接写标识符或字面量，不加 Markdown 反引号。shared / schemas？