@minus-ai/create-skill 0.1.0-beta.1

package/templates/frontend-package.json.tpl

@@ -0,0 +1,22 @@
+{
+  "name": "@minus-skill/{{skillId}}-frontend",
+  "private": true,
+  "version": "0.0.1",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b && vite build",
+    "dev": "vite build --watch"
+  },
+  "dependencies": {
+    "sonner": "^2.0.7"
+  },
+  "devDependencies": {
+    "@minus-ai/dev-vite-plugin": "^0.1.0-beta.1",
+    "@types/node": "^20.14.0",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "@vitejs/plugin-react": "^4.3.1",
+    "typescript": "^5.5.0",
+    "vite": "^5.4.0"
+  }
+}

package/templates/gitignore.tpl

@@ -0,0 +1,10 @@
+node_modules/
+.env.local
+__pycache__/
+*.pyc
+.venv/
+static/
+builds/
+dist/
+*.tsbuildinfo
+.minus/dev-ports.json

package/templates/keyword/en-US.json.tpl

@@ -0,0 +1,7 @@
+{
+  "{{namespace}}.step.title": "Result",
+  "{{namespace}}.step.empty": "(empty)",
+  "{{namespace}}.home.placeholder": "Enter keyword, e.g. bluetooth earbuds",
+  "{{namespace}}.home.processing": "Processing…",
+  "{{namespace}}.home.send": "Start"
+}

package/templates/keyword/main.tsx.tpl

@@ -0,0 +1,95 @@
+import { StrictMode, useMemo, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig } from '@minus/widget-framework';
+import { AmazonSearchBar, CountrySelect, SearchSubmitButton, validateKeywords, platformWidgetMessages } from '@minus/platform-widgets';
+import { Toaster } from 'sonner';
+import zhCN from './locales/zh-CN.json';
+import enUS from './locales/en-US.json';
+
+/*
+ * 防御性编码提示（适用于所有 step render 函数）：
+ * - 后端 data 不可信，所有字段都要 ?? 兜底
+ * - 数组：(data.list as T[] | undefined) ?? []
+ * - 字符串：(data.name as string | undefined) ?? ''
+ * - 数字：Number(data.count) || 0
+ * - 嵌套：(data.obj as Record<string, unknown> | undefined)?.field ?? fallback
+ * 框架已有 Error Boundary 兜底，但不应依赖——优先在数据层做防御。
+ */
+function buildSteps(t: (k: string, fb?: string) => string): StepConfig[] {
+  return [
+    {
+      render: ({ data }) => (
+        <div className="minus-default-step-done">
+          {(data.text as string) ?? t('{{namespace}}.step.empty', '(空)')}
+        </div>
+      ),
+    },
+  ];
+}
+
+function Home({ title, description, useCases, tags, onStart }: { title: string; description?: string; useCases?: string[]; tags?: Array<{ code: string; label: string }>; onStart: (input: Record<string, unknown>) => Promise<void> }) {
+  const t = useT();
+  const [value, setValue] = useState('');
+  const [country, setCountry] = useState('US');
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  async function handleSubmit() {
+    if (loading) return;
+    const { keywords, error: kwError } = validateKeywords(value);
+    if (kwError) { setError(t(kwError.key, kwError.fallback, kwError.vars)); return; }
+    setError(null);
+    setLoading(true);
+    try { await onStart({ keywords: keywords.join(','), country }); } finally { setLoading(false); }
+  }
+
+  return (
+    <>
+      <h1>{title}</h1>
+      {description && <p className="minus-skill-hero__subtitle">{description}</p>}
+      {((useCases && useCases.length > 0) || (tags && tags.length > 0)) && (
+        <ul className="minus-skill-hero__use-cases">
+          {useCases?.map((uc, i) => (
+            <li key={`uc-${i}`} className="minus-skill-hero__use-case-chip">{uc}</li>
+          ))}
+          {tags?.map((tag) => (
+            <li key={`tag-${tag.code}`} className="minus-skill-hero__use-case-chip">{tag.label}</li>
+          ))}
+        </ul>
+      )}
+      <AmazonSearchBar
+        onSubmit={handleSubmit}
+        country={<CountrySelect onChange={setCountry} />}
+        input={<textarea value={value} onChange={(e) => { setValue(e.target.value); if (error) setError(null); }} onKeyDown={(e) => { if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); handleSubmit(); } }} placeholder={t('{{namespace}}.home.placeholder', '输入关键词，多个关键词用逗号或换行分隔')} spellCheck={false} disabled={loading} rows={1} />}
+        submit={<SearchSubmitButton />}
+        error={error}
+      />
+    </>
+  );
+}
+
+const rootEl = document.getElementById('root');
+if (!rootEl) throw new Error('#root not found');
+
+const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> });
+
+function SkillRoot() {
+  const t = useT();
+  const steps = useMemo(() => buildSteps(t), [t]);
+  return (
+    <FlowApp
+      steps={steps}
+      renderHome={({ flow, onStart }) => <Home title={flow.title} description={flow.description} useCases={flow.useCases} tags={flow.tags} onStart={onStart} />}
+      renderCompletion={() => null}
+      renderHistoryItem={(entry) => {
+        const inp = entry.entryParams as Record<string, string> | undefined;
+        return {
+          label: inp?.keywords ?? '—',
+          meta: inp?.country || undefined,
+        };
+      }}
+    />
+  );
+}
+
+createRoot(rootEl).render(<StrictMode><I18nProvider messages={skillMessages}><SkillRoot /><Toaster /></I18nProvider></StrictMode>);

