@doubao-apps/ai 0.0.25 → 0.0.27

package/README.md

@@ -22,6 +22,19 @@ Claude 用户可额外生成 `CLAUDE.md`：
 doubao-cli add context --agent claude
 ```
 
+安装后的目录结构：
+
+```text
+your-project/
+├── AGENTS.md          # AI Agent 主入口文档
+├── CLAUDE.md          # Claude 专用入口（--agent claude 时生成）
+└── .ai/               # 详细文档目录
+    ├── guides/        # 开发指南
+    ├── rules/         # 开发规则
+    ├── examples/      # 代码示例
+    └── reference/     # API 参考
+```
+
 ### 更新知识库
 
 ```bash
@@ -35,6 +48,14 @@ doubao-cli skills add doubao-apps-dev --agent claude-code
 doubao-cli skills add doubao-apps-dev --agent claude-code --global
 ```
 
+安装后的目录结构（以 claude-code 为例）：
+
+```text
+.claude/skills/doubao-apps-dev/
+├── SKILL.md
+└── .ai/
+```
+
 ### 查看和更新 Skills
 
 ```bash

package/dist/994.js

@@ -1,10 +1,10 @@
-import"node:module";import{fileURLToPath as l}from"node:url";import{dirname as o}from"node:path";import*as e from"node:fs";import*as s from"node:path";import{__webpack_require__ as t}from"./rslib-runtime.js";t.add({"node:fs"(l){l.exports=e},"node:path"(l){l.exports=s},"../../ai/dist/cli.js"(e,s,t){var i=o(l(import.meta.url));let a=t("node:fs"),n=t("node:path"),c={amp:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},"kimi-cli":{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},replit:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},universal:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},antigravity:{projectPath:".agent/skills/",globalPath:"~/.gemini/antigravity/skills/"},augment:{projectPath:".augment/skills/",globalPath:"~/.augment/skills/"},claude:{projectPath:".claude/skills/",globalPath:"~/.claude/skills/"},"claude-code":{projectPath:".claude/skills/",globalPath:"~/.claude/skills/"},openclaw:{projectPath:"skills/",globalPath:"~/.openclaw/skills/"},cline:{projectPath:".agents/skills/",globalPath:"~/.agents/skills/"},codebuddy:{projectPath:".codebuddy/skills/",globalPath:"~/.codebuddy/skills/"},codex:{projectPath:".agents/skills/",globalPath:"~/.codex/skills/"},"command-code":{projectPath:".commandcode/skills/",globalPath:"~/.commandcode/skills/"},continue:{projectPath:".continue/skills/",globalPath:"~/.continue/skills/"},cortex:{projectPath:".cortex/skills/",globalPath:"~/.snowflake/cortex/skills/"},crush:{projectPath:".crush/skills/",globalPath:"~/.config/crush/skills/"},cursor:{projectPath:".agents/skills/",globalPath:"~/.cursor/skills/"},droid:{projectPath:".factory/skills/",globalPath:"~/.factory/skills/"},"gemini-cli":{projectPath:".agents/skills/",globalPath:"~/.gemini/skills/"},"github-copilot":{projectPath:".agents/skills/",globalPath:"~/.copilot/skills/"},goose:{projectPath:".goose/skills/",globalPath:"~/.config/goose/skills/"},junie:{projectPath:".junie/skills/",globalPath:"~/.junie/skills/"},"iflow-cli":{projectPath:".iflow/skills/",globalPath:"~/.iflow/skills/"},kilo:{projectPath:".kilocode/skills/",globalPath:"~/.kilocode/skills/"},"kiro-cli":{projectPath:".kiro/skills/",globalPath:"~/.kiro/skills/"},kode:{projectPath:".kode/skills/",globalPath:"~/.kode/skills/"},mcpjam:{projectPath:".mcpjam/skills/",globalPath:"~/.mcpjam/skills/"},"mistral-vibe":{projectPath:".vibe/skills/",globalPath:"~/.vibe/skills/"},mux:{projectPath:".mux/skills/",globalPath:"~/.mux/skills/"},opencode:{projectPath:".agents/skills/",globalPath:"~/.config/opencode/skills/"},openhands:{projectPath:".openhands/skills/",globalPath:"~/.openhands/skills/"},pi:{projectPath:".pi/skills/",globalPath:"~/.pi/agent/skills/"},qoder:{projectPath:".qoder/skills/",globalPath:"~/.qoder/skills/"},"qwen-code":{projectPath:".qwen/skills/",globalPath:"~/.qwen/skills/"},roo:{projectPath:".roo/skills/",globalPath:"~/.roo/skills/"},trae:{projectPath:".trae/skills/",globalPath:"~/.trae/skills/"},"trae-cn":{projectPath:".trae/skills/",globalPath:"~/.trae-cn/skills/"},windsurf:{projectPath:".windsurf/skills/",globalPath:"~/.codeium/windsurf/skills/"},zencoder:{projectPath:".zencoder/skills/",globalPath:"~/.zencoder/skills/"},neovate:{projectPath:".neovate/skills/",globalPath:"~/.neovate/skills/"},pochi:{projectPath:".pochi/skills/",globalPath:"~/.pochi/skills/"},adal:{projectPath:".adal/skills/",globalPath:"~/.adal/skills/"}};function r(){return n.join(n.join(i,"..","dist"),"skills")}function d(l){return n.join(r(),l)}function g(l){return l.startsWith("~/")?n.join(process.env.HOME||process.env.USERPROFILE||"",l.slice(2)):l}function k(l,o){if(!a.existsSync(l))throw Error(`Source directory not found: ${l}`);for(let e of(a.mkdirSync(o,{recursive:!0}),a.readdirSync(l,{withFileTypes:!0}))){let s=n.join(l,e.name),t=n.join(o,e.name);e.isDirectory()?k(s,t):a.copyFileSync(s,t)}}function p(l){let o={agent:null,global:!1};for(let e=0;e<l.length;e++)("--agent"===l[e]||"-a"===l[e])&&l[e+1]?o.agent=l[++e]:("--global"===l[e]||"-g"===l[e])&&(o.global=!0);return o}function h(l,o){let e=d("doubao-apps-dev"),s=process.cwd();if(!a.existsSync(e))throw Error(`Knowledge source not found. Run build first: ${e}`);let t=n.join(e,"AGENTS.md");a.existsSync(t)&&(a.copyFileSync(t,n.join(s,"AGENTS.md")),console.log("  ✓ AGENTS.md"));let i=n.join(e,".ai");if(a.existsSync(i)&&(k(i,n.join(s,".ai")),console.log("  ✓ .ai/")),"claude"===l){let l=n.join(e,"CLAUDE.md");a.existsSync(l)&&(a.copyFileSync(l,n.join(s,"CLAUDE.md")),console.log("  ✓ CLAUDE.md"))}console.log("\nAI context installed successfully.")}function u(l,o,e){if(!c[o])throw Error(`Unknown agent: "${o}". Supported agents: ${Object.keys(c).join(", ")}`);let s=d(l);if(!a.existsSync(s)){let o=r(),e=a.existsSync(o)?a.readdirSync(o).join(", "):"(none)";throw Error(`Skill "${l}" not found. Available skills: ${e}`)}let t=c[o],i=e?t.globalPath:t.projectPath,p=e?n.join(g(i),l):n.join(process.cwd(),i,l);console.log(`Installing skill "${l}" for ${o}...`),console.log(`  Target: ${p}`),a.existsSync(p)&&a.rmSync(p,{recursive:!0,force:!0}),a.mkdirSync(p,{recursive:!0});let h=n.join(s,"SKILL.md");a.existsSync(h)&&(a.copyFileSync(h,n.join(p,"SKILL.md")),console.log("  ✓ SKILL.md"));let u=n.join(s,".ai");a.existsSync(u)&&(k(u,n.join(p,".ai")),console.log("  ✓ .ai/")),console.log("  ✓ Done")}e.exports={runCli:function(l={}){let o=l.commandName||"doubao-ai",[e,...s]=process.argv.slice(2);if(!e||"--help"===e||"-h"===e)return void console.log(`
+import l from"node:module";let o=l.createRequire(import.meta.url);import{fileURLToPath as e}from"node:url";import{dirname as t}from"node:path";import*as s from"node:fs";import*as a from"node:path";import{__webpack_require__ as i}from"./rslib-runtime.js";i.add({"node:fs"(l){l.exports=s},"node:path"(l){l.exports=a},"../../ai/dist/cli.js"(l,s,a){var i=t(e(import.meta.url));let n=a("node:fs"),r=a("node:path"),c={amp:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},"kimi-cli":{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},replit:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},universal:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},antigravity:{projectPath:".agent/skills/",globalPath:"~/.gemini/antigravity/skills/"},augment:{projectPath:".augment/skills/",globalPath:"~/.augment/skills/"},claude:{projectPath:".claude/skills/",globalPath:"~/.claude/skills/"},"claude-code":{projectPath:".claude/skills/",globalPath:"~/.claude/skills/"},openclaw:{projectPath:"skills/",globalPath:"~/.openclaw/skills/"},cline:{projectPath:".agents/skills/",globalPath:"~/.agents/skills/"},codebuddy:{projectPath:".codebuddy/skills/",globalPath:"~/.codebuddy/skills/"},codex:{projectPath:".agents/skills/",globalPath:"~/.codex/skills/"},"command-code":{projectPath:".commandcode/skills/",globalPath:"~/.commandcode/skills/"},continue:{projectPath:".continue/skills/",globalPath:"~/.continue/skills/"},cortex:{projectPath:".cortex/skills/",globalPath:"~/.snowflake/cortex/skills/"},crush:{projectPath:".crush/skills/",globalPath:"~/.config/crush/skills/"},cursor:{projectPath:".agents/skills/",globalPath:"~/.cursor/skills/"},droid:{projectPath:".factory/skills/",globalPath:"~/.factory/skills/"},"gemini-cli":{projectPath:".agents/skills/",globalPath:"~/.gemini/skills/"},"github-copilot":{projectPath:".agents/skills/",globalPath:"~/.copilot/skills/"},goose:{projectPath:".goose/skills/",globalPath:"~/.config/goose/skills/"},junie:{projectPath:".junie/skills/",globalPath:"~/.junie/skills/"},"iflow-cli":{projectPath:".iflow/skills/",globalPath:"~/.iflow/skills/"},kilo:{projectPath:".kilocode/skills/",globalPath:"~/.kilocode/skills/"},"kiro-cli":{projectPath:".kiro/skills/",globalPath:"~/.kiro/skills/"},kode:{projectPath:".kode/skills/",globalPath:"~/.kode/skills/"},mcpjam:{projectPath:".mcpjam/skills/",globalPath:"~/.mcpjam/skills/"},"mistral-vibe":{projectPath:".vibe/skills/",globalPath:"~/.vibe/skills/"},mux:{projectPath:".mux/skills/",globalPath:"~/.mux/skills/"},opencode:{projectPath:".agents/skills/",globalPath:"~/.config/opencode/skills/"},openhands:{projectPath:".openhands/skills/",globalPath:"~/.openhands/skills/"},pi:{projectPath:".pi/skills/",globalPath:"~/.pi/agent/skills/"},qoder:{projectPath:".qoder/skills/",globalPath:"~/.qoder/skills/"},"qwen-code":{projectPath:".qwen/skills/",globalPath:"~/.qwen/skills/"},roo:{projectPath:".roo/skills/",globalPath:"~/.roo/skills/"},trae:{projectPath:".trae/skills/",globalPath:"~/.trae/skills/"},"trae-cn":{projectPath:".trae/skills/",globalPath:"~/.trae-cn/skills/"},windsurf:{projectPath:".windsurf/skills/",globalPath:"~/.codeium/windsurf/skills/"},zencoder:{projectPath:".zencoder/skills/",globalPath:"~/.zencoder/skills/"},neovate:{projectPath:".neovate/skills/",globalPath:"~/.neovate/skills/"},pochi:{projectPath:".pochi/skills/",globalPath:"~/.pochi/skills/"},adal:{projectPath:".adal/skills/",globalPath:"~/.adal/skills/"}};function d(){try{let l=o.resolve("@byted-doubao-apps/ai-assets/manifest");return r.dirname(l)}catch{return r.join(i,"..","dist")}}function g(){return r.join(d(),"skills")}function k(l){return l.startsWith("~/")?r.join(process.env.HOME||process.env.USERPROFILE||"",l.slice(2)):l}function p(l,o){if(!n.existsSync(l))throw Error(`Source directory not found: ${l}`);for(let e of(n.mkdirSync(o,{recursive:!0}),n.readdirSync(l,{withFileTypes:!0}))){let t=r.join(l,e.name),s=r.join(o,e.name);e.isDirectory()?p(t,s):n.copyFileSync(t,s)}}function u(l){let o={agent:null,global:!1};for(let e=0;e<l.length;e++)("--agent"===l[e]||"-a"===l[e])&&l[e+1]?o.agent=l[++e]:("--global"===l[e]||"-g"===l[e])&&(o.global=!0);return o}function h(l){let o=r.join(r.join(d(),"contexts"),"doubao-apps-dev"),e=process.cwd();if(!n.existsSync(o))throw Error(`Knowledge source not found. Run build first: ${o}`);let t=r.join(o,"AGENTS.md");n.existsSync(t)&&(n.copyFileSync(t,r.join(e,"AGENTS.md")),console.log("  ✓ AGENTS.md"));let s=r.join(o,".ai");if(n.existsSync(s)&&(p(s,r.join(e,".ai")),console.log("  ✓ .ai/")),"claude"===l){let l=r.join(o,"CLAUDE.md");n.existsSync(l)&&(n.copyFileSync(l,r.join(e,"CLAUDE.md")),console.log("  ✓ CLAUDE.md"))}console.log("\nAI context installed successfully.")}function P(l,o,e){if(!c[o])throw Error(`Unknown agent: "${o}". Supported agents: ${Object.keys(c).join(", ")}`);let t=r.join(g(),l);if(!n.existsSync(t)){let o=g(),e=n.existsSync(o)?n.readdirSync(o).join(", "):"(none)";throw Error(`Skill "${l}" not found. Available skills: ${e}`)}let s=c[o],a=e?s.globalPath:s.projectPath,i=e?r.join(k(a),l):r.join(process.cwd(),a,l);for(let e of(console.log(`Installing skill "${l}" for ${o}...`),console.log(`  Target: ${i}`),n.existsSync(i)&&n.rmSync(i,{recursive:!0,force:!0}),n.mkdirSync(i,{recursive:!0}),n.readdirSync(t,{withFileTypes:!0}))){let l=r.join(t,e.name),o=r.join(i,e.name);e.isDirectory()?(p(l,o),console.log(`  ✓ ${e.name}/`)):(n.copyFileSync(l,o),console.log(`  ✓ ${e.name}`))}console.log("  ✓ Done")}l.exports={runCli:function(l={}){let o=l.commandName||"doubao-ai",[e,...t]=process.argv.slice(2);if(!e||"--help"===e||"-h"===e)return void console.log(`
 ${o} - Doubao Apps SDK AI 工具
 
 用法：
   ${o} add context [--agent <agent>]       安装 AI 上下文到当前项目
   ${o} update context                      更新已安装的 AI 上下文
-  ${o} skills add <skill> --agent <agent>  安装 skill 到指定 Agent
+  ${o} skills add <skill1> [skill2...] --agent <agent>  安装一个或多个 skill 到指定 Agent
   ${o} skills list                         查看可用 skills
   ${o} skills update [--global]            更新所有已安装的 skills
 
@@ -22,8 +22,8 @@ ${o} - Doubao Apps SDK AI 工具
   # 更新已安装的 AI 上下文
   ${o} update context
 
-  # 安装 skill 到 Claude Code
-  ${o} skills add doubao-apps-dev --agent claude-code
+  # 安装一个或多个 skill 到 Claude Code
+  ${o} skills add doubao-apps-dev quality-gate --agent claude-code
 
   # 全局安装 skill
   ${o} skills add doubao-apps-dev --agent claude-code --global
@@ -36,6 +36,6 @@ ${o} - Doubao Apps SDK AI 工具
 
 支持的 Agents：
   ${Object.keys(c).join(", ")}
-`);if("add"===e){let[l,...e]=s;"context"!==l&&(console.error(`Unknown target: "${l}". Supported: context`),process.exit(1));let{agent:t}=p(e);console.log(`Installing AI context${t?` (--agent ${t})`:""}...`),h(t,o);return}if("update"===e){let l,e,t,[i]=s;"context"!==i&&(console.error(`Unknown target: "${i}". Supported: context`),process.exit(1)),l=process.cwd(),e=a.existsSync(n.join(l,"AGENTS.md")),t=a.existsSync(n.join(l,"CLAUDE.md")),e||t?(console.log("Updating knowledge base..."),h(t?"claude":null,o)):console.log(`No AI context found in current directory. Run \`${o} add context\` first.`);return}if("skills"===e){let[l,...e]=s;if("list"===l)return void function(){let l=r();if(!a.existsSync(l))return console.log("No skills available. Run build first.");let o=a.readdirSync(l,{withFileTypes:!0}).filter(l=>l.isDirectory()).map(l=>l.name);if(0===o.length)return console.log("No skills available.");for(let e of(console.log("Available skills:"),o)){let o=n.join(l,e,"SKILL.md");console.log(`  - ${e}${a.existsSync(o)?"":" (not built)"}`)}}();if("add"===l){let[l,...s]=e;l||(console.error(`Usage: ${o} skills add <skill-name> --agent <agent>`),process.exit(1));let{agent:t,global:i}=p(s);t||(console.error(`--agent is required. Example: ${o} skills add doubao-apps-dev --agent claude-code`),process.exit(1)),u(l,t,i);return}if("update"===l){let{global:l}=p(e);!function(l){let o=r();if(!a.existsSync(o))return console.log("No skills to update. Run build first.");let e=a.readdirSync(o,{withFileTypes:!0}).filter(l=>l.isDirectory()).map(l=>l.name),s=0;for(let[o,t]of Object.entries(c)){let i=l?t.globalPath:t.projectPath,c=l?g(i):n.join(process.cwd(),i);for(let t of e)a.existsSync(n.join(c,t))&&(u(t,o,l),s++)}0===s?console.log("No installed skills found to update."):console.log(`
-Updated ${s} skill installation(s).`)}(l);return}console.error(`Unknown skills subcommand: "${l}". Use: add, list, update`),process.exit(1)}console.error(`Unknown command: "${e}". Run \`${o} --help\` for usage.`),process.exit(1)}}}});
+`);if("add"===e){let[l,...o]=t;"context"!==l&&(console.error(`Unknown target: "${l}". Supported: context`),process.exit(1));let{agent:e}=u(o);console.log(`Installing AI context${e?` (--agent ${e})`:""}...`),h(e);return}if("update"===e){let l,e,s,[a]=t;"context"!==a&&(console.error(`Unknown target: "${a}". Supported: context`),process.exit(1)),l=process.cwd(),e=n.existsSync(r.join(l,"AGENTS.md")),s=n.existsSync(r.join(l,"CLAUDE.md")),e||s?(console.log("Updating knowledge base..."),h(s?"claude":null)):console.log(`No AI context found in current directory. Run \`${o} add context\` first.`);return}if("skills"===e){let[l,...e]=t;if("list"===l)return void function(){let l=g();if(!n.existsSync(l))return console.log("No skills available. Run build first.");let o=n.readdirSync(l,{withFileTypes:!0}).filter(l=>l.isDirectory()).map(l=>l.name);if(0===o.length)return console.log("No skills available.");for(let e of(console.log("Available skills:"),o)){let o=r.join(l,e,"SKILL.md");console.log(`  - ${e}${n.existsSync(o)?"":" (not built)"}`)}}();if("add"===l){let{agent:l,global:t}=u(e),s=[];for(let l=0;l<e.length;l++){let o=e[l];if("--agent"===o||"-a"===o)l++;else{if("--global"===o||"-g"===o)continue;s.push(o)}}for(let e of(0===s.length&&(console.error(`Usage: ${o} skills add <skill-name>... --agent <agent>`),process.exit(1)),l||(console.error(`--agent is required. Example: ${o} skills add doubao-apps-dev --agent claude-code`),process.exit(1)),s))P(e,l,t);return}if("update"===l){let{global:l}=u(e);!function(l){let o=g();if(!n.existsSync(o))return console.log("No skills to update. Run build first.");let e=n.readdirSync(o,{withFileTypes:!0}).filter(l=>l.isDirectory()).map(l=>l.name),t=0;for(let[o,s]of Object.entries(c)){let a=l?s.globalPath:s.projectPath,i=l?k(a):r.join(process.cwd(),a);for(let s of e)n.existsSync(r.join(i,s))&&(P(s,o,l),t++)}0===t?console.log("No installed skills found to update."):console.log(`
+Updated ${t} skill installation(s).`)}(l);return}console.error(`Unknown skills subcommand: "${l}". Use: add, list, update`),process.exit(1)}console.error(`Unknown command: "${e}". Run \`${o} --help\` for usage.`),process.exit(1)}}}});
 //# sourceMappingURL=994.js.map