create-yss-spec 3.5.5 → 3.5.8

package/template/.codex/skills/yss-formily-schema-generator/SKILL.md

@@ -3,187 +3,43 @@ name: yss-formily-schema-generator
 description: "从需求或设计图生成 YFormily JSON Schema 与表单代码；仅用于生产表单实现。"
 ---
 
-# YFormily Schema Generator
+# YFormily Schema 生成
 
-Use this skill to turn upstream input into downstream YFormily form artifacts.
+将文字需求、产品 / UX 说明、截图、本地图片或 Figma 设计输入转成生产表单的 `JSON Schema` / `ISchema`、推荐 model，以及按需的 scope、effects、插槽和 Vue 渲染示例。本技能设计 schema；精确组件行为由 [YFormily 路由](../yss-formily/SKILL.md)及实际命中的基础、联动、模式和分步专项决定。
 
-Supported input forms:
+## 触发与必要输入
 
-- user text descriptions
-- product or UX requirements
-- screenshots and local images
-- Figma links or node-based design references
+用户要求根据需求、原型图、截图、Figma 或业务字段生成 YFormily schema / 渲染代码时使用。这里将已提供的设计转为生产表单，不生成产品原型。
 
-Expected output forms:
+确认表单用途、目标模式（查询 / 新增 / 编辑 / 查看 / 混合）、允许输出范围和可读上游输入。正式生产实现继续消费当前批准的 Slice Implementation Contract；本技能输出不授予实现或批准资格。字段语义、校验和接口模型以已确认需求与冻结合同为准，目标组件事实以工程版本、类型和真实导出为准。
 
-- a YFormily JSON Schema or `ISchema`
-- a recommended `v-model` data shape
-- optional `scope`, `effects`, and slot plan
-- optional Vue render snippet showing how to mount `YFormily`
+转换字段、布局、校验、联动或插槽时，读取 [转换工作流](references/workflow.md)相应部分；不要求为了单一字段调整读取全部样例。
 
-This skill designs the schema.
-For implementation rules and exact YFormily behavior, also read:
+## 按输入选择方法
 
-- [yss-formily](../yss-formily/SKILL.md)
+| 输入 | 提取内容 | 不能从输入补造的内容 |
+|---|---|---|
+| 文字需求 | 用途、模式、分组、字段、必填规则、字典、联动和动作区 | 缺失的后端字典、阈值、权限和业务承诺 |
+| 截图 / 图片 | 区域、标签、控件、按钮、必填标记与可见依赖；先区分 placeholder 和标签 | 隐藏校验、异步规则、唯一性或服务端行为。只有视觉线索时输出 schema 骨架并标明不确定项 |
+| Figma 链接 / 节点 | 先发现可用设计读取能力，再提取语义标签、控件、分组、helper、必填提示、只读模式和底部动作 | 不猜工具名称或声称读取成功；能力缺失时使用已有导出 / 截图，仍不足以确认必要细节时报告访问缺口 |
 
-For conversion workflow and field mapping, read:
+按“业务意图 → 字段语义 → 已确认的校验与依赖 → 布局分组 → schema”转换，不机械照搬像素或设计图层名。合理默认只用于明确标注的控件与布局建议；业务规则缺口保持未确认。
 
-- [references/workflow.md](references/workflow.md)
+## Schema 与默认选择
 
-## Activation rules
+- 新代码使用 `YFormily`；历史 `YssFormily` 只在当前已安装兼容导出得到确认时使用。
+- 布局为 `FormLayout -> FormGrid -> 字段`，普通字段使用 `FormItem`；新建 / 编辑 / 查看可共用 schema 时优先复用。
+- 查看态按 `mode=2` 与必要的 `detail-*` 插槽处理；富输入使用 `Slot`。不依赖 React Formily UI 包，底层行为按安装的 Ant Design Vue。
+- 字段 key 稳定且有业务含义，分组反映领域语义；清楚区分已确认的必填 / 可选、联动 / 只读与待确认项，不臆造字典或隐藏异步校验。
+- 不因视觉有分组就将所有字段压平。无法推断的业务规则留在假设 / 未决项中，不转换成已确认校验。
 