package/templates/keyword/pipeline.py.tpl

@@ -0,0 +1,11 @@
+from minus_ai_sdk import Pipeline, PipelineContext, StepOutcome
+
+
+class {{className}}(Pipeline):
+
+    async def step_1(self, ctx: PipelineContext) -> StepOutcome:
+        keywords: str = ctx.entry_params.get("keywords", "")
+        country: str = ctx.entry_params.get("country", "US")
+
+        result = f"Keywords: {keywords} ({country})"
+        return StepOutcome.complete(payload={"text": result})

package/templates/keyword/zh-CN.json.tpl

@@ -0,0 +1,7 @@
+{
+  "{{namespace}}.step.title": "结果",
+  "{{namespace}}.step.empty": "(空)",
+  "{{namespace}}.home.placeholder": "输入关键词，如 bluetooth earbuds",
+  "{{namespace}}.home.processing": "处理中…",
+  "{{namespace}}.home.send": "开始"
+}

package/templates/main.tsx.tpl

@@ -0,0 +1,193 @@
+import { StrictMode, useMemo, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig, type StepRecord } from '@minus/widget-framework';
+import { AmazonSearchBar, CompletionPanel, CountrySelect, SearchSubmitButton, validateAsins, validateKeywords, platformWidgetMessages } from '@minus/platform-widgets';
+import { Toaster } from 'sonner';
+import zhCN from './locales/zh-CN.json';
+import enUS from './locales/en-US.json';
+
+type InputType = 'keyword' | 'asin';
+
+/*
+ * 防御性编码提示（适用于所有 step render 函数）：
+ * - 后端 data 不可信，所有字段都要 ?? 兜底
+ * - 数组：(data.list as T[] | undefined) ?? []
+ * - 字符串：(data.name as string | undefined) ?? ''
+ * - 数字：Number(data.count) || 0
+ * - 嵌套：(data.obj as Record<string, unknown> | undefined)?.field ?? fallback
+ * 框架已有 Error Boundary 兜底，但不应依赖——优先在数据层做防御。
+ */
+function buildSteps(t: (k: string, fb?: string) => string): StepConfig[] {
+  return [
+    {
+      render: ({ data }) => (
+        <div className="minus-default-step-done">
+          {(data.text as string) ?? t('{{namespace}}.step.empty', '(空)')}
+        </div>
+      ),
+    },
+  ];
+}
+
+function Home({
+  title,
+  description,
+  useCases,
+  tags,
+  onStart,
+}: {
+  title: string;
+  description?: string;
+  useCases?: string[];
+  tags?: Array<{ code: string; label: string }>;
+  onStart: (input: Record<string, unknown>) => Promise<void>;
+}) {
+  const t = useT();
+  const [inputType, setInputType] = useState<InputType>('keyword');
+  const [value, setValue] = useState('');
+  const [country, setCountry] = useState('US');
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  async function handleSubmit() {
+    if (loading) return;
+
+    if (inputType === 'asin') {
+      const { asins, error: asinError } = validateAsins(value);
+      if (asinError) {
+        setError(t(asinError.key, asinError.fallback, asinError.vars));
+        return;
+      }
+      setError(null);
+      setLoading(true);
+      try {
+        await onStart({ inputType, value: asins.join(','), country });
+      } finally {
+        setLoading(false);
+      }
+    } else {
+      const { keywords, error: kwError } = validateKeywords(value);
+      if (kwError) {
+        setError(t(kwError.key, kwError.fallback, kwError.vars));
+        return;
+      }
+      setError(null);
+      setLoading(true);
+      try {
+        await onStart({ inputType, value: keywords.join(','), country });
+      } finally {
+        setLoading(false);
+      }
+    }
+  }
+
+  const placeholder = inputType === 'keyword'
+    ? t('{{namespace}}.home.placeholderKeyword', '输入关键词，如 bluetooth earbuds')
+    : t('{{namespace}}.home.placeholderAsin', '输入一个或多个ASIN');
+
+  return (
+    <>
+      <h1>{title}</h1>
+      {description && <p className="minus-skill-hero__subtitle">{description}</p>}
+      {((useCases && useCases.length > 0) || (tags && tags.length > 0)) && (
+        <ul className="minus-skill-hero__use-cases">
+          {useCases?.map((uc, i) => (
+            <li key={`uc-${i}`} className="minus-skill-hero__use-case-chip">{uc}</li>
+          ))}
+          {tags?.map((tag) => (
+            <li key={`tag-${tag.code}`} className="minus-skill-hero__use-case-chip">{tag.label}</li>
+          ))}
+        </ul>
+      )}
+
+      <div style={{ display: 'flex', gap: 0, marginBottom: 16 }}>
+        {(['keyword', 'asin'] as const).map((type) => (
+          <button
+            key={type}
+            onClick={() => { setInputType(type); setValue(''); setError(null); }}
+            style={{
+              padding: '6px 16px',
+              fontSize: 14,
+              border: '1px solid #d1d5db',
+              cursor: 'pointer',
+              background: inputType === type ? '#111827' : '#fff',
+              color: inputType === type ? '#fff' : '#374151',
+              borderRadius: type === 'keyword' ? '6px 0 0 6px' : '0 6px 6px 0',
+              marginLeft: type === 'asin' ? -1 : 0,
+            }}
+          >
+            {t(`{{namespace}}.home.tab.${type}`, type === 'keyword' ? '关键词' : 'ASIN')}
+          </button>
+        ))}
+      </div>
+
+      <AmazonSearchBar
+        onSubmit={handleSubmit}
+        country={<CountrySelect onChange={setCountry} />}
+        input={
+          <input
+            type="text"
+            value={value}
+            onChange={(e) => { setValue(e.target.value); if (error) setError(null); }}
+            placeholder={placeholder}
+            spellCheck={false}
+            disabled={loading}
+          />
+        }
+        submit={<SearchSubmitButton />}
+        error={error}
+      />
+    </>
+  );
+}
+
+const rootEl = document.getElementById('root');
+if (!rootEl) throw new Error('#root not found');
+
+const skillMessages = mergeMessages(
+  platformWidgetMessages,
+  { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> },
+);
+
+function SkillRoot() {
+  const t = useT();
+  const steps = useMemo(() => buildSteps(t), [t]);
+  return (
+    <FlowApp
+      steps={steps}
+      renderHome={({ flow, onStart }) => <Home title={flow.title} description={flow.description} useCases={flow.useCases} tags={flow.tags} onStart={onStart} />}
+      renderCompletion={({ stepHistory }) => {
+        const last = stepHistory.reduce<StepRecord | undefined>(
+          (acc, r) => (acc && acc.stepNumber > r.stepNumber ? acc : r),
+          undefined,
+        );
+        const data = last?.data ?? {};
+        return (
+          <CompletionPanel
+            title={data.title as string | undefined}
+            summary={data.summary as string | undefined}
+            filename={data.filename as string | undefined}
+            fileId={data.fileId as string | undefined}
+            sizeBytes={data.sizeBytes as number | undefined}
+          />
+        );
+      }}
+      renderHistoryItem={(entry) => {
+        const inp = entry.entryParams as Record<string, string> | undefined;
+        return {
+          label: inp?.value ?? '—',
+          meta: inp?.country || undefined,
+        };
+      }}
+    />
+  );
+}
+
+createRoot(rootEl).render(
+  <StrictMode>
+    <I18nProvider messages={skillMessages}>
+      <SkillRoot />
+      <Toaster />
+    </I18nProvider>
+  </StrictMode>,
+);

