create-yss-spec 3.4.5 → 3.4.7

package/template/.agents/skills/page-skeleton/examples/AdvancedFormPage/schemas/ruleConfigSchema.ts

@@ -1,256 +0,0 @@
-/**
- * 规则配置表单Schema
- * 包含：Grid布局、表单分组、字段联动 (Reactions)、Slot插槽
- */
-import type { FormOptions } from '../constant';
-
-/**
- * 规则配置Schema
- * @param formOptions 表单选项数据
- */
-export const ruleConfigSchema = (formOptions: FormOptions): Record<string, any> => ({
-  type: 'object',
-  properties: {
-    layout: {
-      type: 'void',
-      'x-component': 'FormLayout',
-      'x-component-props': {
-        layout: 'horizontal',
-        labelWidth: 110, // ← 根据最长 label 确定（一般 5 个字约 100px，这里稍大）
-        labelAlign: 'right', // ← 必须右对齐
-      },
-      properties: {
-        grid: {
-          type: 'void',
-          'x-component': 'FormGrid',
-          'x-component-props': {
-            maxColumns: 3,
-            minColumns: 1,
-            columnGap: 16,
-            rowGap: 0,
-          },
-          properties: {
-            // -------------------------------------------------------------
-            // 分组1：规则配置
-            // -------------------------------------------------------------
-            ruleConfigHeader: {
-              type: 'void',
-              title: '规则配置',
-              'x-decorator': 'FormItem',
-              'x-decorator-props': {
-                feedbackLayout: 'none',
-                colon: false,
-                gridSpan: 3,
-                labelWidth: 0,
-                wrapperCol: { span: 24 },
-              },
-              'x-component': 'GroupHeader', // 自定义组件 or 标题组件
-            },
-            intensity: {
-              type: 'string',
-              title: '规则强度',
-              required: true,
-              'x-decorator': 'FormItem',
-              'x-component': 'Radio.Group',
-              enum: formOptions.intensity,
-            },
-            // 开关字段，控制其他字段显示
-            errorStorage: {
-              type: 'boolean',
-              title: '异常存储',
-              required: true,
-              'x-decorator': 'FormItem',
-              'x-component': 'Switch',
-              'x-component-props': {
-                checkedChildren: '开',
-                unCheckedChildren: '关',
-              },
-            },
-            // 受控字段：异常限制 (当 errorStorage=true 时显示)
-            errorStorageLimit: {
-              type: 'number',
-              title: '异常限制',
-              'x-decorator': 'FormItem',
-              'x-component': 'NumberPicker',
-              'x-component-props': {
-                placeholder: '请输入异常限制',
-                style: { width: '100%' },
-              },
-              'x-reactions': {
-                dependencies: ['errorStorage'],
-                fulfill: {
-                  state: {
-                    visible: '{{$deps[0]}}',
-                  },
-                },
-              },
-            },
-
-            // -------------------------------------------------------------
-            // 分组2：异常数据存储
-            // 这里的 GroupHeader 本身也受 errorStorage 控制显示
-            // -------------------------------------------------------------
-            exceptionDataHeader: {
-              type: 'void',
-              title: '异常数据存储',
-              'x-decorator': 'FormItem',
-              'x-decorator-props': {
-                feedbackLayout: 'none',
-                colon: false,
-                gridSpan: 3,
-                labelWidth: 0,
-                wrapperCol: { span: 24 },
-              },
-              'x-component': 'GroupHeader',
-              'x-reactions': {
-                dependencies: ['errorStorage'],
-                fulfill: {
-                  state: {
-                    visible: '{{$deps[0]}}',
-                  },
-                },
-              },
-            },
-            errorStorageType: {
-              type: 'string',
-              title: '存储方式',
-              required: true,
-              'x-decorator': 'FormItem',
-              'x-component': 'Select',
-              'x-component-props': {
-                placeholder: '请选择存储方式',
-              },
-              enum: formOptions.errorStorageType,
-              'x-reactions': {
-                dependencies: ['errorStorage'],
-                fulfill: {
-                  state: {
-                    visible: '{{$deps[0]}}',
-                  },
-                },
-              },
-            },
-            errorStorageName: {
-              type: 'string',
-              title: '存储名称',
-              required: true,
-              'x-decorator': 'FormItem',
-              'x-decorator-props': {
-                gridSpan: 1,
-              },
-              'x-component': 'Input',
-              'x-component-props': {
-                placeholder: '请选择异常数据存储名称',
-              },
-              'x-reactions': {
-                dependencies: ['errorStorage'],
-                fulfill: {
-                  state: {
-                    visible: '{{$deps[0]}}',
-                  },
-                },
-              },
-            },
-            errorStoragePath: {
-              type: 'string',
-              title: '存储地址',
-              'x-decorator': 'FormItem',
-              'x-decorator-props': {
-                gridSpan: 1,
-              },
-              'x-component': 'Input',
-              'x-component-props': {
-                placeholder: '请输入异常数据存储地址',
-              },
-              // 也可以配置 reactions
-            },
-
-            // -------------------------------------------------------------
-            // 分组3：校验规则 (使用 Slot 自定义渲染)
-            // -------------------------------------------------------------
-            filterHeader: {
-              type: 'void',
-              title: '校验规则',
-              'x-decorator': 'FormItem',
-              'x-decorator-props': {
-                feedbackLayout: 'none',
-                colon: false,
-                gridSpan: 3,
-                labelWidth: 0,
-                wrapperCol: { span: 24 },
-              },
-              'x-component': 'GroupHeader',
-            },
-            // Slot：校验范围构建器
-            conditionFilter: {
-              type: 'object',
-              title: '校验范围',
-              'x-decorator': 'FormItem',
-              'x-decorator-props': {
-                gridSpan: 3, // 占满一行
-              },
-              'x-component': 'Slot', // 关键：使用 Slot 组件
-              'x-component-props': {
-                name: 'conditionFilter', // 对应 <template #conditionFilter>
-              },
-            },
-            // Slot：条件结构预览
-            filterPreview: {
-              type: 'string',
-              title: '预览',
-              'x-decorator': 'FormItem',
-              'x-decorator-props': {
-                gridSpan: 3,
-              },
-              'x-component': 'Slot',
-              'x-component-props': {
-                name: 'filterPreview',
-              },
-            },
-
-            // -------------------------------------------------------------
-            // 分组4：校验设置
-            // -------------------------------------------------------------
-            checkHeader: {
-              type: 'void',
-              title: '校验设置',
-              'x-decorator': 'FormItem',
-              'x-decorator-props': {
-                feedbackLayout: 'none',
-                colon: false,
-                gridSpan: 3,
-                labelWidth: 0,
-                wrapperCol: { span: 24 },
-              },
-              'x-component': 'GroupHeader',
-            },
-            checkCondition: {
-              type: 'object',
-              title: '校验配置',
-              'x-decorator': 'FormItem',
-              'x-decorator-props': {
-                gridSpan: 3,
-              },
-              'x-component': 'Slot',
-              'x-component-props': {
-                name: 'checkCondition',
-              },
-            },
-            checkPreview: {
-              type: 'string',
-              title: '预览',
-              'x-decorator': 'FormItem',
-              'x-decorator-props': {
-                gridSpan: 3,
-              },
-              'x-component': 'Slot',
-              'x-component-props': {
-                name: 'checkPreview',
-              },
-            },
-          },
-        },
-      },
-    },
-  },
-});

