@doubao-apps/create 0.0.27 → 0.0.28

package/dist/template-starter/README.md

@@ -73,7 +73,7 @@ pnpm run analyze
 项目包含以下 AI 友好的文档：
 
 - **AGENTS.md** - AI Agent 主入口，包含框架概览和导航
-- **.ai/** - 详细开发文档目录
+- **references/** - 详细开发文档目录
   - `guides/` - 开发指南和最佳实践
   - `examples/` - 代码示例
   - `rules/` - 开发规范
@@ -81,23 +81,38 @@ pnpm run analyze
 
 ### 🎯 使用 AI 工具开发
 
-#### 1. 配置系统提示词（推荐）
+#### 1. 安装 AI 上下文与 Skills（推荐）
 
-将系统提示词配置到 AI 工具中，获得最佳开发体验：
+如果你希望在项目中配套安装 Doubao Apps 的 AI 知识库与技能，可使用 CLI：
 
-**步骤**：
-1. 打开 `.ai/guides/system-prompt.md` 文件
-2. 复制完整内容
-3. 粘贴到 AI 工具的系统设置中：
-   - **Claude**: Settings → Custom Instructions
-   - **Copilot**: Settings → Custom Instructions
-   - **Cursor**: Settings → Rules for AI
+```bash
+npm install -g @doubao-apps/ai
+
+# 安装到指定 Agent 的 skill
+doubao-cli skills add doubao-apps-dev --agent codex
+```
+
+其中 `doubao-cli skills add <skill1> [skill2...] --agent <agent>` 用于将一个或多个 skills 安装到指定 AI Agent 的 skills 目录中，适合补充项目开发规范、最佳实践和 API 参考。
+
+- `--agent`：指定目标 Agent，例如 `codex`、`cursor`、`claude-code`
+- `--global`：全局安装到用户目录，而不是当前项目目录
+- `doubao-cli skills list`：查看当前可用的 skills
+- `doubao-cli skills update [--global]`：更新已安装的 skills
+
+常见示例：
+
+```bash
+# 给 Codex 安装 Doubao Apps 开发 skill
+doubao-cli skills add doubao-apps-dev --agent codex
+
+# 一次安装多个 skills
+doubao-cli skills add doubao-apps-dev quality-gate --agent claude-code
+
+# 全局安装到用户目录
+doubao-cli skills add doubao-apps-dev --agent claude-code --global
+```
 
-**效果**：
-- ✅ AI 理解项目结构和框架规则
-- ✅ 生成符合规范的代码
-- ✅ 提供更准确的技术建议
-- ✅ 遵循最佳实践和代码规范
+安装后会生成 Agent 对应的 skills 目录，用于提供开发规则、示例和 API 参考。
 
 #### 2. 高效提问技巧
 
@@ -116,7 +131,7 @@ pnpm run analyze
 #### 3. AI 辅助开发流程
 
 1. **明确需求** - 清楚描述要实现的功能和预期效果
-2. **查阅文档** - 参考 `AGENTS.md` 和 `.ai/` 目录下的文档
+2. **查阅文档** - 参考 `AGENTS.md` 和 `references/` 目录下的文档
 3. **请求 AI 生成** - 使用清晰的提示词让 AI 生成代码
 4. **测试验证** - 运行 `pnpm run dev` 查看效果
 5. **迭代优化** - 根据结果调整需求，继续与 AI 协作
@@ -125,29 +140,29 @@ pnpm run analyze
 
 | 任务 | 文档参考 | AI 提示词示例 |
 |------|---------|--------------|
-| 创建新页面 | `.ai/guides/component-development.md` | "创建一个用户资料页面，包含头像、姓名、邮箱和统计数据" |
-| 创建新卡片 | `.ai/guides/component-development.md` | "创建一个天气卡片 Widget，接收城市名称并展示天气信息" |
-| API 集成 | `.ai/examples/common-patterns.md` | "调用 Bridge API 获取用户位置信息并展示在地图上" |
-| 状态管理 | `.ai/examples/common-patterns.md` | "使用 Context 管理全局主题状态（亮色/暗色模式）" |
-| 页面导航 | `.ai/examples/common-patterns.md` | "打开详情页面并传递商品 ID 参数" |
-| 性能优化 | `.ai/guides/performance-optimization.md` | "优化列表渲染性能，减少不必要的重新渲染" |
-| 问题排查 | `.ai/guides/troubleshooting.md` | "调试页面加载缓慢的问题" |
+| 创建新页面 | `references/guides/component-development.md` | "创建一个用户资料页面，包含头像、姓名、邮箱和统计数据" |
+| 创建新卡片 | `references/guides/component-development.md` | "创建一个天气卡片 Widget，接收城市名称并展示天气信息" |
+| API 集成 | `references/examples/common-patterns.md` | "调用 Bridge API 获取用户位置信息并展示在地图上" |
+| 状态管理 | `references/examples/common-patterns.md` | "使用 Context 管理全局主题状态（亮色/暗色模式）" |
+| 页面导航 | `references/examples/common-patterns.md` | "打开详情页面并传递商品 ID 参数" |
+| 性能优化 | `references/guides/performance-optimization.md` | "优化列表渲染性能，减少不必要的重新渲染" |
+| 问题排查 | `references/guides/troubleshooting.md` | "调试页面加载缓慢的问题" |
 
 ### 📚 快速导航
 
 **入门学习**：
 - 📖 [AGENTS.md](./AGENTS.md) - 从这里开始
-- 🎯 [组件开发](./.ai/guides/component-development.md) - Page 和 Widget 完整指南
-- 💡 [组件基础](./.ai/examples/component-basics.md) - Page vs Widget 对比示例
+- 🎯 [组件开发](./references/guides/component-development.md) - Page 和 Widget 完整指南
+- 💡 [组件基础](./references/examples/component-basics.md) - Page vs Widget 对比示例
 
 **实战参考**：
-- 🔧 [常用模式](./.ai/examples/common-patterns.md) - API 集成、状态管理、页面导航
-- 📋 [最佳实践](./.ai/guides/best-practices.md) - 代码规范和架构设计
-- ⚡ [性能优化](./.ai/guides/performance-optimization.md) - 渲染优化和内存管理
+- 🔧 [常用模式](./references/examples/common-patterns.md) - API 集成、状态管理、页面导航
+- 📋 [最佳实践](./references/guides/best-practices.md) - 代码规范和架构设计
+- ⚡ [性能优化](./references/guides/performance-optimization.md) - 渲染优化和内存管理
 
 **问题解决**：
-- 🔍 [故障排查](./.ai/guides/troubleshooting.md) - 调试技巧和常见问题
-- 📖 [API 参考](./.ai/reference/full-api-list.md) - Framework + Bridge 完整 API
+- 🔍 [故障排查](./references/guides/troubleshooting.md) - 调试技巧和常见问题
+- 📖 [API 参考](./references/reference/open-api.md) - Framework + Bridge 完整 API
 
 ---
 
@@ -174,8 +189,8 @@ pnpm run analyze
 
 - **框架文档**: [Doubao Apps SDK 文档](https://example.com/docs)
 - **Lynx 官方文档**: [https://lynx.bytedance.net/next/llms.txt](https://lynx.bytedance.net/next/llms.txt)
-- **API 参考**: 查看项目内 `.ai/reference/full-api-list.md`
-- **示例代码**: 查看项目内 `.ai/examples/` 目录
+- **API 参考**: 查看项目内 `references/reference/open-api.md`
+- **示例代码**: 查看项目内 `references/examples/` 目录
 
 ---
 
@@ -183,7 +198,7 @@ pnpm run analyze
 
 遇到问题？
 
-1. 查看 **[故障排查指南](./.ai/guides/troubleshooting.md)**
+1. 查看 **[故障排查指南](./references/guides/troubleshooting.md)**
 2. 查阅 **[AGENTS.md](./AGENTS.md)** 获取完整文档导航
 3. 使用 AI 工具并参考 **系统提示词**配置
 4. 联系团队获取支持

package/dist/template-starter/package.json

@@ -6,10 +6,10 @@
     "build": "doubao build"
   },
   "dependencies": {
-    "@doubao-apps/framework": "^0.0.27"
+    "@doubao-apps/framework": "^0.0.28"
   },
   "devDependencies": {
-    "@doubao-apps/kit": "^0.0.27",
+    "@doubao-apps/kit": "^0.0.28",
     "typescript": "5.5.3"
   },
   "version": "0.0.16"