-Use this skill when the request is any of the following:
+未提供其他选择时，可建议：文本 `Input`，长说明 `Input.TextArea`，布尔 `Switch`，单选 `Select` / `Radio.Group`，日期 `DatePicker`，分组 `GroupHeader`。纯 Formily 提交的底部动作可用 `AutoButtonGroup`；业务列表查询区按 `formily-foundation` 使用外部 YButton 查询 / 重置。默认建议以保守、可解释为准，不能覆盖已有代码或用户输入。
 
-- “根据需求描述生成表单 schema”
-- “根据原型图生成 YFormily”
-- “根据图片/截图还原表单”
-- “根据 Figma 生成表单 JSON Schema”
-- “把业务字段整理成 YFormily schema”
-- “输出 schema 和渲染代码”
+## 执行与输出
 
-## Core principle
+1. 确认输入来源、业务用途与模式，规范化字段列表。
+2. 选择字段类型、控件、分组和跨度，提取已确认的校验、enum 与联动；对不确定推断保留来源和假设。
+3. 生成 schema 与 model，按实际命中的 Formily 专项校验；请求代码时再生成必要的 scope、effects、插槽计划和 Vue 挂载示例。
+4. 核对稳定字段、业务分组、必填 / 可选、只读 / 联动与上游输入一致。冲突或必要细节不可读时保留缺口，回交原所有者，不能写成已确认结果。
 
-Do not mirror the visual surface blindly.
-Translate the input into a stable form model:
-
-1. business intent
-2. field semantics
-3. validation and dependency rules
-4. layout grouping
-5. YFormily schema
-
-The schema must reflect business meaning, not just pixel arrangement.
-
-## Input-specific workflow
-
-### Text requirement
-
-Extract, in order:
-
-1. form purpose
-2. mode: query, create, edit, detail, mixed
-3. sections or groups
-4. fields
-5. required rules
-6. options or dictionaries
-7. linkage rules
-8. submit and action area
-
-If some details are missing, make reasonable defaults and state the assumptions.
-
-### Screenshot or image
-
-Treat image understanding as approximate.
-First identify:
-
-- section boundaries
-- labels
-- control types
-- action buttons
-- required markers
-- visible dependency hints
-
-Infer likely field types from UI controls, but do not overclaim hidden business rules from appearance alone.
-If the image contains only visual cues and no validation semantics, generate a schema skeleton and explicitly mark uncertain fields.
-
-### Figma input
-
-When a Figma link or node is provided, discover an available design-inspection capability first. If unavailable, use supplied design exports or screenshots; report the missing access when those cannot establish a required detail. Do not invent a tool name or claim inspection succeeded.
-Extract:
-
-- field labels
-- control kinds
-- layout groups
-- helper text
-- required indicators
-- readonly versus editable patterns
-- footer actions
-
-Then convert that structure to YFormily, following local YSS conventions instead of raw design-tool naming.
-
-## Required outputs
-
-Unless the user asks for less, produce these artifacts:
-
-1. schema
-2. model shape
-3. assumptions
-4. open questions only if they block correctness
-
-If the user asks for code generation, also produce:
-
-5. `scope` plan
-6. `effects` plan if needed
-7. Vue usage snippet
-
-## Schema design rules
-
-Always align with `yss-formily`:
-
-- wrapper component for new code is `YFormily`; the historical `YssFormily` alias is accepted only when an existing installed export is verified
-- schema is `FormLayout -> FormGrid -> fields`
-- use `FormItem` for ordinary fields
-- prefer one shared schema for create/edit/detail when feasible
-- for detail rendering, plan `mode=2` and `detail-*` slots where needed
-- rich custom input uses `Slot`
-
-Do not emit schema that depends on React Formily UI packages.
-Treat Ant Design Vue semantics as the underlying component behavior.
-
-## Output quality bar
-
-A good generated schema should:
-
-- have stable field keys
-- use domain-oriented group names
-- distinguish required from optional fields
-- choose plausible component types
-- reflect obvious linkage and readonly behavior
-- leave non-inferable business rules as assumptions instead of hallucinating them
-
-## Generation sequence
-
-Follow this sequence every time:
-
-1. Classify the input source.
-2. Extract business structure.
-3. Normalize field list.
-4. Decide field types and components.
-5. Decide sections and layout spans.
-6. Identify validation, enum, and linkage requirements.
-7. Produce YFormily schema.
-8. Produce render snippet if requested.
-9. Call out assumptions and uncertain inferences.
-
-## When the input is incomplete
-
-Use these defaults unless the existing code or user input says otherwise:
-
-- text fields -> `Input`
-- long description -> `Input.TextArea`
-- boolean toggle -> `Switch`
-- single choice -> `Select` or `Radio.Group`
-- date -> `DatePicker`
-- grouped sections -> `GroupHeader`
-- footer buttons -> `AutoButtonGroup`
-
-Prefer conservative defaults over speculative complexity.
-
-## Do not do these things
-
-- Do not invent backend dictionaries that were never described.
-- Do not infer hidden async validation from visuals alone.
-- Do not flatten all fields into one group if the input clearly has sections.
-- Do not produce only a screenshot-level description when the user asked for schema.
-- Do not skip assumptions when confidence is low.
-
-## Recommended final structure
-
-When delivering a full conversion, prefer this output order:
-
-1. brief understanding
-2. assumptions
-3. field model
-4. schema
-5. optional render snippet
-6. optional next-step questions
+除非用户要求更少，返回简短理解、假设、字段 model、schema，以及真正阻断正确性的未决问题。请求代码时追加 scope 计划、必要的 effects 计划和 Vue 示例；不只描述截图，也不在低置信度时省略假设。

