aico-cli 2.1.1 → 2.1.23

package/templates/skills/slidev/references/syntax-block-frontmatter.md

@@ -0,0 +1,39 @@
+---
+name: block-frontmatter
+description: Using YAML code blocks as slide frontmatter for syntax highlighting
+---
+
+# Block Frontmatter
+
+Use a YAML code block as the frontmatter for slides when you need syntax highlighting and formatter support.
+
+## Usage
+
+Instead of traditional frontmatter `---`, use a yaml code block at the start of a slide:
+
+````md
+---
+theme: default
+---
+
+# Slide 1
+
+---
+
+```yaml
+layout: quote
+```
+
+# Slide 2
+
+---
+
+# Slide 3
+````
+
+## Key Points
+
+- Works for per-slide frontmatter only
+- Cannot use for headmatter (first frontmatter of the deck)
+- Provides syntax highlighting in editors
+- Compatible with prettier-plugin-slidev

package/templates/skills/slidev/references/syntax-frontmatter-merging.md

@@ -0,0 +1,49 @@
+---
+name: frontmatter-merging
+description: Priority rules when importing slides with conflicting frontmatter
+---
+
+# Frontmatter Merging
+
+When importing slides, frontmatter from main entry takes priority.
+
+## Example
+
+Main file (`slides.md`):
+```md
+---
+src: ./cover.md
+background: https://sli.dev/bar.png
+class: text-center
+---
+```
+
+Imported file (`cover.md`):
+```md
+---
+layout: cover
+background: https://sli.dev/foo.png
+---
+
+# Cover
+
+Cover Page
+```
+
+## Result
+
+```md
+---
+layout: cover
+background: https://sli.dev/bar.png  # main entry wins
+class: text-center
+---
+
+# Cover
+
+Cover Page
+```
+
+## Priority Rule
+
+Main entry > Imported file for duplicate keys.

package/templates/skills/slidev/references/syntax-importing-slides.md

@@ -0,0 +1,60 @@
+---
+name: importing-slides
+description: Split presentations into multiple files for reusability
+---
+
+# Importing Slides
+
+Split presentations into multiple files for reusability.
+
+## Basic Import
+
+```md
+# Title
+
+This is a normal page
+
+---
+src: ./pages/toc.md
+---
+
+<!-- Content here is ignored -->
+
+---
+
+# Page 4
+
+Another normal page
+```
+
+## Import Specific Slides
+
+Use hash to select slides:
+
+```md
+---
+src: ./another-presentation.md#2,5-7
+---
+```
+
+Imports slides 2, 5, 6, and 7.
+
+## Reuse Slides
+
+Import the same file multiple times:
+
+```md
+---
+src: ./pages/toc.md
+---
+
+<!-- later... -->
+
+---
+src: ./pages/toc.md
+---
+```
+
+## Frontmatter Priority
+
+Main entry frontmatter overrides imported file frontmatter for duplicate keys.

package/templates/skills/slidev/references/syntax-mdc.md

@@ -0,0 +1,51 @@
+---
+name: mdc
+description: MDC (Markdown Components) syntax support
+---
+
+# MDC Syntax
+
+Enhanced Markdown with component and style syntax.
+
+## Enable
+
+```md
+---
+mdc: true
+---
+```
+
+## Inline Styles
+
+```md
+This is a [red text]{style="color:red"}
+```
+
+## Inline Components
+
+```md
+:inline-component{prop="value"}
+```
+
+## Image Attributes
+
+```md
+![](/image.png){width=500px lazy}
+```
+
+## Block Components
+
+```md
+::block-component{prop="value"}
+The **default** slot content
+::
+```
+
+## Use Cases
+
+- Add inline styles without HTML
+- Use Vue components inline
+- Add attributes to images
+- Create complex component layouts
+
+Based on Nuxt's MDC (Markdown Components) syntax.

package/templates/skills/slidev/references/tool-eject-theme.md

@@ -0,0 +1,27 @@
+---
+name: eject-theme
+description: Extract theme to local filesystem for customization
+---
+
+# Eject Theme
+
+Extract installed theme to local filesystem for customization.
+
+## Command
+
+```bash
+slidev theme eject
+```
+
+## Result
+
+- Theme files copied to `./theme/`
+- Frontmatter updated to `theme: ./theme`
+
+## Use Case
+
+- Full control over theme
+- Create new theme based on existing one
+- Customize without modifying node_modules
+
+If creating a derivative theme, credit the original theme and author.

package/templates/skills/tech-whitepaper/SKILL.md

@@ -6,15 +6,62 @@ license: Complete terms in LICENSE.txt
 
 # 技术白皮书生成技能
 
