create-yss-spec 3.3.1 → 3.3.4

package/template/.trae/skills/ytable-usage/SKILL.md

@@ -1,251 +0,0 @@
----
-name: ytable-usage
-description: 指导 YSS UI 业务列表页、CRUD 表格、远程分页、操作列、气泡确认、列筛选、字典翻译、行拖拽、工具栏和自定义插槽正确使用 @yss-ui/components 的 YTable；当需要配置 YTableColumn、YTableActionConfig、pagination、filter-change 或表格实例方法时使用。
----
-
-# YTable 使用
-
-## 触发条件
-
-- 生成或修改业务列表、CRUD 表格、远程分页、操作列、列筛选、工具栏或行拖拽。
-- 需要配置 `YTableColumn`、`YTableActionConfig`、分页状态或表格实例方法。
-
-## 不适用场景
-
-- 可编辑表格是核心需求：使用 `../yedit-table-usage/SKILL.md`。
-- 页面只有短小静态数据且不需要表格交互。
-
-## 实施流程
-
-1. 当前会话可用 yss-ui MCP 时，先用 `get_component_docs` 查询 `YTable` 的 Props、Events、Slots、Types 与实例方法；需要远程分页、筛选、操作列、拖拽或工具栏时，再用 `get_demo` 获取对应官方 Demo。
-2. MCP 工具不可用、调用失败或用 `search_docs/list_components` 校正后仍无结果时，才读取最新 `llms-full.txt`；若文档与当前项目依赖版本不一致，用当前源码和导出核验。
-3. 把远程数据、`loading`、分页映射、API 调用和事件处理放入 Hook；把列定义和纯配置放入 `constant.ts`。
-4. 在模板中组合 `data/columns/loading/pagination`，并根据真实开启的工具栏和分页配置高度 Hook。
-5. 完成后核对删除确认、远程筛选、分页字段映射和 API 错误处理边界。
-
-## 硬约束（禁止/必须）
-
-- 必须从 `@yss-ui/components` 导入 `YTable`、`YTableColumn`、`YTableActionConfig` 等真实导出，不使用 `a-table` 实现业务主表格。
-- 远程分页状态使用 `current/pageSize/total/remote`，显式设置 `remote: true`；后端 `pageIndex/pageSize/totalCount` 只在 Hook 中映射。
-- 开启内置分页时传 `pageable`，受控更新使用 `v-model:pagination`，请求时机使用 `@page-change="handlePageChange"`。
-- `page-change` 事件参数固定为 `{ current: number, pageSize: number }`；回调必须读取 `current`，禁止写成组件不会派发的 `currentPage`。
-- YTable 没有 `request` 或 `searchParams` Props；远程查询由业务 Hook 管理。`refresh()` 是真实实例方法，内部调用 vxe-table `updateData()` 刷新当前表格数据，不等于重新调用后端接口。
-- 行键使用 `:row-config="{ keyField: 'id', useKey: true }"`，不臆造 `row-key` Prop。
-- 新增、导入、批量操作等主按钮直接放入 `#toolbar-right` 或 `#toolbar-left` 插槽即可自动渲染工具栏；**无需配置 `:toolbar-config="{ custom: true }"`**，避免无端展示列设置图标；**仅在业务明确需要列设置时才传入 `:toolbar-config="{ custom: true }"`**。
-- 删除、启停、发布等危险操作使用 `actionConfig.buttons[].isConfirm = true`，不默认使用 `Modal.confirm`。
-- 列配置超过 10 行时放入 `constant.ts`；需要调用组件 Hook 的操作配置使用工厂函数注入回调，禁止在 `constant.ts` 直接引用组件局部的 `openEdit/deleteItem`。
-- 远程筛选必须提供稳定 `filters`，设置 `filterMethod: () => true` 禁用本地二次过滤，并监听 `filter-change`。
-- 自适应滚动列表绑定 `:height="tableHeight"`；`pageable`、工具栏分别对应 `withPagination: true`、`withToolbar: true`。纯短表不强制引入高度 Hook。
-- `mutator.ts` 已对网络错误和 `success === false` 统一 `message.error` 并 reject。API Hook 不再检查 `success === false`，不在 `else/catch` 重复 `message.error`；用 `finally` 恢复 loading，让异常继续中断流程。
-
-## 标准代码骨架
-
-```typescript
-import type { YTableActionConfig, YTableColumn } from '@yss-ui/components';
-
-/** 列表行数据。 */
-export interface ItemRow {
-  id: string;
-  name: string;
-  status: string;
-}
-
-/** 状态字典。 */
-export const STATUS_OPTIONS = [
-  { label: '启用', value: '1' },
-  { label: '停用', value: '0' },
-];
-
-/** 列表固定列配置。 */
-export const TABLE_COLUMNS: YTableColumn[] = [
-  { type: 'seq', title: '序号', width: 70 },
-  { field: 'name', title: '名称', minWidth: 180 },
-  { field: 'status', title: '状态', width: 120, isTransform: true },
-  { type: 'action', title: '操作', width: 180 },
-];
-
-/** 按组件 Hook 提供的回调创建操作列配置。 */
-export const createActionConfig = (handlers: {
-  onEdit: (row: ItemRow) => void;
-  onDelete: (row: ItemRow) => Promise<void>;
-}): YTableActionConfig => ({
-  width: 180,
-  fixed: 'right',
-  buttons: [
-    { value: 'edit', label: '编辑', type: 'link', click: ({ row }) => handlers.onEdit(row) },
-    {
-      value: 'delete',
-      label: '删除',
-      type: 'link',
-      isConfirm: true,
-      confirmProps: { title: '确认删除该数据吗？', okText: '确定', cancelText: '取消' },
-      click: ({ row }) => handlers.onDelete(row),
-    },
-  ],
-});
-```
-
-## 远程分页 Hook 关键模式
-
-```typescript
-import { ref } from 'vue';
-import type { YTablePagination } from '@yss-ui/components';
-import type { ItemRow } from '../constant';
-
-/** 列表 API 依赖，由当前项目的 Orval 函数适配。 */
-export interface ItemListApi {
-  queryPage: (params: { pageIndex: number; pageSize: number }) => Promise<{
-    list?: ItemRow[];
-    totalCount?: number;
-  }>;
-  deleteItem: (params: { id: string }) => Promise<unknown>;
-}
-
-/** 管理 YTable 远程分页和删除刷新。 */
-export const useItemList = (api: ItemListApi) => {
-  const dataList = ref<ItemRow[]>([]);
-  const loading = ref(false);
-  const pagination = ref<YTablePagination>({ current: 1, pageSize: 20, total: 0, remote: true });
-
-  /** 查询当前页；错误提示由 mutator 统一处理。 */
-  const loadList = async () => {
-    loading.value = true;
-    try {
-      const result = await api.queryPage({
-        pageIndex: pagination.value.current,
-        pageSize: pagination.value.pageSize,
-      });
-      dataList.value = result.list ?? [];
-      pagination.value = { ...pagination.value, total: result.totalCount ?? 0 };
-    } finally {
-      loading.value = false;
-    }
-  };
-
-  /** 同步 YTable 分页状态并重新查询。 */
-  const handlePageChange = async ({ current, pageSize }: { current: number; pageSize: number }) => {
-    pagination.value = { ...pagination.value, current, pageSize };
-    await loadList();
-  };
-
-  /** 删除后刷新列表；不重复弹出 API 错误。 */
-  const handleDelete = async (row: ItemRow) => {
-    await api.deleteItem({ id: row.id });
-    await loadList();
-  };
-
-  return { dataList, loading, pagination, loadList, handlePageChange, handleDelete };
-};
-```
-
-```vue
-<script setup lang="ts">
-import { onMounted, ref } from 'vue';
-import { YButton, YTable } from '@yss-ui/components';
-import { useTableHeight } from '@yss-ui/hooks';
-import { createActionConfig, STATUS_OPTIONS, TABLE_COLUMNS, type ItemRow } from './constant';
-import { useItemList, type ItemListApi } from './hooks/useItemList';
-
-/** 列表实例的 API 依赖。 */
-interface Props {
-  api: ItemListApi;
-}
-
-const props = defineProps<Props>();
-const emit = defineEmits<{
-  create: [];
-  edit: [row: ItemRow];
-}>();
-const tableAreaRef = ref<HTMLDivElement>();
-const { tableHeight } = useTableHeight(tableAreaRef, { withPagination: true, withToolbar: true });
-const { dataList, loading, pagination, loadList, handlePageChange, handleDelete } = useItemList(props.api);
-const actionConfig = createActionConfig({
-  onEdit: row => emit('edit', row),
-  onDelete: handleDelete,
-});
-
-onMounted(loadList);
-</script>
-
-<template>
-  <div ref="tableAreaRef" class="table-area">
-    <YTable
-      :data="dataList"
-      :columns="TABLE_COLUMNS"
-      :action-config="actionConfig"
-      :loading="loading"
-      :options-map="{ status: STATUS_OPTIONS }"
-      :row-config="{ keyField: 'id', useKey: true }"
-      :height="tableHeight"
-      pageable
-      v-model:pagination="pagination"
-      @page-change="handlePageChange"
-    >
-      <template #toolbar-right>
-        <YButton type="primary" @click="emit('create')">新增</YButton>
-      </template>
-    </YTable>
-  </div>
-</template>
-
-<style scoped lang="less">
-@import './style.less';
-</style>
-```
-
-```less
-/* style.less */
-.table-area {
-  height: 100%;
-  min-height: 0;
-  overflow: hidden;
-}
-```
-
-## 表格多选与批量操作标准模式
-
-当业务需要 Checkbox 多选与批量操作（如批量删除、批量导出、批量启用）时，遵循以下规范：
-
-1. **列配置**：首列必须声明 `{ type: 'checkbox', width: 50, fixed: 'left', align: 'center' }`。
-2. **行唯一键**：必须显式指定 `:row-config="{ keyField: 'id', useKey: true }"`（`keyField` 与业务主键如 `userCode` 对齐）。
-3. **受控双向绑定**：推荐优先使用 `v-model:selected-row-keys="selectedRowKeys"` 或 `v-model:selected-rows="selectedRows"`，或者统一监听 `@selection-change`。
-4. **批量操作按钮**：放在 `#toolbar-right`，并配置 `:disabled="selectedRowKeys.length === 0"`。
-5. **清空选中态**：批量操作成功后，直接重置 `selectedRowKeys.value = []` 或调用 `tableRef.value.clearSelection()`。
-
-```vue
-<YTable
-  ref="tableRef"
-  v-model:selected-row-keys="selectedRowKeys"
-  :row-config="{ keyField: 'id', useKey: true }"
-  :data="dataList"
-  :columns="TABLE_COLUMNS"
-  pageable
-  v-model:pagination="pagination"
-  @page-change="handlePageChange"
->
-  <template #toolbar-right>
-    <YButton :disabled="selectedRowKeys.length === 0" @click="handleBatchDelete">批量删除</YButton>
-  </template>
-</YTable>
-```
-
-## 插槽与实例边界
-
-- 优先使用 kebab-case：单元格 `#<field>`、表头 `#<field>-header`、筛选 `#<field>-filter`、工具栏 `#toolbar-left/#toolbar-right`、展开行 `#expand-row`、分组表头 `#group-header`、更多图标 `#action-more-icon`。
-- `getTableInstance()`、`refresh()`、`recalculate()`、`clearSelection()`、`getSelectedRows()`、`getSelectedRowKeys()`、`setSelection()`、`getPaginationInstance()` 是真实暴露方法；只在对应语义下使用。
-
-## 交付检查清单
-
-- [ ] 分页状态和 `page-change` 参数均使用 `current/pageSize`，未使用 `currentPage`；`filter-change` 与 YTable 真实 API 一致。
-- [ ] 多选列已配置 `type: 'checkbox'`，已设置 `:row-config="{ keyField: 'xxx', useKey: true }"`，批量按钮绑定了 `selectedRowKeys.length === 0` 禁用。
-- [ ] 批量操作成功后已重置 `selectedRowKeys` 并调用 `tableRef.clearSelection()`。
-- [ ] 未使用虚构 `request/searchParams/row-key` Props，也未把 `refresh()` 当成远程请求。
-- [ ] 工具栏、字典翻译、操作确认与高度偏移均与实际开关一致。
-- [ ] API Hook 没有 `success === false` 分支或重复 `message.error`。
-
-## 失败兜底策略
-
-- 分页字段混乱时，在 Hook 中分离 YTable 状态和后端参数，不直接把 `pageIndex/totalCount` 绑到组件。
-- 操作过多时使用 `displayLimit` 和更多菜单；远程刷新失效时回到业务 `loadList()`，不把实例 `refresh()` 当成接口请求。
-- API 失败后只在 `finally` 恢复本地 loading，让 mutator 的 reject 继续中断删除后刷新等后续流程。
-