package/template/.codex/skills/yss-formily-schema-generator/references/workflow.md

@@ -1,160 +1,41 @@
-# YssFormily Schema Conversion Workflow
+# YFormily Schema 转换工作流
 
-This reference is for converting text, images, and Figma designs into YssFormily artifacts.
+从文字、图片或 Figma 转换表单时，按当前输入读取相关部分。先由 [YFormily 场景路由](../../yss-formily/SKILL.md)选择必要专项；精确 API、三层布局、提交和错误处理仍由已安装的 `formily-foundation` 决定，联动、详情与分步由实际命中的原专项决定。
 
-## 1. Normalize the request
+公开技能包提供本工作流和所链接的公共路由、组件资料，不附带 `formily-foundation`、`formily-linkage-effects`、`formily-mode-slot-detail` 或 `formily-step-flow`。本地已安装时，原专项仍是对应规则的唯一所有者；公共路由和部分 Demo 不替代专项规范。必要专项缺失或不可读时，停止受影响的生产 schema / 渲染实现，报告缺失 Skill 与来源；从消费工程已登记的技能来源恢复，核验版本与项目基线一致并重新读取后再继续。
 
-Classify the target form first:
+## 确认用途与字段模型
 
-| Form type | Signals |
-| --- | --- |
-| 查询表单 | 筛选、搜索、重置、查询、导出 |
-| 新增表单 | 新建、创建、录入、保存 |
-| 编辑表单 | 编辑、更新、修改 |
-| 详情表单 | 查看、详情、只读、描述列表 |
-| 复合表单 | 同页同时支持新增/编辑/查看 |
+先确认目标是查询、新增、编辑、详情还是复合表单，以及输出是 schema、schema + 渲染示例，还是 schema + model + scope/effects 计划。
 
-Then decide the expected output:
+| 字段信息 | 要确认的含义 |
+|---|---|
+| key / title / type | 稳定业务字段名、显示标签与业务数据类型 |
+| component / required | 控件和已确认的必填规则 |
+| group / span | 分组位置与布局宽度 |
+| enum source / linkage | 静态或远程来源、依赖及影响的字段 |
+| custom render | 编辑 Slot 或 detail slot 的需要 |
 
-- schema only
-- schema + render snippet
-- schema + data model + scope/effects plan
+没有显式 key 时建议稳定业务名称，不使用 `input1`、`selectA`、`fieldLeft`。建议不替代冻结 DTO 和统一业务词汇。
 
-## 2. Extract a field table
+## 控件、分组与跨度
 
-Before writing schema, create a mental table with:
-
-| Item | Meaning |
-| --- | --- |
-| key | stable field name |
-| title | display label |
-| type | business data type |
-| component | YssFormily component |
-| required | whether mandatory |
-| group | section placement |
-| span | layout width |
-| enum source | static or remote |
-| linkage | depends on or affects other fields |
-| custom render | slot/detail slot needed or not |
-
-If a field key is not explicit, generate a stable domain name.
-Avoid UI-only names such as `input1`, `selectA`, `fieldLeft`.
-
-## 3. Component mapping heuristics
-
-Use these defaults:
-
-| Input clue | Preferred YssFormily component |
-| --- | --- |
-| 单行文本 | `Input` |
-| 多行说明 | `Input.TextArea` |
-| 单选下拉 | `Select` |
-| 单选按钮 | `Radio.Group` |
+| 输入线索 | 默认建议 |
+|---|---|
+| 单行 / 多行文本 | `Input` / `Input.TextArea` |
+| 单选下拉 / 单选按钮 | `Select` / `Radio.Group` |
 | 开关 | `Switch` |
