create-yss-spec 2.2.0 → 2.2.2

package/template/.trae/skills/yss-formily/references/examples.md

@@ -1,65 +0,0 @@
-# YssFormily 示例索引
-
-这个文件不重复解释 Formily 概念，只负责把常见场景映射到仓库里的权威文档和 demo。
-
-## 先看哪里
-
-1. 组件总文档  
-   [`${base_project}/.trae/skills/yss-ui/assets/docs/components/formily.md`](${base_project}/.trae/skills/yss-ui/assets/docs/components/formily.md)
-2. 对应 demo  
-   `${base_project}/.trae/skills/yss-ui/assets/demos/formily/*.vue`
-
-## 场景到 demo 的映射
-
-| 场景               | 先看 demo                                                                                               | 备注                     |
-| ------------------ | ------------------------------------------------------------------------------------------------------- | ------------------------ |
-| 基础 schema 表单   | [`basic.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/basic.vue)                       | 最小可用骨架             |
-| 标签布局/对齐      | [`align.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/align.vue)                       | `FormLayout` 用法        |
-| 栅格布局           | [`grid.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/grid.vue)                         | `FormGrid` 与 `gridSpan` |
-| 动态显隐           | [`dynamic.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/dynamic.vue)                   | `x-visible`              |
-| 动态禁用           | [`disabled.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/disabled.vue)                 | `x-disabled`             |
-| 标签提示           | [`label-tip.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/label-tip.vue)               | `tooltip`                |
-| 自定义插槽         | [`slot.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/slot.vue)                         | `Slot` 组件              |
-| 分组               | [`group.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/group.vue)                       | `GroupHeader` 与详情插槽 |
-| 折叠表单           | [`collapse.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/collapse.vue)                 | 分区折叠                 |
-| 普通联动           | [`linkage.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/linkage.vue)                   | 字段依赖                 |
-| 新增/编辑/查看三态 | [`modes.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/modes.vue)                       | `mode` 与详情视图        |
-| 远程字典翻译       | [`remote-enum.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/remote-enum.vue)           | 远程选项与展示           |
-| 自定义业务组件     | [`custom-component.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/custom-component.vue) | `components` 扩展        |
-| 行内事件           | [`events-inline.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/events-inline.vue)       | 轻量处理                 |
-| scope 事件         | [`events-scope.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/events-scope.vue)         | 可复用逻辑               |
-| effects            | [`effects.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/effects.vue)                   | 表单级副作用             |
-| 异步校验           | [`async-validate.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/async-validate.vue)     | 优先配合 `scope`         |
-| 多依赖联动         | [`linkage-multi.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/linkage-multi.vue)       | `scope + effects`        |
-| 提交失败兜底       | [`submit-failed.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/submit-failed.vue)       | 统一失败提示             |
-| 帮助文案/插槽混合  | [`helper-slot.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/helper-slot.vue)           | 说明区与自定义块         |
-| 分步表单           | [`steps.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/steps.vue)                       | `FormStep`               |
-| 动态数组           | [`dynamic-array.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/dynamic-array.vue)       | `ArrayItems`             |
-
-## 推荐查找顺序
-
-### 做新表单
-
-1. 看 [`basic.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/basic.vue)
-2. 看 [`grid.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/grid.vue)
-3. 需要模式切换时看 [`modes.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/modes.vue)
-
-### 做联动
-
-1. 简单显隐先看 [`dynamic.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/dynamic.vue)
-2. 禁用先看 [`disabled.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/disabled.vue)
-3. 多字段或表单级联动看 [`linkage-multi.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/linkage-multi.vue) 和 [`effects.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/effects.vue)
-
-### 做复杂字段
-
-1. 先看 [`slot.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/slot.vue)
-2. 再看 [`custom-component.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/custom-component.vue)
-3. 有查看态时补看 [`group.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/group.vue) 或 [`modes.vue`](${base_project}/.trae/skills/yss-ui/assets/demos/formily/modes.vue)
-
-## 实操提醒
-
-- 编辑态自定义渲染优先 `Slot`
-- 查看态自定义渲染固定走 `#detail-<path>`
-- 详情列数先确认 `responsive` 是否开启
-- 事件名以底层 Ant Design Vue 组件为准
-- 如果只是不确定写法，不要猜，直接打开对应 demo

package/template/docs/adr/0001-product-design-prototype-entrypoint.md