package/template/.trae/skills/ytree-usage/SKILL.md

@@ -1,132 +0,0 @@
----
-name: ytree-usage
-description: 指导 YSS UI 左树右表、组织树、分类树、目录树和节点管理页使用 @yss-ui/components 的 YTree，覆盖 fieldNames 字段映射、搜索过滤、受控选中、节点动作、删除确认、虚拟滚动和自适应高度；当生成或修改树形筛选、左树右表、树搜索或树节点操作时使用。
----
-
-# YTree 使用
-
-## 触发条件
-
-- 生成或修改左树右表、组织树、分类树、目录树、树搜索或树节点操作。
-- 需要配置 `fieldNames`、受控选中、`YTreeActionItem` 或树区域自适应高度。
-
-## 不适用场景
-
-- 树数据只用于表单 TreeSelect 字段：使用 `YFormily` 或对应表单规范。
-- 页面只有普通列表而没有层级筛选：使用 `../ytable-usage/SKILL.md`。
-
-## 实施流程
-
-1. 当前会话可用 yss-ui MCP 时，先用 `get_component_docs` 查询 `YTree` 的 Props、Slots、Events 和 `YTreeActionItem`；需要搜索、节点动作、受控选中或左树右表时，再用 `get_demo` 获取对应官方 Demo。
-2. MCP 工具不可用、调用失败或用 `search_docs/list_components` 校正后仍无结果时，才读取最新 `llms-full.txt`；若文档与当前项目依赖版本不一致，用当前源码和导出核验。
-3. 确定树数据的 title/key/children 字段、受控状态和选中后的业务联动。
-4. 按容器布局配置 `useTreeHeight`，再添加搜索和节点动作。
-5. 若包含删除，单独完成气泡确认链路；不把 `danger` 颜色当成二次确认。
-
-## 硬约束（禁止/必须）
-
-- 从 `@yss-ui/components` 导入 `YTree`、`YTreeActionItem` 等真实导出；高度使用 `@yss-ui/hooks` 的 `useTreeHeight`。
-- 数据字段不一致时配置 `fieldNames`，不为了改名重复递归复制树数据。
-- 搜索使用 `filterable + v-model:searchValue`；受控选中使用 `v-model:selectedKeys`。
-- 普通节点菜单使用 `showActions + getNodeActions`，并监听 `@action`。`YTreeActionItem` 只支持 `key/label/icon/disabled/danger`，禁止臆造 `isConfirm/click` 等字段。
-- `danger: true` 只改变危险项视觉，不会弹出确认框。删除必须放在节点附近的 `#node-suffix` 或当前选中节点操作区，用 Ant Design Vue `Popconfirm` 的 `@confirm` 调用接口；不使用居中 `Modal.confirm`。
-- 树区域需要滚动时绑定 `:height="treeHeight"`，不默认添加 `:virtual="true"`。只有展开后可见扁平节点数 `* itemHeight > height` 时才会实际裁剪 DOM。
-- 使用 YTree 内置搜索时，高度 Hook 通过 `extraOffset: YTREE_SEARCH_HEIGHT` 扣除 48px；不再叠加无依据的魔法数。
-- 左树右表优先组合 `YSplitPane + YCard + YTree + YTable`；切换节点时同步查询条件并把右表分页重置为第 1 页。
-- 节点删除 API 的错误由 `mutator.ts` 统一提示并 reject；不在 `else/catch` 重复 `message.error`。
-
-## 标准代码骨架
-
-```vue
-<script setup lang="ts">
-import { ref } from 'vue';
-import { YTree, type YTreeActionItem } from '@yss-ui/components';
-import { useTreeHeight, YTREE_SEARCH_HEIGHT } from '@yss-ui/hooks';
-
-/** 树节点数据。 */
-interface TreeNode {
-  id: string;
-  name: string;
-  children?: TreeNode[];
-}
-
-const emit = defineEmits<{
-  create: [node: TreeNode];
-  edit: [node: TreeNode];
-}>();
-const treeAreaRef = ref<HTMLDivElement>();
-const treeData = ref<TreeNode[]>([]);
-const searchValue = ref('');
-const selectedKeys = ref<Array<string | number>>([]);
-const { treeHeight } = useTreeHeight(treeAreaRef, {
-  extraOffset: YTREE_SEARCH_HEIGHT,
-});
-
-/** 生成当前节点的非危险操作。 */
-const getNodeActions = (): YTreeActionItem[] => [
-  { key: 'add', label: '新增子节点' },
-  { key: 'edit', label: '编辑' },
-];
-
-/** 处理 YTree 动作事件。 */
-const handleTreeAction = ({ key, node }: { key: string; node: TreeNode }) => {
-  if (key === 'add') emit('create', node);
-  if (key === 'edit') emit('edit', node);
-};
-</script>
-
-<template>
-  <div ref="treeAreaRef" class="tree-area">
-    <YTree
-      :height="treeHeight"
-      :tree-data="treeData"
-      :field-names="{ title: 'name', key: 'id', children: 'children' }"
-      filterable
-      show-actions
-      v-model:searchValue="searchValue"
-      v-model:selectedKeys="selectedKeys"
-      :get-node-actions="getNodeActions"
-      @action="handleTreeAction"
-    />
-  </div>
-</template>
-
-<style scoped lang="less">
-@import './style.less';
-</style>
-```
-
-```less
-/* style.less */
-.tree-area {
-  flex: 1;
-  min-height: 0;
-  overflow: hidden;
-}
-```
-
-## 删除确认边界
-
-```vue
-<template #node-suffix="{ node }">
-  <Popconfirm title="确认删除该节点吗？" ok-text="确定" cancel-text="取消" @confirm="handleDelete(node)">
-    <YButton type="link" @click.stop>删除</YButton>
-  </Popconfirm>
-</template>
-```
-
-`Popconfirm` 从 `ant-design-vue` 导入，`YButton` 从 `@yss-ui/components` 导入。如果每个节点都展示删除会过密，把同样的 `Popconfirm` 放到选中节点的页面工具栏。
-
-## 交付检查清单
-
-- [ ] `fieldNames`、`searchValue`、`selectedKeys`、`action` 与真实 API 一致。
-- [ ] 节点动作项未出现虚构字段，删除不会点菜单后立即执行。
-- [ ] 高度偏移与内置搜索实际开关一致，没有多扣魔法数。
-- [ ] 左树选中后，右表查询条件和分页重置闭环清晰。
-
-## 失败兜底策略
-
-- 节点字段不统一时先修正 `fieldNames`，不复制整棵树换键。
-- 点击删除立即调用 API 时，移出节点动作菜单，改为节点附近或页面操作区 `Popconfirm`。
-- 传入 `height` 但节点未裁剪时，先核对展开后可见节点数、`itemHeight` 和阈值，不盲目强制 `virtual=true`。
-- 节点 API 失败后让 mutator reject 中断右表刷新等后续流程，不重复错误提示。