package/template/.agents/skills/page-skeleton/examples/AdvancedFormPage/style.less

@@ -1,30 +0,0 @@
-.rule-config-page {
-  width: 100%;
-  height: 100%;
-
-  &__content {
-    height: 100%;
-    overflow: auto;
-  }
-
-  &__preview {
-    display: flex;
-    align-items: flex-start;
-    gap: 12px;
-
-    pre {
-      flex: 1;
-      min-height: 72px;
-      max-height: 220px;
-      margin: 0;
-      padding: 12px;
-      overflow: auto;
-      color: var(--text-color, rgb(0 0 0 / 88%));
-      background: var(--bg-color, #f0f2f5);
-      border: 1px solid var(--border-color-split, #f0f0f0);
-      border-radius: 6px;
-      white-space: pre-wrap;
-      word-break: break-word;
-    }
-  }
-}

package/template/.agents/skills/page-skeleton/examples/StandardListPage/constant.ts

@@ -1,28 +0,0 @@
-import type { YTableColumn } from '@yss-ui/components';
-import type { QualityBusinessRuleVO } from '@/api/generated/quality/schemas';
-
-/** 质量规则列表行数据。 */
-export type QualityRuleItem = QualityBusinessRuleVO;
-
-/** 质量规则查询表单。 */
-export interface SearchFormData {
-  ruleName: string;
-}
-
-/** 状态文案映射。 */
-export const STATUS_LABELS: Record<number, string> = {
-  0: '禁用',
-  1: '启用',
-};
-
-/** 质量规则表格列。 */
-export const TABLE_COLUMNS: YTableColumn[] = [
-  { field: 'ruleName', title: '质量规则名称', minWidth: 180, slots: { default: 'ruleName' } },
-  { field: 'ruleCode', title: '规则编码', minWidth: 160 },
-  {
-    field: 'status',
-    title: '状态',
-    width: 100,
-    formatter: ({ cellValue }: { cellValue?: number }) => STATUS_LABELS[cellValue ?? -1] ?? '-',
-  },
-];

package/template/.agents/skills/page-skeleton/examples/StandardListPage/hooks/useQualityRuleList.ts

@@ -1,58 +0,0 @@
-import { reactive, ref } from 'vue';
-import { getApiApi } from '@/api/generated/quality';
-import type { QualityRulePage } from '@/api/generated/quality/schemas';
-import type { QualityRuleItem, SearchFormData } from '../constant';
-
-const { pageQualityRule } = getApiApi();
-
-/** 管理质量规则列表、查询和远程分页。 */
-export const useQualityRuleList = () => {
-  const tableData = ref<QualityRuleItem[]>([]);
-  const loading = ref(false);
-  const pagination = reactive({ current: 1, pageSize: 20, total: 0, remote: true });
-  const searchForm = reactive<SearchFormData>({ ruleName: '' });
-
-  /** 组装 Orval 查询 DTO。 */
-  const getQueryParams = (): QualityRulePage => ({
-    pageIndex: pagination.current,
-    pageSize: pagination.pageSize,
-    ruleName: searchForm.ruleName || undefined,
-  });
-
-  /** 加载列表；错误提示由 mutator 统一处理。 */
-  const fetchList = async (): Promise<void> => {
-    loading.value = true;
-    try {
-      const res = await pageQualityRule(getQueryParams());
-      tableData.value = res.data ?? [];
-      pagination.total = res.totalCount ?? 0;
-    } catch {
-      tableData.value = [];
-      pagination.total = 0;
-    } finally {
-      loading.value = false;
-    }
-  };
-
-  /** 处理分页变化。 */
-  const handlePageChange = ({ current, pageSize }: { current: number; pageSize: number }): void => {
-    pagination.current = current;
-    pagination.pageSize = pageSize;
-    void fetchList();
-  };
-
-  /** 从第一页执行查询。 */
-  const handleSearch = (): void => {
-    pagination.current = 1;
-    void fetchList();
-  };
-
-  /** 重置查询条件并刷新。 */
-  const handleReset = (): void => {
-    searchForm.ruleName = '';
-    pagination.current = 1;
-    void fetchList();
-  };
-
-  return { tableData, loading, pagination, searchForm, fetchList, handlePageChange, handleSearch, handleReset };
-};

package/template/.agents/skills/page-skeleton/examples/StandardListPage/hooks/useRuleActions.ts

@@ -1,65 +0,0 @@
-import { computed } from 'vue';
-import { message } from 'ant-design-vue';
-import type { YTableActionConfig } from '@yss-ui/components';
-import { getApiApi } from '@/api/generated/quality';
-import type { QualityRuleItem } from '../constant';
-
-const { deleteQualityRule } = getApiApi();
-
-/** 行操作与页面容器的通信回调。 */
-export interface RuleActionCallbacks {
-  refreshList: () => Promise<void>;
-  onCreate: () => void;
-  onEdit: (row: QualityRuleItem) => void;
-  onView: (row: QualityRuleItem) => void;
-}
-
-/** YTable 气泡确认助手。 */
-interface ActionHelpers {
-  close: () => void;
-  hideLoading: () => void;
-}
-
-/** 管理质量规则行操作和 YTable 操作列配置。 */
-export const useRuleActions = (callbacks: RuleActionCallbacks) => {
-  /** 删除规则并刷新列表。 */
-  const handleDelete = async (row: QualityRuleItem): Promise<void> => {
-    if (!row.id) return;
-
-    try {
-      await deleteQualityRule(row.id);
-      message.success('删除成功');
-      await callbacks.refreshList();
-    } catch {
-      // mutator 已展示错误，此处不重复 message.error。
-    }
-  };
-
-  /** 标准操作列：查看/编辑立即执行，删除使用气泡确认。 */
-  const actionConfig = computed<YTableActionConfig>(() => ({
-    title: '操作',
-    width: 180,
-    fixed: 'right',
-    buttons: [
-      { label: '查看', value: 'view', click: ({ row }) => callbacks.onView(row) },
-      { label: '编辑', value: 'edit', click: ({ row }) => callbacks.onEdit(row) },
-      {
-        label: '删除',
-        value: 'delete',
-        type: 'link',
-        isConfirm: true,
-        confirmProps: { title: '确认删除此规则吗？删除后无法恢复', needLoading: true },
-        click: async ({ row }, _button, helpers: ActionHelpers) => {
-          try {
-            await handleDelete(row);
-          } finally {
-            helpers.hideLoading();
-            helpers.close();
-          }
-        },
-      },
-    ],
-  }));
-
-  return { actionConfig, handleCreate: callbacks.onCreate };
-};

package/template/.agents/skills/page-skeleton/examples/StandardListPage/index.vue

@@ -1,91 +0,0 @@
-<script setup lang="ts">
-import { onMounted, ref } from 'vue';
-import { Input as AInput } from 'ant-design-vue';
-import { YButton, YCard, YTable } from '@yss-ui/components';
-import { useTableHeight } from '@yss-ui/hooks';
-import { TABLE_COLUMNS, type QualityRuleItem } from './constant';
-import { useQualityRuleList } from './hooks/useQualityRuleList';
-import { useRuleActions } from './hooks/useRuleActions';
-
-defineOptions({ name: 'StandardListPage' });
-
-const emit = defineEmits<{
-  create: [];
-  edit: [row: QualityRuleItem];
-  view: [row: QualityRuleItem];
-}>();
-
-const tableAreaRef = ref<HTMLDivElement>();
-const { tableHeight, isReady } = useTableHeight(tableAreaRef, {
-  withPagination: true,
-  withToolbar: true,
-});
-const { tableData, loading, pagination, searchForm, fetchList, handlePageChange, handleSearch, handleReset } =
-  useQualityRuleList();
-const { actionConfig, handleCreate } = useRuleActions({
-  refreshList: fetchList,
-  onCreate: () => emit('create'),
-  onEdit: row => emit('edit', row),
-  onView: row => emit('view', row),
-});
-
-/** 查看规则详情。 */
-const handleRuleNameClick = (row: QualityRuleItem): void => {
-  emit('view', row);
-};
-
-onMounted(() => {
-  void fetchList();
-});
-</script>
-
-<template>
-  <div class="quality-rule-page">
-    <YCard class="quality-rule-page__search-card">
-      <div class="quality-rule-page__search-content">
-        <AInput
-          v-model:value="searchForm.ruleName"
-          class="quality-rule-page__keyword"
-          placeholder="请输入规则名称"
-          allow-clear
-          @press-enter="handleSearch"
-        />
-        <div class="quality-rule-page__search-actions">
-          <YButton @click="handleReset">重置</YButton>
-          <YButton type="primary" :loading="loading" @click="handleSearch">查询</YButton>
-        </div>
-      </div>
-    </YCard>
-
-    <YCard class="quality-rule-page__table-card">
-      <div ref="tableAreaRef" class="quality-rule-page__table-area">
-        <YTable
-          v-if="isReady"
-          :data="tableData"
-          :columns="TABLE_COLUMNS"
-          :loading="loading"
-          :height="tableHeight"
-          :action-config="actionConfig"
-          :toolbar-config="{ custom: true }"
-          pageable
-          v-model:pagination="pagination"
-          @page-change="handlePageChange"
-        >
-          <template #toolbar-right>
-            <YButton @click="fetchList">刷新</YButton>
-            <YButton type="primary" @click="handleCreate">新增质量规则</YButton>
-          </template>
-          <template #ruleName="{ row }">
-            <button class="quality-rule-page__rule-link" type="button" @click="handleRuleNameClick(row)">
-              {{ row.ruleName ?? '-' }}
-            </button>
-          </template>
-        </YTable>
-      </div>
-    </YCard>
-  </div>
-</template>
-
-<style scoped lang="less">
-@import url('./style.less');
-</style>

package/template/.agents/skills/page-skeleton/examples/StandardListPage/style.less

@@ -1,49 +0,0 @@
-.quality-rule-page {
-  display: flex;
-  flex-direction: column;
-  width: 100%;
-  height: 100%;
-  min-height: 0;
-  gap: 12px;
-
-  &__search-content {
-    display: flex;
-    flex-direction: column;
-    gap: 12px;
-  }
-
-  &__keyword {
-    width: min(100%, 360px);
-  }
-
-  &__search-actions {
-    display: flex;
-    justify-content: flex-end;
-    gap: 8px;
-  }
-
-  &__table-card,
-  &__table-area {
-    flex: 1;
-    min-height: 0;
-  }
-
-  &__rule-link {
-    padding: 0;
-    color: var(--primary-color, #3371ff);
-    background: transparent;
-    border: 0;
-    cursor: pointer;
-
-    &:hover,
-    &:focus-visible {
-      color: var(--primary-color-hover, #4096ff);
-      text-decoration: underline;
-    }
-
-    &:focus-visible {
-      outline: 2px solid color-mix(in srgb, var(--primary-color, #3371ff) 35%, transparent);
-      outline-offset: 2px;
-    }
-  }
-}

package/template/.agents/skills/vue3-best-practices/SKILL.md

@@ -1,68 +0,0 @@
----
-name: vue3-best-practices
-description: 在 Vue3 业务页面、组件和 composable 中规范响应式状态、组件通信、异步竞态与大数精度；实现或重构 Vue3 逻辑时使用。
----
-
-# Vue3 Best Practices Skill
-
-## 触发条件
-
-- 业务页面出现响应式、组件通信、状态管理相关问题。
-- 需要重构复杂组件逻辑到更稳的 Composition API 模式。
-- 需要防止 `v-model`、`watch`、`reactive/ref` 常见误用。
-
-## 不适用场景
-
-- 纯样式调整，无状态逻辑修改。
-- 仅写提交信息，不涉及代码实现。
-- 仅做接口层封装，不涉及 Vue 组件行为。
-
-## 硬约束（禁止/必须）
-
-- 禁止直接修改 `props`，必须使用 `emit('update:xxx')`。
-- 禁止在模板层写复杂业务逻辑，必须下沉到 `computed` 或 hook。
-- 必须避免深层 watch 滥用，优先明确依赖源。
-- 必须对异步请求做取消或竞态保护，避免旧请求覆盖新状态。
-- 必须在复杂页面中拆 composable，禁止单文件耦合所有逻辑。
-- 导出函数、composable、接口、类型与常量必须使用中文 JSDoc。
-- 接口默认错误由 mutator 统一提示并 reject；业务逻辑只做状态恢复或错误转换，禁止在 `catch` 重复 `message.error`，除非请求显式设置了 `skipErrorHandler`。
-- 在 hook/computed/watch 等业务逻辑里使用接口返回的 number 字段（id、主键、金额、数量等）时，禁止用 `Number()`/`parseInt`/`parseFloat`/`+x`/`*1`/`~~` 做任何数字转换，一律按字符串透传与比较；确需高精度数值计算时用 `decimal.js`/`big.js` 以字符串入参。底层 json-bigint 已存为字符串保精度，详见 `../yss-api-integration/SKILL.md`「大数字与精度」。
-
-## 标准代码骨架
-
-```typescript
-const props = defineProps<{ modelValue: string }>();
-const emit = defineEmits<{ 'update:modelValue': [value: string] }>();
-
-const localValue = computed({
-  get: () => props.modelValue,
-  set: value => emit('update:modelValue', value),
-});
-
-const loading = ref(false);
-
-/** 请求数据并维护加载状态。 */
-const fetchData = async () => {
-  loading.value = true;
-  try {
-    await api();
-  } finally {
-    loading.value = false;
-  }
-};
-```
-
-## 交付检查清单
-
-- [ ] `props` 单向数据流未被破坏。
-- [ ] `v-model` 实现使用标准 `update:*` 事件。
-- [ ] 异步逻辑具备 loading 与异常处理。
-- [ ] 复杂逻辑已拆分到 composable。
-- [ ] 接口返回的 number 字段在逻辑中保持字符串透传，未被 `Number()`/`parseInt`/`+x` 等转换。
-- [ ] 模板表达式简洁，便于维护和测试。
-
-## 失败兜底策略
-
-- 响应式异常时，先定位是 `ref`/`reactive` 选型问题还是解构丢响应。
-- 双向绑定异常时，先检查 `emit` 事件名和参数签名。
-- 组件过重时，先抽离状态 hook，再处理视觉拆分。

package/template/.agents/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-parent/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Scaffold Parent"
-  short_description: "YSS 后端脚手架父工程、依赖与公共约定实践落地规范"
-  default_prompt: "Use $yss-backend-scaffold-parent to set up the parent project and shared conventions for a YSS backend scaffold."

package/template/.agents/skills/yss-mvc-data-analysis-project-initializer/SKILL.md

@@ -1,22 +0,0 @@
----
-name: yss-mvc-data-analysis-project-initializer
-description: 在生命周期批准的初始化合同下创建独立 Git 管理的数据分析 project-instance；固定 mvc-data-analysis-v1 六模块、Java 8 和本地测试 H2。
----
-
-# 数据分析 MVC 项目初始化
-
-这是 `work-unit.service-project-initialization` 的执行器，不是通用 MVC 脚手架。通用 MVC 使用 `yss-layered-mvc-scaffold-generator`；DDD 使用 `yss-ddd-scaffold-generator`。历史数据分析初始化入口不提供自动别名，迁移关系只在 `docs/agents/skill-migrations.md` 记录。
-
-## 执行合同
-
-- 必须有生命周期批准且当前的 schema v4 scaffold contract，绑定 `architecture_profile=mvc-data-analysis-v1`、本生成器、已批准的架构决策、Technical Design、Data Architecture Decision v1 和真实工程合同批准记录。
-- 固定 server/core/client/repository/adapter/feign-client；core 是薄应用层，规则见 `docs/agents/backend-architecture-profiles.md`。不生成业务接口、SQL、DDL、Mock、生产数据库配置或额外数据源。
-- `verification_database=h2` / `production_database=not-bound`；Java 8 / Boot 2.7 / javax。目标不存在，禁止覆盖、迁移、自动提交和推送。
-- 合同必须包含 `context_handoff_ref`、`context_handoff_digest`：批准交接的完整根 CONTEXT.md（含 schema frontmatter），不得用跨仓路径替代本仓词汇表。初始化只复制已确认内容，不创造业务术语；父项目只保留服务引用和 handoff 证据。
-- `allowed_write_paths` 必须覆盖目标项目及同级 skillUtils。已有 skillUtils 锁不匹配即 blocked，不替换别的项目正在使用的工具包。
-
-## 命令与结果
-
-`node scripts/generate_project.mjs` 使用通用 MVC 生成器相同的批准合同与 Maven 坐标参数（`--output-dir` 是父容器）；无 `--database`、`--with-mock` 或交互选项。
-
-输出独立 project-instance、初始化但未提交的 main Git、生命周期资产、完整锁定 skillUtils、架构身份及 Manifest。使用共享 `run_scaffold_verification.mjs <project> <evidence>` 实跑三条 Wrapper 命令；只在实际成功后报告 empty-scaffold-verified。Profile 仍须独立首切片 fixture 达标才能晋升 supported。