-| 日期 | `DatePicker` |
-| 日期区间 | `DatePicker.RangePicker` |
+| 日期 / 日期区间 | `DatePicker` / `DatePicker.RangePicker` |
 | 数值 | `InputNumber` |
-| 多选标签 | `Select` with multiple mode |
-| 文件上传 | `Upload` |
+| 多选标签 | `Select` 多选模式 |
+| 上传 | `Upload` |
 | 可重复行 | `ArrayItems` |
 
-If the UI is clearly custom:
-
-- use `Slot` for edit mode
-- use `detail-*` slot for detail mode
-
-Typical custom cases:
-
-- SQL editor
-- code editor
-- rich text
-- complex helper panel
-- embedded table or tree selector
-
-## 4. Layout mapping heuristics
-
-Convert visual grouping to YssFormily structure:
-
-- page-level layout -> `FormLayout`
-- grid rows and columns -> `FormGrid`
-- section title -> `GroupHeader`
-- footer actions -> `AutoButtonGroup`
-
-Use `gridSpan` when:
-
-- field is visually full width
-- long text area spans across columns
-- custom editor needs horizontal space
-
-Conservative defaults:
-
-- ordinary field: `gridSpan: 1`
-- medium-wide field: `gridSpan: 2`
-- editor-like block: `gridSpan: 3` if page is wide enough
-
-## 5. Validation extraction
-
-Confidence levels:
-
-- high confidence:
-  required star, obvious numeric/date constraints, explicit helper text
-- medium confidence:
-  common business conventions such as name required, code length hint
-- low confidence:
-  hidden uniqueness checks, server-side validation, cross-form constraints
-
-Only encode low-confidence validation if the user explicitly described it.
-
-## 6. Linkage extraction
-
-Map visible interactions into one of these:
-
-| Situation | Mechanism |
-| --- | --- |
-| 简单显隐 | `x-visible` |
-| 简单禁用 | `x-disabled` |
-| 单字段依赖更新 | `x-reactions` |
-| 调接口更新选项 | `scope` handler |
-| 多字段协同或提交兜底 | `effects` |
-
-Examples:
+SQL、代码、富文本、复杂辅助区或嵌入表格 / 树选择器等自定义输入，编辑态用 `Slot`，查看态用 `detail-*` 插槽。实际是否可用仍核验目标版本与当前 schema 注册组件。
 
-- “选择数据源类型后才显示 JDBC 配置” -> `x-visible`
-- “切换开关后禁用描述字段” -> `x-disabled`
-- “选择省份后重置城市并更新选项” -> `x-reactions`
-- “输入编码后查重” -> `scope` or async validator
-- “提交失败统一 toast” -> `effects`
+页面布局映射为 `FormLayout`、栅格为 `FormGrid`、分组标题为 `GroupHeader`。纯表单底部动作可用 `AutoButtonGroup`；业务列表查询区按下一节单独处理。横向表单显式设置 `labelWidth` 与 `labelAlign: 'right'`，栅格保持响应式。
 
-## 7. Output template
-
-Preferred answer skeleton:
-
-```md
-理解
-
-假设
-
-字段模型
-
-```ts
-// schema
-...
-```
-
-```ts
-// initial model shape
-...
-```
-
-```vue
-<!-- optional render snippet -->
-...
-```
-```
-
-## 8. Schema skeleton
-
-Use this as the default starting point:
+普通字段可建议 `gridSpan: 1`，较宽字段为 `2`，宽屏编辑器可为 `3`；长文本、满宽字段和自定义编辑器的跨度必须与实际栅格列数及窄屏行为匹配，不能只复制示例数字。
 
 ```ts
 const schema: ISchema = {
@@ -163,14 +44,12 @@ const schema: ISchema = {
     layout: {
       type: 'void',
       'x-component': 'FormLayout',
-      'x-component-props': {
-        layout: 'horizontal',
-        labelWidth: 120,
-      },
+      'x-component-props': { layout: 'horizontal', labelWidth: 120, labelAlign: 'right' },
       properties: {
         grid: {
           type: 'void',
           'x-component': 'FormGrid',
+          'x-component-props': { maxColumns: 2, minColumns: 1, minWidth: 320 },
           properties: {},
         },
       },
@@ -179,62 +58,39 @@ const schema: ISchema = {
 };
 ```
 