package/template/CLAUDE.md

@@ -1,13 +0,0 @@
-# CLAUDE.md
-
-Agent 入口、硬门禁与禁止事项以仓库根 `AGENTS.md` 为准。每个任务先读 `yss-project.yaml` 识别仓库身份，再读 `CONTEXT.md`。本文件不另定义流程规则。
-
-## 前端 / 后端验证命令
-
-进入 frontend 或 backend 的实现、测试或编译时：
-
-- 前端优先使用 `pnpm` 做依赖、测试、type-check 与构建；不要默认 `npm` / `yarn`。
-- 后端优先使用项目根 `./mvnw` 做 `validate` / `test` / `package`；不要默认裸 `mvn`。
-- 既有仓库确实没有 pnpm 或 Maven Wrapper 时，记录受控例外和实际命令。
-
-登记字段与跨仓约束见 `docs/process/implementation-repo-integration.md`。

package/template/docs/agents/skills-maintenance.md

@@ -1,101 +0,0 @@
-# Skills 维护说明
-
-本文说明项目级 skills 的权威目录、投影方式、锁文件语义和升级验证。Agent 实际加载的入口仍是各目录中的 `SKILL.md`。
-
-## 权威内容与投影
-
-- `.agents/skills` 是跨 Agent 共享技能的唯一权威内容。
-- `.claude/skills`、`.codex/skills`、`.cursor/skills`、`.pi/skills`、`.qoder/skills`、`.trae/skills` 中的同名共享技能是生成投影，不得分别手工修改。
-- Cursor 的契约运行时入口是 `.cursor/skills`。若客户端同时枚举 `.claude/skills`，仍以 `.cursor/skills` 为 Cursor 投影契约，不得把两套同名 skill 解释为两个来源。
-- 分层、别名和默认可发现性以 `docs/agents/yss-skill-registry.yaml` 为准；当前 registry 为 `active`，实现合同编译器、生命周期编排器和实例发现面必须消费通过校验的 canonical 技能及其 alias 解析结果。
-- 只属于某个平台的 skill 继续保留在对应 root，并由 `skills-lock.json` 的 `platform` 分组记录。
-- 共享技能投影可以是指向权威目录的符号链接，也可以是完整同步副本；`scripts/sync-skills --check` 会检查链接目标或完整目录哈希。
-
-## 来源与锁定
-
-| 来源 | 固定版本 / 路径 | 用途 |
-|---|---|---|
-| `mattpocock/skills` | `0ab1b63a410a03d3627979a109c8695de27af954` / `skills/engineering` 及锁文件记录的关联路径 | 通用工程流程及关联 skills |
-| `anthropics/knowledge-work-plugins` | `sales/skills/competitive-intelligence` | 竞品与市场事实研究 |
-| `tt-a1i/archify` | `199360cc6687a7857b54dd188d4922b09e466a4b` / `archify` | 条件式、可验证的技术架构图；YSS 适配见 `docs/agents/archify-integration.md` |
-| `iloveZzz/yss-ui` | `.agents/skills/.yss-skills-manifest.json` 锁定的 revision / `packages/skills` | 22 个 `categories.app` 业务前端 skills；排除组件库内部 `categories.library` 和后端提交 skill，适配见 `docs/agents/yss-ui-skills-integration.md` |
-| 项目本地 | `.agents/skills` 或平台专属 root | YSS 适配与项目治理 skills |
-
-`skills-lock.json` 是技能清单、来源、上游哈希、当前有效内容哈希和投影目标的权威记录：
-
-- `upstreamHash`：能够追溯时记录未经项目适配的上游内容哈希。
-- `effectiveHash`：当前实际生效的完整 skill 目录树哈希。
-- `targets`：权威内容应投影到的 Agent roots。
-
-项目允许按 YSS 流程适配上游 skill，但必须同时保留可追溯的上游信息和适配后的有效哈希。
-
-当前 Matt 快照为 `0ab1b63a410a03d3627979a109c8695de27af954`。模板按 YSS capability 白名单收录上游 Skill；已退役的通用路由、个人工作流、教学、练习、写作实验和专项迁移 Skill 不再随 project-instance 分发。
-
-本轮升级还将生命周期适配固定为：阶段边界只写可选 `phase_boundary` 证据；`to-questionnaire` 使用 `external-input-required` 暂停并在答案回流后重新分类影响面；Matt `prototype` 的单文件 HTML 只作为回流输入，YSS 原型仍须完成低保真评审、H1/H2 档位路由、Prototype Evidence schema v4、Visual Baseline schema v1 验证和用户确认。人工 checkpoint 与 `diagnosing-bugs` 的输出必须脱敏，`wait-what` 不改变生命周期状态。
-
-## 维护流程
-
-1. 在临时目录读取或下载锁定来源，不直接覆盖工作区。
-2. 只在 `.agents/skills/<skill-name>/` 修改共享技能；平台专属技能只在所属 root 修改。
-3. 创建、修改或退役 skill 时使用 `maintaining-skills`，并先按 `docs/process/harness-process-tailoring.md` 判定验证与审查强度：L1 执行相关检查，L2 记录最小反例、fresh verification 和聚焦审查，L3 记录维护者自检与 fresh verification；正式发布前统一执行完整模板门禁。未定义分级的外部仓库按实际风险执行结构校验和针对性行为验证。
-4. 生成共享投影并更新锁文件：
-
-   ```bash
-   scripts/sync-skills
-   scripts/update-skill-lock
-   ```
-
-   若来源来自可访问的上游 checkout，还应显式校验锁定 revision 与每个上游目录哈希：
-
-   ```bash
-   scripts/verify-upstream-skill-source --source=mattpocock/skills --source-root <matt-skills-checkout>
-   scripts/verify-upstream-skill-source --source=iloveZzz/yss-ui --source-root <yss-ui-checkout>
-   ```
-
-   新增共享 skill 时先显式登记：`scripts/update-skill-lock --add=<skill-name>`；新增平台专属 skill 使用 `scripts/update-skill-lock --add-platform=<root>:<skill-name>`。脚本不会把工作区中偶然出现的未跟踪目录自动纳入发布清单。
-
-5. 日常修改先执行影响面快速核验，默认完成到 `implementation-ready`：
-
-   ```bash
-   scripts/verify-template-fast
-   ```
-
-   显式准备独立审查时执行 `scripts/verify-template-candidate`，首次冻结前和最终发布前才执行完整发布阻断校验：
-
-   ```bash
-   scripts/verify-template-candidate
-   scripts/verify-template
-   ```
-
-   模板源维护引入或更新分发到实例的 Node 工具时，维护侧依赖、构建和 vendor 校验只在模板源治理区及 CI 中执行；实例门禁不得安装依赖或重建 vendor。实例只消费已提交的 `scripts/lib/*.mjs` 与 `scripts/vendor/*.mjs`，具体维护侧命令和治理决策不属于项目实例文档。
-
-6. 需要重新加载技能的客户端在变更落地后重启或刷新项目。
-
-## 单独检查
-
-```bash
-scripts/sync-skills --check
-scripts/update-skill-lock --check
-# 可选：对照锁文件中的 source revision 与上游目录哈希
-scripts/verify-upstream-skill-source --source=mattpocock/skills --source-root <matt-skills-checkout>
-scripts/verify-upstream-skill-source --source=iloveZzz/yss-ui --source-root <yss-ui-checkout>
-```
-
-前者检查所有共享投影是否指向或匹配权威内容，后者检查 `skills-lock.json` 是否与当前完整目录树一致。过时技能不会保留兼容别名；旧 skill 名称和入口按 [`docs/agents/skill-migrations.md`](./skill-migrations.md) 一次性迁移，项目文件升级由 `create-yss-spec attach` / `sync` 处理。
-
-## skills.sh 公开发布
-
-YSS 技能的公开发布仓库为 `iloveZzz/yss-spec-dev-skills`，它是本模板 `.agents/skills` 的单向发布投影，不是新的权威来源。
-
-- `yss-public-skills.json` 冻结允许公开的 YSS 技能清单；新增技能必须显式加入该清单。
-- `scripts/export-yss-skills --output <目录>` 从 canonical skills 生成公开目录；`--check --output <目录>` 只验证已有导出，不写入文件。
-- 公开仓库只包含 `skills/`、README、许可证、`skills.sh.json` 和发布校验；不得复制 `AGENTS.md`、`CONTEXT.md`、`skills-lock.json` 或各 Agent 投影目录。
-- 导出器会将本机绝对路径、Agent root 和模板内部路径转换为公开可移植形式，并阻断重复 skill 名、疑似凭据、符号链接和失效仓库内链接。
-- 发布顺序为：同步 canonical projections → 更新 lock → `scripts/verify-template` → 导出并检查 → 独立审查 → 在 `yss-spec-dev-skills` 提交人工 PR。不得从目标仓库反向覆盖 `.agents/skills`。
-- skills.sh 通过 `npx skills add iloveZzz/yss-spec-dev-skills` 的安装遥测自动发现技能，不需要手工注册；遥测可用 `DISABLE_TELEMETRY=1` 或 `DO_NOT_TRACK` 关闭。
-
-已退休、personal 或由 YSS 有意排除的条目不再进入 `.agents/skills`、六个共享投影根或 `skills-lock.json`。退役 ID、日期和替代路径只在 [`skill-migrations.md`](./skill-migrations.md) 持久化，其他活跃文档不得重复维护清单或创建兼容目录。其中 `wizard` 是最新上游仍存在但 YSS 当前有意排除的人工步骤技能，不应描述为上游已退休。
-
-## 外部工作流工具
-
-维护者可按需使用本机的 `gitlab-workflow`、`glab`、`gh` 或 `scripts/gitworks`。这些工具不是共享技能投影的一部分；平台选择与发布规则见 `docs/agents/issue-tracker.md`。

