@lark-apaas/coding-miaoda-sandbox-skills 0.1.13 → 0.1.15

package/miaoda/creative-to-fullstack/references/artifact-signals.md

@@ -1,12 +1,13 @@
 # 创意产物类型信号表与分类型拆分细则
 
-创意模式产物是 design-html 技术栈的静态工程：`index.html` 为入口，可能带 `components/` 或 `screens/` 目录（`.jsx` 经 `<script type="text/babel">` 在浏览器内编译）。先读 `index.html` 全文 + 目录清单，再按下表判类型。**支持生成的只有前三行**（产品设计=多屏设计稿/移动端 mockup、可交互原型）；报表/deck/动画为产品范围外，判中即停止并告知用户（入口层正常会拦截，此为防御兜底）。若会话上下文提供了「当前选中的设计稿文件」路径，判型与拆分优先以该文件为主入口。
+创意模式产物是 design-html 技术栈的静态工程：`index.html` 为入口，可能带 `components/` 或 `screens/` 目录（`.jsx` 经 `<script type="text/babel">` 在浏览器内编译）。先读 `index.html` 全文 + 目录清单，再按下表判类型。**支持生成的只有三类**：多屏设计稿（artboard）、移动端 mockup、可交互原型；报表 / deck / 图文卡片 / 动画为产品范围外，判中即停止并告知用户（入口层正常会拦截，此为防御兜底）。若会话上下文提供了「当前选中的设计稿文件」路径，判型与拆分优先以该文件为主入口。
 
 ## 类型判定信号表
 
 | 类型 | 判定信号（任一命中） | 实现形态 |
 |------|---------------------|----------|
 | 演示稿（deck） | `<deck-stage>` / 翻页控件 / 每屏是「第 N 页」式幻灯结构 | **范围外，停止并告知** |
+| 图文卡片（social card） | `<card-stage>` / 一组固定竖版 `<section>` 卡片（1080×1440 这类上传规格）+ 每卡独立成图 | **范围外，停止并告知** |
 | 多屏设计稿（artboard） | `<DCArtboard>` / `design-canvas` 缩放壳 / 多画板平铺 + 画板 label | 每画板 → 路由页 |
 | 移动端 mockup | 设备框组件（iOS/Android 壳：`width:390` + 圆角 + 状态栏/灵动岛） + `screens/` 或 `screen-*.jsx` 多屏 | 每屏 → 路由页；框内 tab → 应用导航 |
 | 交互原型 | `useState` / 事件处理驱动页面切换，无画布壳，本身像单页应用 | 按其内部「视图状态」拆路由页 |

package/miaoda-modern/forms-skill/SKILL.md

@@ -9,8 +9,10 @@ Shadcn Form + React Hook Form + Zod 表单开发。
 
 ## Guidelines
 
-- 类型必须用 `z.infer` 推导，禁止手动定义
-- 所有字段必须有默认值
+- 表单类型由 zod schema 推导；所有字段必须有 `defaultValues`；运行时校验用 `zodResolver`
+- 提交到必填 API/service Request 时，submit 的类型边界用业务 Request：Request 类型可读就 `const payload: XxxRequest = { ... }` 逐字段补齐；不可读但函数签名可读用 `Parameters<typeof submit>[0]` 派生
+- 补 `useForm<TFieldValues, TContext, TTransformedValues>` 的泛型参数解决不了这个问题
+- API 合同允许字段可选的查询、筛选、搜索表单，继续提交 `z.infer` 值
 - 必须用 Shadcn 组件，禁止原生 input
 - 同行 FormField 必须等宽
 - 表单提交到必填 API/DTO/Request/interface 前，先读目标 shared/server 类型，在 `handleSubmit` 回调里用 `data` 逐字段构造 typed request（见 Patterns）；不要整体传 `data`、`schema.parse(data)` 或 `.required().parse(data)`，也不要用 `any`/`as` 绕过 TS2322。修完后跑 LSP 或 `typecheck`。
@@ -37,15 +39,34 @@ const studentSchema = z.object({
 
 type StudentFormData = z.infer<typeof studentSchema>;
 
+interface CreateStudentRequest {
+  name: string;
+  age: number;
+  grade: string;
+}
+
+async function createStudent(payload: CreateStudentRequest) {
+  logger.info(payload);
+}
+
 export function StudentForm() {
   const form = useForm<StudentFormData>({
     resolver: zodResolver(studentSchema),
     defaultValues: { name: "", age: 0, grade: "" },
   });
 
+  const handleSubmit = async (values: StudentFormData) => {
+    const payload: CreateStudentRequest = {
+      name: values.name,
+      age: values.age,
+      grade: values.grade,
+    };
+    await createStudent(payload);
+  };
+
   return (
     <Form {...form}>
-      <form onSubmit={form.handleSubmit((data) => logger.info(data))} className="space-y-6">
+      <form onSubmit={form.handleSubmit(handleSubmit)} className="space-y-6">
         <div className="flex flex-wrap gap-4">
           <FormField control={form.control} name="name" render={({ field }) => (
             <FormItem className="flex-1">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-miaoda-sandbox-skills",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Miaoda 合并沙箱 skills 包（包含原 miaoda-skills 的 miaoda / miaoda-modern / miaoda-design / shared 四条业务线）；发布公网 npm，随沙箱运行时经 update-skills 同步到 .agent/skills/",
   "type": "module",
   "files": [
@@ -19,4 +19,4 @@
     "skills"
   ],
   "license": "MIT"
-}
+}