package/templates/pipeline.py.tpl

@@ -0,0 +1,12 @@
+from minus_ai_sdk import Pipeline, PipelineContext, StepOutcome
+
+
+class {{className}}(Pipeline):
+
+    async def step_1(self, ctx: PipelineContext) -> StepOutcome:
+        input_type: str = ctx.entry_params.get("inputType", "keyword")
+        value: str = ctx.entry_params.get("value", "")
+        country: str = ctx.entry_params.get("country", "US")
+
+        result = f"[{input_type.upper()}] {value} ({country})"
+        return StepOutcome.complete(payload={"text": result})

package/templates/pnpm-workspace.yaml.tpl

@@ -0,0 +1,2 @@
+packages:
+  - frontend

package/templates/pyproject.toml.tpl

@@ -0,0 +1,13 @@
+[project]
+name = "minus-skill-{{skillId}}"
+version = "1.0.0"
+description = "{{description}}"
+requires-python = ">=3.12"
+dependencies = [
+    "minus-ai-sdk-python @ https://minus-ai-dev.oss-cn-shenzhen.aliyuncs.com/sdks/python/minus_ai_sdk_python-0.1.0-py3-none-any.whl",
+    "python-dotenv",
+    "uvicorn[standard]",
+]
+
+[tool.setuptools]
+py-modules = ["pipeline", "server"]