package/template/docs/agents/strategic-design-skills-integration.md

@@ -1,48 +0,0 @@
-# 战略设计技能集成合同
-
-`iloveZzz/yss-harness-design-agent` 是以下公共技能 ID 的上游业务 profile：
-
-- `prototype-review`
-- `yss-prototype-stage`
-- `yss-design-system`
-- `yss-antd-design`
-- `yss-antdv-next-design`
-- `yss-stage-decision`
-
-父模板通过 `.agents/skills/.strategic-design-skills-manifest.json` 固定上游 Git revision、路径和 tree hash。公共 ID 不因 profile 改名；共享规则先在战略设计源仓演进，再由父模板同步。
-
-本轮 Plan 调整的 `yss-stage-decision` hash 对应战略设计子仓 commit `3a358684c5684ada433dca4fd97ee187050ca6d8`；父模板的 `source_revision` 与 gitlink 已同步。实施记录见 `.template-source/evidence/maintenance/2026-09-09-plan/`。
-
-## 父模板薄适配
-
-父模板承载完整产品研发生命周期，只允许在以下位置保留最小语境差异：
-
-| 技能 | 父模板适配 |
-|---|---|
-| `prototype-review` | 将评审结论回交 `yss-product-lifecycle`，通过后可进入实现合同编译准备 |
-| `yss-prototype-stage` | 用户确认后由完整生命周期判断 API 影响和实现准备 |
-| `yss-stage-decision` | 门禁状态由 `yss-product-lifecycle` 维护 |
-
-`yss-design-system`、`yss-antd-design` 与 `yss-antdv-next-design` 当前不需要父模板内容适配，必须与锁定的上游 tree hash 一致。任何有效内容差异都必须保留本文件为 `adaptationRef`，不得复制成第二套公共技能身份。
-
-## 更新与验证
-
-1. 先在战略设计源仓形成并推送固定 commit。
-2. 更新 manifest 的 `source_revision` 和每项 `upstream_hash`。
-3. 同步父模板 canonical 内容，仅重放上表允许的薄适配。
-4. 运行 `scripts/update-skill-lock`、`scripts/sync-skills`。
-5. 运行：
-
-   ```bash
-   scripts/verify-upstream-skill-source \
-     --source=iloveZzz/yss-harness-design-agent \
-     --source-root=submodules/yss-harness-design-agent
-   scripts/verify-skill-governance
-   scripts/verify-template-fast
-   ```
-
-父模板、战略设计源仓与 CLI 快照必须按源仓 → 父模板 → CLI 顺序固定 revision；旧实例不回填，也不提供迁移检查器。
-
-## 真实用户决定适配
-
-模板生命周期的关键决定统一消费 `docs/agents/digital-human-roles.yaml.user_decision_policy`。本地原型确认与阶段决策批准追加真实回复、当前资产和范围校验；数字人审查保留。记录协议见 [用户决定协议](../../.agents/skills/yss-product-lifecycle/references/user-decisions.md)。此适配只更新 effective hash，不改写已锁定的上游 revision/hash，也不发布外部技能源。