@@ -1,54 +0,0 @@
-# ADR-0001: 使用 product-design:index 作为产品原型主入口
-
-## 状态
-
-已接受
-
-## 日期
-
-2026-07-06
-
-## 背景
-
-YSS Harness 需要把有 UI 功能的产品原型产出收敛到一个稳定入口，同时保留需求质询、设计系统、Ant Design v6 事实校验、原型评审和用户确认门禁。原有 `product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 容易被理解为并列主入口，导致 Agent 在不同阶段选择不同原型工具，难以保证高保真 HTML 原型、AntD v6 校验证据和用户确认记录一致落地。
-
-## 决策
-
-产品原型产出统一以 `product-design:index` 为主入口。该 skill 只负责路由，实际按 Product Design plugin 规则进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$design-qa` 或 `$share` 等 focused skill。
-
-`grill-with-docs` 保留为前置需求质询和领域边界澄清工具，不承担 HTML 原型产出。`antd` skill / `antd` CLI 作为 Ant Design v6 组件、demo、token、semantic 和 design.md 的事实来源。YSS 生命周期继续负责 `prototype-review`、用户确认、Spec 回填和 OpenAPI Draft 门禁。
-
-## 考虑的替代方案
-
-| 方案 | 优点 | 缺点 | 结论 |
-|------|------|------|------|
-| 继续使用多个原型技能并列入口 | 对旧流程改动少 | Agent 路由不稳定，难以统一 AntD v6 高保真 HTML 原型和确认记录 | 放弃 |
-| 只保留 `high-fidelity-html-prototype` | 产物目标直接 | 缺少 Product Design plugin 的上下文、视觉探索、URL / 图片 / 代码来源路由能力 | 放弃 |
-| 以 `product-design:index` 为主入口，只保留仍有迁移价值的兼容入口 | 路由统一，可复用 focused skills，并允许逐步退休冗余入口 | 需要在文档中明确 legacy 边界 | 采纳 |
-
-## 后果
-
-### 正面影响
-
-- 有 UI 的产品原型产出入口统一。
-- 高保真 HTML 原型、AntD CLI 校验证据和用户确认记录成为固定门禁。
-- Figma / Axure / Excalidraw / 截图 / URL 可作为输入来源，而不是主交付格式。
-
-### 负面影响
-
-- 需要维护完整 `.codex/skills/product-design/` 插件目录，不能只复制 `index/SKILL.md`。
-- 部分旧原型技能在过渡期仍会存在，需要通过流程文档限制使用语境；无继续维护价值的入口直接退休，不保留空壳目录。
-
-### 风险
-
-- 如果 Agent 未读取 Product Design focused skill，可能误把 `product-design:index` 当作直接产出技能。
-- 如果跳过 `antd` CLI 查询，原型可能偏离 Ant Design v6 组件 API 或 token。
-- 如果缺少用户确认记录，下游 Spec 校准和 OpenAPI Draft 会失去体验冻结依据。
-
-## 相关
-
-- `AGENTS.md`
-- `docs/design/README.md`
-- `docs/process/lifecycle-artifact-map.md`
-- `docs/design/README.md`
-- `docs/design/templates/prototype-confirmation-template.md`

package/template/docs/adr/0002-yss-project-repository-mode.md

@@ -1,3 +0,0 @@
-# ADR-0002: 使用 `yss-project.yaml` 声明仓库身份
-
-模板源仓库与模板实例仓库共享大部分目录和流程资产，仅靠目录、Git 远程或占位符推断身份会导致 Agent 选错流程。因此在根目录使用 `yss-project.yaml` 作为 CLI 与 Agent 共享的稳定契约，只声明 `schema_version` 和 `repository_mode`：模板源仓库使用 `template-source`，`create-yss-spec` 生成的仓库使用 `project-instance`。项目名称、团队规模和 Tracker 等易变信息不放入该清单，避免形成新的重复配置源。

package/template/docs/adr/0003-machine-readable-lifecycle-registry.md

@@ -1,5 +0,0 @@
-# ADR-0003: 使用机器可读生命周期注册表作为结构化事实源
-
-> 状态：部分实施（Phase 1）。本次发布只接受注册表、稳定 ID、结构表和工作单元表的 shadow 校验；数量、索引、依赖图和测试 fixture 的完整生成属于后续提案，未实现前不得作为模板发布能力宣称。
-
-YSS 研发操作系统当前在 Markdown 生命周期地图、主控 skill、机器契约、用户指南和场景测试中重复表达阶段、门禁、产物与工作单元，已经出现门禁数量和工作单元数量漂移。Phase 1 引入生命周期注册表，集中保存这些结构事实及稳定标识，并由它派生当前 Markdown 结构表；Markdown 继续承担人工解释和审查，ADR 继续记录取舍，业务语义不被压缩成难读的配置。数量、索引、依赖图和测试 fixture 的自动生成必须在独立 Phase 中与生成器和校验器一并落地，不能只通过 ADR 宣告完成。

package/template/docs/adr/0006-stable-lifecycle-ids-and-generated-structure.md

@@ -1,5 +0,0 @@
-# ADR-0006: 使用稳定命名空间 ID 并派生生命周期结构资产
-
-> 状态：部分实施（Phase 1）。稳定 ID、发布基线和两份结构视图已受管；索引、依赖图和测试 fixture 的完整生成属于后续提案，未实现前不得把人工维护的场景断言称为派生产物。
-
-生命周期对象的中文名称、展示顺序和数量会随流程演进而变化，不能继续用“第几个门禁”或表格行数作为兼容身份。Phase 1 为主阶段、门禁、产物、工作单元和证据分别使用 `stage.*`、`gate.*`、`artifact.*`、`work-unit.*`、`evidence.*` 稳定 ID，并由 `docs/process/lifecycle-registry.yaml` 生成当前结构表；用户指南、ADR 和实践说明继续人工维护并引用稳定 ID。数量、索引、依赖图和测试 fixture 必须在后续 Phase 通过同一生成器和 `--check` 一并交付。已发布 ID 不复用，语义变化通过弃用记录和 schema 迁移表达，以牺牲直接编辑派生表格的便利换取跨版本引用稳定性。

package/template/docs/adr/0007-lifecycle-native-work-units.md

@@ -1,5 +0,0 @@
-# ADR-0007: 生命周期使用原生工作单元并保留 Matt 兼容入口
-
-`yss-product-lifecycle` 作为 YSS 研发生命周期的唯一默认入口，持有阶段、产物状态、门禁和正式资产所有权。Spec 综合、Ticket 正式化和切片实现使用生命周期注册表中的原生工作单元；`to-spec`、`to-tickets`、`implement` 保留为用户显式调用的兼容输入，结果必须回交生命周期验收，生命周期不得自动调用这些 user-invoked skills。
-
-该选择避免用户手动记忆阶段切换，也避免 Matt 默认的 `ready-for-agent`、commit 等行为越过 YSS 门禁和授权。代价是生命周期需要维护原生工作单元路由和兼容适配，但两者在 `work_unit_routes` 中共享一个稳定工作单元身份、使用互斥的 `native` / `compatibility` 路由，不再形成两套执行定义。