-为软件产品生成专业级纯HTML技术白皮书，具备现代简约设计风格、可视化架构图和交互式图片查看功能。
+为软件产品生成专业级纯 HTML 技术白皮书，具备现代简约设计风格、可视化架构图和交互式图片查看功能。
+
+## ⚠️ 重要：调用前必读
+
+**此技能在生成白皮书时需要两个必需参数**：
+
+1. **file_path**（输出文件路径）
+
+   - 如果用户未指定，**必须先询问用户**或使用默认值：`docs/技术白皮书.html`
+   - 示例：`docs/whitepaper.html`、`技术白皮书.html`
+
+2. **content**（完整的 HTML 内容）
+   - 基于模板生成的完整白皮书内容
+   - 必须先读取模板、分析项目、填充内容后才能生成
+
+**正确的调用流程**：
+
+```
+1. 用户："生成技术白皮书"
+2. AI 询问："请问白皮书要保存到哪个路径？（默认：docs/技术白皮书.html）"
+3. 用户指定路径或确认使用默认
+4. AI 执行：分析项目 → 读取模板 → 生成内容 → 使用 fsWrite(path, text) 写入文件
+```
+
+**错误示例**（会导致 InputValidationError）：
+
+```
+❌ 直接调用写入工具而不提供 file_path 和 content 参数
+❌ 在未确认输出路径的情况下尝试生成
+```
+
+**📚 快速参考**：
+
+- 遇到错误？→ [使用指南](references/usage-guide.md)
+- 需要示例？→ [完整工作流](references/example-workflow.md)
 
 ## 核心能力
 
-1. **设计系统**：统一视觉语言，CSS变量驱动，单栏大留白布局
-2. **架构图**：集成Mermaid流程图，自动渲染技术架构
+1. **设计系统**：统一视觉语言，CSS 变量驱动，单栏大留白布局
+2. **架构图**：集成 Mermaid 流程图，自动渲染技术架构
 3. **图片交互**：悬停放大、点击灯箱查看大图
 4. **响应式**：适配桌面和移动端阅读
 
+## 使用方式
+
+当用户请求生成技术白皮书时，你需要：
+
+1. **询问用户输出路径**（必需）
+
+   - 例如：`docs/whitepaper.html` 或 `技术白皮书.html`
+   - 如果用户未指定，默认使用：`docs/技术白皮书.html`
+
+2. **确认产品名称**（必需）
+   - 从项目 README.md 或 package.json 中提取
+   - 或直接询问用户
+
 ## 使用流程
 
 ### Step 1: 项目分析
@@ -33,47 +80,75 @@ license: Complete terms in LICENSE.txt
 技术白皮书标准章节结构：
 
 1. **产品概述** - 产品定位、核心价值主张
-2. **核心价值/亮点** - 差异化竞争优势（3-6个要点）
+2. **核心价值/亮点** - 差异化竞争优势（3-6 个要点）
 3. **产品组成** - 模块架构、组件说明
 4. **产品生态展望** - 未来规划、扩展能力
 5. **技术架构** - 系统架构图、技术栈详解
-6. **智能体架构**（AI产品）- Agent系统设计
-7. **智能体编排架构**（AI产品）- 工作流引擎
-8. **知识库架构**（AI产品）- RAG/向量/图谱
-9. **智能路由架构**（AI产品）- 模型路由策略
+6. **智能体架构**（AI 产品）- Agent 系统设计
+7. **智能体编排架构**（AI 产品）- 工作流引擎
+8. **知识库架构**（AI 产品）- RAG/向量/图谱
+9. **智能路由架构**（AI 产品）- 模型路由策略
 10. **主要功能** - 功能特性矩阵
 11. **部署场景** - 部署架构、环境要求
 12. **技术支持** - 服务体系、联系方式
 
 ### Step 3: 生成白皮书
 
-使用 [HTML模板](assets/whitepaper-template.html) 作为基础，按以下原则定制：
+**重要**：在生成白皮书前，必须确保有明确的输出路径和内容。
+
+使用 [HTML 模板](assets/whitepaper-template.html) 作为基础，按以下步骤操作：
+
+1. **读取模板文件**
+
+   ```
+   读取 templates/skills/tech-whitepaper/assets/whitepaper-template.html
+   ```
+
+2. **定制内容**
+
+   - 替换 `{{PRODUCT_NAME}}` 为实际产品名称
+   - 填充各章节内容
+   - 嵌入 Mermaid 架构图
+   - 添加项目图片
+
+3. **写入文件**
+   ```
+   使用 fsWrite 工具写入到用户指定的路径
+   参数：
+   - path: 用户指定的输出路径（必需）
+   - text: 完整的HTML内容（必需）
+   ```
 
 **设计原则**：