package/template/docs/agents/yss-ui-skills-integration.md

@@ -1,24 +0,0 @@
-# YSS UI 前端 Skills 集成合同
-
-本模板以 `iloveZzz/yss-ui` 的 `packages/skills` 为上游来源，以 `.agents/skills/.yss-skills-manifest.json` 冻结来源 revision、包版本、目录映射和上游树哈希。`.agents/skills` 仍是模板内跨 Agent 共享内容的唯一权威目录；其他 Agent root 只接收生成投影。
-
-## 范围
-
-- 从 yss-ui `skills.config.json` 的 `categories.app` 中按 YSS capability 白名单集成业务项目 skills；排除后端 `java-backend-commit`、已由统一业务页面入口替代的 `page-module-development`，以及已由 Visual Baseline 和前端实现验证替代的 `prototype-page-acceptance`，当前共 20 个。
-- `categories.library` 的 10 个组件库内部维护 skills 全部不进入模板；该分组同时位于上游 `excludeFromDefaultSync`。
-- `api-integration`、`use-table-height`、`use-tree-height` 在模板中分别映射为 `yss-api-integration`、`yss-use-table-height`、`yss-use-tree-height`，旧名称只作为 registry alias。
-- `java-backend-commit`、`page-module-development`、`prototype-page-acceptance` 明确不属于本合同；其内容、路由与锁定信息不随本前端同步更新。
-- 允许模板基于生命周期、组件路由和证据门禁做受控适配；适配后的 `effectiveHash` 与上游 `upstreamHash` 同时进入 `skills-lock.json`。
-
-## 更新步骤
-
-1. 在临时 checkout 中确认 `iloveZzz/yss-ui` 的目标 revision，并更新 `.agents/skills/.yss-skills-manifest.json`。
-2. 将新增或替换内容只写入 `.agents/skills/<canonical-name>`，不得直接编辑平台投影。
-3. 新增 skill 使用 `scripts/update-skill-lock --add=<canonical-name>` 显式登记。
-4. 运行 `scripts/sync-skills` 与 `scripts/update-skill-lock`。
-5. 使用 `scripts/verify-upstream-skill-source --source=iloveZzz/yss-ui --source-root=<checkout>` 验证 revision、清单和树哈希。
-6. 执行 `scripts/verify-template-fast`；首次冻结或正式发布前执行 `scripts/verify-template`。
-
-## MCP
-
-项目级 MCP 配置路径和容器字段同样由 manifest 固定，配置内容必须使用 `npx -y @yss-ui/mcp`。需要全局配置的运行时只提供人工安装说明，模板不得自动修改用户主目录。