package/templates/root-package.json.tpl

@@ -0,0 +1,18 @@
+{
+  "name": "minus-skill-{{skillId}}",
+  "description": "{{description}}",
+  "private": true,
+  "type": "module",
+  "workspaces": ["frontend"],
+  "scripts": {
+    "dev": "minus-dev-cleanup && mkdir -p .minus && echo $$ > .minus/dev.pid && concurrently -n skill,fe \".venv/bin/uvicorn server:app --port {{port}} --reload --reload-include '*.py' --reload-include '.env.local' --env-file .env.local\" \"cd frontend && pnpm exec vite\"",
+    "build": "cd frontend && pnpm run build"
+  },
+  "devDependencies": {
+    "@minus-ai/dev-vite-plugin": "^0.1.0-beta.1",
+    "concurrently": "^9.1.2"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": ["esbuild"]
+  }
+}

package/templates/server.py.tpl

@@ -0,0 +1,4 @@
+from minus_ai_sdk import SkillApp
+from pipeline import {{className}}
+
+app = SkillApp({{className}}).asgi()

package/templates/tsconfig.json.tpl

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "noEmit": true
+  },
+  "include": ["src"]
+}

package/templates/vite.config.ts.tpl

@@ -0,0 +1,23 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import path from 'node:path';
+import { minusDev } from '@minus-ai/dev-vite-plugin';
+
+export default defineConfig({
+  plugins: [react(), ...minusDev({ localBackend: 'http://localhost:{{port}}' })],
+  build: {
+    target: 'esnext',
+    outDir: path.resolve(__dirname, '../static'),
+    emptyOutDir: true,
+    rollupOptions: {
+      input: {
+        embed: path.resolve(__dirname, 'embed.html'),
+      },
+    },
+  },
+  base: './',
+  server: {
+    host: true,
+    open: false,
+  },
+});

package/templates/zh-CN.json.tpl

@@ -0,0 +1,10 @@
+{
+  "{{namespace}}.step.title": "结果",
+  "{{namespace}}.step.empty": "(空)",
+  "{{namespace}}.home.tab.keyword": "关键词",
+  "{{namespace}}.home.tab.asin": "ASIN",
+  "{{namespace}}.home.placeholderKeyword": "输入关键词，如 bluetooth earbuds",
+  "{{namespace}}.home.placeholderAsin": "输入一个或多个ASIN",
+  "{{namespace}}.home.processing": "处理中…",
+  "{{namespace}}.home.send": "开始"
+}