+
 - 以读者为中心，每个元素服务于信息传达
 - 单栏布局 + 大留白 + 无衬线字体
 - 鲜明品牌色 + 简约扁平化图表
 - 杜绝无意义装饰，全文统一视觉语言
 
-**Mermaid图表**：
-- 使用 `<pre class="mermaid">` 标签（非div）
+**Mermaid 图表**：
+
+- 使用 `<pre class="mermaid">` 标签（非 div）
 - 代码从第一列开始，无缩进
 - 简化节点标签，避免特殊字符
 
 **图片处理**：
+
 - 嵌入项目中所有相关截图
 - 使用 `<figure>` + `<figcaption>` 结构
 - 图片网格用 `.image-grid` 类
 
 **品牌定制**：
+
 - 替换公司名称、产品名称
-- 更新品牌色（修改CSS变量 `--brand-primary` 等）
+- 更新品牌色（修改 CSS 变量 `--brand-primary` 等）
 - 添加演示地址、联系方式
 
 ### Step 4: 输出验证
 
 生成后检查：
-- [ ] Mermaid图表正确渲染（非代码文本）
+
+- [ ] Mermaid 图表正确渲染（非代码文本）
 - [ ] 图片悬停有放大效果
 - [ ] 图片点击打开灯箱
 - [ ] 响应式布局在移动端正常
@@ -81,6 +156,18 @@ license: Complete terms in LICENSE.txt
 
 ## 资源文件
 
-- **assets/whitepaper-template.html** - 完整HTML模板，包含设计系统和交互脚本
+- **assets/whitepaper-template.html** - 完整 HTML 模板，包含设计系统和交互脚本
 - **references/design-system.md** - 设计系统详解与定制指南
-- **references/mermaid-patterns.md** - 常用Mermaid架构图模式
+- **references/mermaid-patterns.md** - 常用 Mermaid 架构图模式
+- **references/usage-guide.md** - ⚠️ 使用指南与错误排查（遇到参数错误时必读）
+- **references/example-workflow.md** - 📝 完整工作流示例与代码参考
+
+## 故障排查
+
+如果遇到 `InputValidationError: The required parameter 'file_path' is missing` 错误：
+
+1. **立即停止**当前操作
+2. **阅读** `references/usage-guide.md` 了解正确流程
+3. **询问用户**输出路径（如果尚未询问）
+4. **按顺序执行**：确认路径 → 读取模板 → 生成内容 → 写入文件
+5. **确保** fsWrite 调用时同时提供 `path` 和 `text` 两个参数

package/templates/skills/tsdown/GENERATION.md

@@ -0,0 +1,5 @@
+# Generation Info
+
+- **Source:** `sources/tsdown`
+- **Git SHA:** `13f1c5dfa73445728c285e7a55d921e748be1e59`
+- **Generated:** 2026-01-28

package/templates/skills/tsdown/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: tsdown
+description: tsdown fast TypeScript library bundler powered by Rolldown and Oxc. Use when bundling TypeScript libraries, configuring entry points, or generating .d.ts declaration files.
+metadata:
+  author: Anthony Fu
+  version: "2026.1.28"
+  source: Generated from https://github.com/rolldown/tsdown, scripts located at https://github.com/antfu/skills
+---
+
+tsdown is a next-generation TypeScript library bundler built on Rolldown and Oxc. It provides blazing-fast builds, automatic `.d.ts` generation, and seamless migration from tsup. Supports Rolldown/Rollup/Unplugin plugins and features smart dependency handling.
+
+> The skill is based on tsdown v0.20.1, generated at 2026-01-28.
+
+**Anthony's Preferences:**
+- Build pure-ESM packages, avoid CJS
+- Always enable `dts` option for type declarations
+- Enable `exports` option for auto-generated package exports
+
+## Core
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Configuration | Config file setup, defineConfig, multiple configs | [core-config](references/core-config.md) |
+| CLI | Command-line interface and options | [core-cli](references/core-cli.md) |
+| Entry Points | Entry files, aliases, glob patterns | [core-entry](references/core-entry.md) |
+
+## Build Options
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Output | Format (ESM/CJS/IIFE/UMD), directory, target, platform | [options-output](references/options-output.md) |
+| Declaration Files | .d.ts generation, isolatedDeclarations, sourcemaps | [options-dts](references/options-dts.md) |
+| Dependencies | External, noExternal, dependency bundling | [options-dependencies](references/options-dependencies.md) |
+| Package Exports | Auto-generating exports, main, module fields | [options-package-exports](references/options-package-exports.md) |
+
+## Features
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Optimization | Tree shaking, minification, sourcemaps | [features-optimization](references/features-optimization.md) |
+| Shims | CJS/ESM compatibility shims | [features-shims](references/features-shims.md) |
+| Unbundle Mode | Bundleless transpile-only builds | [features-unbundle](references/features-unbundle.md) |
+| Watch Mode | Auto-rebuild on file changes | [features-watch](references/features-watch.md) |
+
+## Advanced
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Plugins | Rolldown, Unplugin, Rollup, Vite plugins | [advanced-plugins](references/advanced-plugins.md) |
+| Hooks | Build lifecycle hooks | [advanced-hooks](references/advanced-hooks.md) |
+| Programmatic API | Using tsdown from code | [advanced-programmatic](references/advanced-programmatic.md) |
+| Rolldown Options | Customizing inputOptions and outputOptions | [advanced-rolldown-options](references/advanced-rolldown-options.md) |
+
+## Recipes
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Framework Support | Vue and React library bundling | [recipes-frameworks](references/recipes-frameworks.md) |
+| Migration | Migrating from tsup | [recipes-migration](references/recipes-migration.md) |