-## 9. Query form special handling
-
-When the form is clearly a search form:
-
-- keep fields compact
-- avoid excessive required rules
-- place actions in `AutoButtonGroup`
-- include `Submit` and `Reset`
-- prefer light linkage over complex `effects`
+示例数字仅为起点，不决定目标页面的字段、列数或业务规则。
 
-Typical query output includes:
+## 查询与详情的分支
 
-- schema
-- initial filter model
-- submit/reset handlers through `scope`
+业务查询表单保持紧凑，保留已确认的必填规则，不因常见习惯新增必填。YFormily 渲染字段，外部 YButton 查询 / 重置由 Hook 的 `handleSearch/handleReset` 维护同一参数源、回第一页并执行请求。动作区按 [业务页面查询区规则](../../yss-ui-business-page-generation/SKILL.md)核对，基础表单约束仍由已加载的 `formily-foundation` 决定；不将 schema 内 `AutoButtonGroup + Submit/Reset` 当作 CRUD 查询区默认方案。
 
-## 10. Detail form special handling
+查询输出包含 schema、初始筛选 model 和查询 / 重置处理计划。单纯 Formily 表单提交仍可按基础规范使用 schema 内按钮组。
 
-If the target is read-only or mixed add/edit/detail:
+详情或新增 / 编辑 / 查看复合表单确认 mode，不只生成可编辑控件。默认描述列表足够时不另造渲染；富格式、数组标签、代码或富文本查看器需要自定义 detail slot 时，按 [模式与插槽路由](../../yss-formily/SKILL.md)加载已安装的 `formily-mode-slot-detail`，由原专项确定规范。
 
-- plan `mode`
-- check whether detail mode needs custom slots
-- do not generate editable controls only
-- leverage default descriptions rendering when enough
+## 校验与联动的依据
 
-Use custom detail slots only when:
+| 线索 | 如何处理 |
+|---|---|
+| 明确必填标记、数值 / 日期约束或 helper 文本 | 对照需求确认含义后编码 |
+| 常见业务习惯、名称必填或长度暗示 | 保留建议与待确认项，不仅凭习惯把规则写入 schema |
+| 隐藏唯一性、服务端或跨表校验 | 只有用户 / 权威需求已明确描述时编码 |
 
-- value needs rich formatting
-- arrays should render tags
-- code or rich text should render in a viewer
-
-## 11. Figma-specific notes
-
-When converting from Figma:
-
-- extract semantic labels, not layer IDs
-- ignore purely decorative layers
-- map helper text and required marks into schema rules
-- convert footer buttons into action area, not ordinary fields
-- infer full-width editors from large framed regions
-
-Do not preserve design-only names such as:
+| 当前任务 | 首选机制 |
+|---|---|
+| 简单显隐 / 禁用 | `x-visible` / `x-disabled` 表达式 |
+| 单字段依赖更新 | `x-reactions` |
+| 调接口更新选项或跨字段事件 | `scope` |
+| 表单级多字段协同 | `effects` |
 
-- `Frame 123`
-- `Input / Default`
-- `Group 14`
+例如数据源类型控制 JDBC 配置显示、开关控制字段禁用、省份控制城市选项与失效旧值，都需要确认字段路径和实际依赖。编码查重仅在已确认需求存在时实现。客户端提交校验失败反馈使用 `onFormSubmitValidateFailed`；API reject 仍由 mutator 统一提示，不能把“提交失败统一 toast”机械映射到通用 effects 失败回调。复杂或异步联动按 [联动场景路由](../../yss-formily/SKILL.md)加载已安装的 `formily-linkage-effects`，由原专项处理初始化、合法回填、竞态和卸载。
 
-Translate them into domain names and stable field keys.
+## Figma 与图片检查
 
-## 12. Image-specific notes
+Figma 读取语义标签，不沿用 `Frame 123`、`Input / Default`、`Group 14` 等设计图层名；忽略纯装饰层，把 helper 与必填提示作为需核对的规则线索。底部按钮转成动作区，宽框编辑器结合实际空间安排满宽。
 