package/template/docs/process/maintenance-intensity.yaml

@@ -1,25 +0,0 @@
-schema_version: 1
-default_level: L2
-levels:
-  L1:
-    triggers:
-      - textual-only
-      - link-only
-      - deterministic-projection
-  L2:
-    triggers:
-      - local-rule
-      - template-structure
-      - non-core-validator
-  L3:
-    triggers:
-      - lifecycle-gate
-      - ticket-state
-      - permission-boundary
-      - generation-semantics
-      - release-semantics
-      - cross-repo-contract
-      - core-validator
-      - historical-important-escape
-      - aggregate-behavior-change
-      - release-candidate

package/template/docs/process/schemas/maintenance-review-record.schema.json

@@ -1,49 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://yss.dev/schemas/maintenance-review-record.schema.json",
-  "title": "YSS Template Maintenance Independent Review Record",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schema_version",
-    "record_kind",
-    "review_mode",
-    "status",
-    "reviewer_id",
-    "implementation_actor_id",
-    "candidate_digest",
-    "candidate_snapshot_ref",
-    "task_package_ref",
-    "review_report_ref",
-    "reviewed_at",
-    "findings"
-  ],
-  "properties": {
-    "schema_version": { "const": 1 },
-    "record_kind": { "const": "maintenance-independent-review" },
-    "review_mode": { "enum": ["focused-independent", "formal-independent"] },
-    "status": { "enum": ["approved", "changes-requested", "blocked"] },
-    "reviewer_id": { "type": "string", "minLength": 1 },
-    "implementation_actor_id": { "type": "string", "minLength": 1 },
-    "candidate_digest": { "type": "string", "pattern": "^(sha256:)?[a-f0-9]{64}$" },
-    "candidate_snapshot_ref": { "type": "string", "minLength": 1 },
-    "task_package_ref": { "type": "string", "minLength": 1 },
-    "review_report_ref": { "type": "string", "minLength": 1 },
-    "reviewed_at": { "type": "string", "format": "date-time" },
-    "findings": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["id", "severity", "disposition", "status", "summary"],
-        "properties": {
-          "id": { "type": "string", "minLength": 1 },
-          "severity": { "enum": ["critical", "high", "medium", "low"] },
-          "disposition": { "enum": ["violation", "drift", "new_impacts", "judgement-call", "not-applicable"] },
-          "status": { "enum": ["open", "resolved", "not-applicable"] },
-          "summary": { "type": "string", "minLength": 1 }
-        }
-      }
-    }
-  }
-}