package/templates/skills/tsdown/references/advanced-hooks.md

@@ -0,0 +1,87 @@
+---
+name: advanced-hooks
+description: tsdown build lifecycle hooks
+---
+
+# Hooks
+
+Hooks allow extending the build process at specific lifecycle stages.
+
+## Usage
+
+### Object Syntax
+
+```ts
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  hooks: {
+    'build:done': async () => {
+      await doSomething()
+    },
+  },
+})
+```
+
+### Function Syntax
+
+```ts
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  hooks(hooks) {
+    hooks.hook('build:prepare', () => {
+      console.log('Build starting...')
+    })
+  },
+})
+```
+
+## Available Hooks
+
+### `build:prepare`
+
+Invoked before each tsdown build starts. Use for setup tasks.
+
+```ts
+hooks: {
+  'build:prepare': (context) => {
+    console.log('Preparing build...')
+  }
+}
+```
+
+### `build:before`
+
+Invoked before each Rolldown build. Called for each format in dual-format builds.
+
+```ts
+hooks: {
+  'build:before': (context, format) => {
+    console.log(`Building ${format}...`)
+  }
+}
+```
+
+### `build:done`
+
+Invoked after each tsdown build completes. Use for cleanup or post-processing.
+
+```ts
+hooks: {
+  'build:done': async (context) => {
+    await generateDocs()
+    console.log('Build complete!')
+  }
+}
+```
+
+## When to Use Hooks vs Plugins
+
+- **Plugins:** For code transformation, asset handling, virtual modules
+- **Hooks:** For build lifecycle tasks (setup, cleanup, notifications)
+
+<!-- 
+Source references:
+- https://tsdown.dev/advanced/hooks
+-->

package/templates/skills/tsdown/references/advanced-plugins.md

@@ -0,0 +1,97 @@
+---
+name: advanced-plugins
+description: tsdown plugin ecosystem - Rolldown, Unplugin, Rollup, Vite plugins
+---
+
+# Plugins
+
+tsdown uses Rolldown and supports multiple plugin ecosystems.
+
+## Supported Plugin Types
+
+### Rolldown Plugins
+
+Native support for all Rolldown plugins.
+
+### Unplugin
+
+Most `unplugin-*` plugins work seamlessly:
+
+```ts
+import UnpluginVue from 'unplugin-vue/rolldown'
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  plugins: [UnpluginVue({ isProduction: true })],
+})
+```
+
+### Rollup Plugins
+
+Most Rollup plugins work without modification:
+
+```ts
+import SomeRollupPlugin from 'some-rollup-plugin'
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  plugins: [SomeRollupPlugin() as any], // Cast to any for type compatibility
+})
+```
+
+> **Note:** Use `// @ts-expect-error` or `as any` for Rollup plugins with type errors.
+
+### Vite Plugins
+
+May work if they don't rely on Vite-specific internals:
+
+```ts
+import SomeVitePlugin from 'some-vite-plugin'
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  plugins: [SomeVitePlugin() as any],
+})
+```
+
+## Using Plugins
+
+Add to the `plugins` array in config (not available via CLI):
+
+```ts
+import SomePlugin from 'some-plugin'
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  plugins: [SomePlugin()],
+})
+```
+
+## Writing Custom Plugins
+
+Follow Rolldown's plugin API (similar to Rollup):
+
+```ts
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  plugins: [
+    {
+      name: 'my-plugin',
+      transform(code, id) {
+        if (id.endsWith('.txt')) {
+          return `export default ${JSON.stringify(code)}`
+        }
+      },
+    },
+  ],
+})
+```
+
+See [Rolldown Plugin Development Guide](https://rolldown.rs/guide/plugin-development) for details.
+
+<!-- 
+Source references:
+- https://tsdown.dev/advanced/plugins
+-->