-When converting from screenshots:
+截图先区分 placeholder 与标签，识别 Tab / 分段控制是否意味着条件区，确认大框是自定义编辑器还是 textarea。图像理解是近似的，低置信度时输出可审阅骨架并记录不确定项，不制造精确业务规则。
 
-- distinguish placeholder text from actual label text
-- watch for tabs or segmented controls that imply conditional sections
-- identify whether a box is a custom editor or just a textarea
-- keep uncertain parts in assumptions
+## 输出与自检
 
-If confidence is low, generate a clean schema baseline instead of fake precision.
+按“简短理解 → 假设 → 字段模型 → schema → 按需 model / 渲染示例”组织。JSON / TS 标识保持原样，假设与已确认规则分开。检查字段稳定、分组有业务含义、必填 / 可选和只读 / 联动与输入一致，所需 API 与插槽来自当前版本。只剩真正阻断正确性的未决问题时交回所有者；文档输出不改变原合同状态或批准。

package/template/.codex/skills/yss-frontend-scaffold-generator/SKILL.md

@@ -7,7 +7,7 @@ description: Use when creating a new YSS frontend micro-application from the sta
 
 用于从标准 YSS 前端模板创建 0-1 前端微应用工程。它只在阶段 5 的 `work-unit.implementation-repository-preparation` 中消费生命周期批准、持久化且当前的 Project Scaffold Contract schema v4，执行 `controlled-generation`；不生成业务页面。
 
-## Template Source
+## 模板来源
 
 默认使用随 Skill 分发的 `assets/data-quality-v1/`，从 Data Quality 抽取工作区、主题与微应用模式，重建为通用空骨架。来源、差异、支持范围见 `references/data-quality-baseline.md`；`references/data-quality-v1.manifest.json` 是文件白名单与 SHA-256 依据。
 
@@ -17,22 +17,26 @@ description: Use when creating a new YSS frontend micro-application from the sta
 
 兼容已有 `{ repository, commit }` 合同：只有明确选择外部 Git 模板时传 `--template-checkout` 并核验 origin 与精确 40 位 commit；不再默认从私网浮动分支获取模板。
 
-## Inputs
+## 必要输入
 
 - `app_name`：应用名。
 - `microapp_name`：微应用注册名。
 - `base_route`：基础路由。
 - Project Scaffold Contract schema v4：包含用户确认的仓库 scope、目标路径、`init_git`、模板 manifest 摘要或 Git commit、应用参数、允许写路径和验证命令。
 - OpenAPI Freeze 记录：有 API 影响时提供已批准的冻结 YAML 版本和引用；无 API 影响时提供带原因的 `not-applicable`。
-- OpenAPI JSON 派生记录：`docs/.scratch/<feature>/api/<feature>-json-export.md`，包含 YAML / JSON SHA-256、Redocly CLI 版本和 lockfile 引用。
-- 冻结 JSON 产物：`docs/.scratch/<feature>/api/<feature>.json`；这是唯一允许交给既有前端代码生成流程的上游产物。
+- 有 API 影响时提供 OpenAPI JSON 派生记录：`docs/.scratch/<feature>/api/<feature>-json-export.md`，包含 YAML / JSON SHA-256、Redocly CLI 版本和 lockfile 引用。
+- 有 API 影响时提供冻结 JSON 产物：`docs/.scratch/<feature>/api/<feature>.json`；这是唯一允许交给既有前端代码生成流程的上游产物。无 API 影响时沿用带原因的 `not-applicable`，不生成占位 JSON 或 API client。
 - `target_git_url` 或 `output_dir`：目标实现仓库或本地输出目录。
 - `package_manager`：默认 pnpm。
 - `init_git`：是否初始化 Git；默认必须用户明确确认。
 
-## Workflow
+## 执行与停止条件
 
-采用专职前端 profile 或显式 `frontend_delivery` 绑定时，先按 `.template-spec/process/frontend-backend-delivery.md` 实际核验战略与后端联合交付。缺任一输入只能诊断和回交；输入通过后准备计划/合同，正式实现、生成和恢复仍须当前批准的 Slice Contract 冻结接收摘要。接口或部署版本漂移时重新接收，不复用旧成功输出。
+采用专职前端 profile 或显式 `frontend_delivery` 绑定时：
+
+- 按 `.template-spec/process/frontend-backend-delivery.md` 核验战略与后端联合交付；缺任一输入只能诊断和回交。
+- 输入通过后准备计划 / 合同；正式实现、生成和恢复仍须当前批准的 Slice Contract 冻结接收摘要。
+- 接口或部署版本漂移时重新接收，不复用旧成功输出。
 
 1. 确认当前任务已经通过 Harness 入口分诊、逐项目脚手架决定已由真实用户确认，且 schema v4 合同已由生命周期批准、持久化并保持当前。
 2. 确认目标是外部实现仓库；只有用户明确选择时才输出到 Harness 仓库的 `apps/frontend/<project>/`。`apps/frontend/` 只能作为项目容器，`app/frontend/`、`app/backend/` 及其子路径禁止作为输出位置。`git-submodule` 只能在已初始化且附加分支的子仓工作树生成；空 gitlink、detached HEAD、`--force` 覆盖挂载点不得当成普通目录。
@@ -44,7 +48,7 @@ description: Use when creating a new YSS frontend micro-application from the sta
 8. 企业 registry / 认证由目标环境用户级 npm 配置提供，禁止复制来源 `.npmrc` 或 token。实际执行并记录 `pnpm install --frozen-lockfile`、`pnpm lint:check`、`pnpm type-check`、`pnpm build`、`pnpm build:standalone` 的退出码和日志；缺失脚本只能由批准的工程基线提供替代命令。任何必需命令失败都阻断。
 9. 按 `.template-spec/templates/implementation-repo-registry-template.md` 回写前端实现仓库登记。
 
-## Expected Template Shape
+## 生成目录形态
 
 ```text
 DESIGN.md
@@ -60,7 +64,7 @@ package.json
 packages/package.json
 ```
 
-## Boundaries
+## 授权与技术边界
 
 - 不直接创建远端 Git 项目，除非用户明确要求。
 - 不保留模板 `.git` 或模板 remote；不在未获确认时执行 `git init`。
@@ -73,13 +77,13 @@ packages/package.json
 - 不把模板示例页面当作业务功能交付。
 - 生成后仍需使用 `yss-ui`、`yss-ui-business-page-generation`、`yss-api-integration` 以及实际命中的表格、树、Formily 等专项 skill 实现业务页面。
 
-## Output
+## 输出与证据
 
 - 前端工程生成位置或目标仓库信息。
 - 模板 baseline / manifest 摘要，或 Git repository / commit 证据。
 - 替换参数清单。
 - install / lint / type-check / build 命令，以及目标前端项目既有的手动客户端生成命令（如有）。
-- OpenAPI Freeze 记录、OpenAPI JSON 派生记录、JSON SHA-256 和 `openapi/openapi.json` 物化证据。
+- 有 API 影响时提供 OpenAPI Freeze 记录、OpenAPI JSON 派生记录、JSON SHA-256 和 `openapi/openapi.json` 物化证据；无 API 影响时提供带原因的 `not-applicable`。
 - Harness 实现仓库登记草案。
 - `.yss/scaffold-generation.json` Manifest v4 与 `scaffold-verification.json`。
 - 未覆盖项和 `TODO-HUMAN-REVIEW`。

package/template/.codex/skills/yss-implementation-contract-compiler/SKILL.md

@@ -11,11 +11,7 @@ Slice v3 的当前执行结果须按 `references/yss-skill-execution-result.md`
 
 阶段 7 的实现合同编译器。它把已批准的生命周期资产、垂直切片、capability 和窄 Recipe 编译为 `Slice Implementation Contract` v3 草案；不批准合同、不写业务代码、不设置 `ready-for-agent`。
 
-文档输出时按 `lifecycle-document-output` 条件调用 `i-have-adhd`，读取 `.template-spec/process/document-writing.md`；作用域仅限当前产物，派发时传递条件及引用。
-
-## 文档写作
-
-撰写实现合同的解释正文和切片交接说明前，读取 `.template-spec/process/document-writing.md` 的共用写法及工程契约 / Ticket 指引；不改变结构化合同、批准状态或就绪条件。
+撰写实现合同解释正文或切片交接说明时，按 `lifecycle-document-output` 条件调用 `i-have-adhd`，读取 `.template-spec/process/document-writing.md` 的共用写法及工程契约 / Ticket 指引。作用域仅限当前产物；派发时传递条件及引用，不改变结构化合同、批准状态或就绪条件。
 
 ## 输入
 
@@ -41,7 +37,7 @@ Slice v3 的当前执行结果须按 `references/yss-skill-execution-result.md`
 采用专职前端 profile 或显式 `frontend_delivery` 绑定时，先按 `.template-spec/process/frontend-backend-delivery.md` 实际核验战略与后端联合交付。缺任一输入只能诊断和回交；输入通过后准备计划/合同，正式实现、生成和恢复仍须当前批准的 Slice Contract 冻结接收摘要。接口或部署版本漂移时重新接收，不复用旧成功输出。
 
 - 编译器不得输出 `approved`、`ready-for-agent` 或 `completed`。
-- Registry 和编译规则保持 schema v2；新 Slice 使用 v3，v2 按原规则读取和显式迁移。schema v1 一律拒绝，不自动升级，不提供旧技能名兼容。
+- Registry 使用其权威 schema v3，编译规则保持 schema v2；新 Slice 使用 v3，旧 Slice v2 按原规则读取和显式迁移。已停止支持的 schema 一律拒绝，不自动升级，不提供未登记的旧技能名兼容。
 - `required_capabilities` 与 `required_skills` 必须同时冻结；Registry 或编译器摘要变化后合同立即 `stale`，重新编译后仍须交生命周期重新批准。
 - UI 影响按来源分支核验：新设计保持正式原型确认与 Visual Baseline；无 UI 改动才允许 `existing-ui-baseline` v1，并须当前真实基线确认及 `case_id`。任一来源缺少当前批准或摘要绑定时，不得路由页面实现。模型必须先读 manifest 与语义引用，再查看对应 PNG；禁止目录 glob 和图片独立猜义。
 - Repository/数据模型影响缺少数据架构时，不得路由持久化实现。

package/template/.codex/skills/yss-implementation-contract-compiler/references/yss-skill-execution-result.md

@@ -4,9 +4,13 @@
 
 后端结果顶层带与当前 resolution 完全一致的 `architecture_identity`；每条验证记录还须有整数 `exit_code`。身份缺失、Profile 未 supported、验证非零或没有执行时间均不得 accepted。
 
+以下为当前 Slice v3 的填写结构。后端身份复制当前 resolution；`project_root`、`dependency_roots` 仅按跨仓及来源解析合同填写。历史 Slice v2 使用末节所述兼容路径，不能把此示例当作自动迁移指令。
+
 ```yaml
 execution_result:
   schema_version: 2
+  evidence_binding_version: 1
+  architecture_identity: # 后端必须与当前 resolution 完全一致；其他工作单元按原合同
   skill:
   slice_id:
   work_unit_id:
@@ -15,6 +19,7 @@ execution_result:
     contract_ref:
     contract_id:
     contract_version:
+    contract_digest: # 已批准 Slice 文件原始字节 SHA-256
     registry_digest:
     compiler_contract_digest:
     component_bindings_digest: # 合同含 component_bindings 时必填
@@ -25,10 +30,19 @@ execution_result:
       contract_area: common | frontend | backend | contract | cross_repo
   evidence_files:
     - path:
+      digest: # 证据文件原始字节 SHA-256
       evidence_type: code | test | generated | review | verification
       behavior_ref:
+  source_bindings:
+    - path:
+      digest: # 实际消费的来源原始字节 SHA-256；删除使用 deleted: true, digest: null
   verification_results:
-    - command:
+    - verification_id:
+      acceptance_refs: [] # 对应验证项的完整稳定验收 ID
+      evidence_refs: [] # 覆盖全部关联验收及预期文件
+      command:
+      cwd:
+      exit_code: # 实际整数退出码
       result:
       executed_at:
   constraint_results:

package/template/.codex/skills/yss-layered-mvc-scaffold-generator/SKILL.md

@@ -43,7 +43,7 @@ description: 在生命周期已批准的脚手架合同下生成通用 YSS 分
 
 ## 执行
 
-优先使用一键入口：
+优先使用一键入口。以下命令从 Skill 根目录执行；坐标、平台及合同参数消费当前批准输入，示例不授予生成或覆盖权限：
 
 ```bash
 node scripts/generate_and_verify_scaffold.mjs \