@petercjl/taobao-ai-ops 0.4.6 → 0.4.7

package/README.md

@@ -101,3 +101,13 @@ Each component is an independent `@petercjl` npm package with its own canonical
 当前Agent通过 `dmp-product-report` 节点加载独立报告Skill，按需确认本店锚点。商品资料从橙色淘宝买家浏览器读取，DMP统计从蓝色商家电商浏览器读取；报告包含5张主图、店铺与页面指标，以及经营、推广、人群的四周期对比和8周趋势。子应用负责分析方法、独立模板、原始证据与最终校验。套件统一管理报告包和tbcli，保留独立包的升级边界。
 
 开发者入口：`taobao-ai-ops doctor --node dmp-product-report --json`、`taobao-ai-ops component run dmp-product-report ...`。
+
+## Skill 创建与维护
+
+独立组件 `@petercjl/portable-skill-creator` 提供Skill创建、更新、审查、测试与迁移方法，台账按用户业务流程图展示。当前Agent需要Node.js 22+、Python 3.10+及可动态加载的基础 `skill-creator`。套件管理独立包的安装和显式更新。
+
+> 用 portable-skill-creator 创建一个Skill：【说明业务目标与流程】。
+
+> 用 portable-skill-creator 优化这个Skill：【说明本次调整目标】。
+
+开发者入口：`taobao-ai-ops doctor --node portable-skill-creator --json`、`skill source --name portable-skill-creator --json` 与 `component run portable-skill-creator ...`。组件业务方法和资源由其独立包拥有；套件安装生成完整的独立运行副本。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@petercjl/taobao-ai-ops",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "Independent Taobao AI operations SOP skills with a managed suite lifecycle",
   "repository": {
     "type": "git",

package/skills/taobao-ai-operations/SKILL.md

@@ -9,7 +9,8 @@ Input: an operator's goal, supplied workbooks or authorized data sources, option
 
 ## Main line
 
-1. For a Taobao/Tmall item ID requiring operating, promotion and new/returning-customer analysis, select `dmp-product-report`; its method and standalone report contract are below. Resolve other requested business results with `taobao-ai-ops nodes list --json`. A category/monthly market question uses `category-research`; a search-result workbook and concrete research object use `product-research`. Existing product scope can enter product research directly. If no supported node covers the request, report the missing node.
+1. For creating, updating, reviewing, testing or porting an Agent Skill, select `portable-skill-creator` and follow its exact current main line. Resolve other business requests below.
+   For a Taobao/Tmall item ID requiring operating, promotion and new/returning-customer analysis, select `dmp-product-report`; its method and standalone report contract are below. Resolve other requested business results with `taobao-ai-ops nodes list --json`. A category/monthly market question uses `category-research`; a search-result workbook and concrete research object use `product-research`. Existing product scope can enter product research directly. If no supported node covers the request, report the missing node.
    An explicit request to use `procli` for project/task information, SOP progression, knowledge reuse or result publication uses `project-management`. Preserve this child's explicit-trigger contract; offering project integration does not authorize service reads or writes. For an authorized project-backed research request, resolve the project and read its task context and compiled Wiki before selecting the business research node. Preserve the target profile, exact project/task identities, observation windows, provenance and unresolved questions in the handoff.
    A supplied analysis or compatible ViewModel requiring a reusable HTML report uses `html-report`, whose exact Skill is `compact-commerce-ui`. It supplies reporting methods, not business conclusions; existing category/product outputs keep their own declared contracts.
    A Cloud Hug brand conversion request for supplied detail pages, photography, main KV or SKU images uses `cloud-hug-style-transfer`; its brand-production contract is below.
@@ -108,3 +109,13 @@ For explicit Boardmix file, media or object operations, select `boardmix-tools`.
 ### DMP配套版本迁移
 
 用户授权更新DMP报告和取数链路时，检查当前集合的blocked成员。若报告包0.2与tbcli 0.12因跨兼容版本而保留旧版，使用旧回执和 `collection prepare --accept-component-upgrades tbcli,dmp-product-report` 明确迁移这两个组件；其他不兼容组件维持原选择。核对候选DMP doctor及真实版本后再切换宿主入口。该操作按用户已授权的组件范围执行，不扩大到其他Agent或未选组件。
+
+## Skill 创建与维护
+
+用户要求创建、更新、审查、测试或迁移Skill时，选择 `portable-skill-creator` 节点。独立拥有包为 `@petercjl/portable-skill-creator`（0.2.1+）；创建方法、策略来源、可移植性、业务流程台账和验证规则由该包维护。
+
+通过 `taobao-ai-ops skill source --name portable-skill-creator --json` 解析准确来源，完整读取当前SKILL.md。运行 `taobao-ai-ops doctor --node portable-skill-creator --json` 核对Node、Python及组件版本；当前Agent另外解析并完整读取系统提供的准确逻辑名 `skill-creator`，其缺失返回DEPENDENCY_MISSING，不由套件复制替代。宿主基础Creator解析是运行前置能力，doctor的本地成功不证明它存在。
+
+规范来源在组件npm包内，可使用 `taobao-ai-ops component run portable-skill-creator ...` 运行其实际CLI；本机受管安装副本带有自身 `.runtime`。输入是本次创建/维护意图、可选自然语言流程或脑图、既有资源与知识；输出是子Skill约定的规划、完整资源和验证证据。尊重子Skill当前的规划确认、隐私、独立回归授权和失败恢复规则；来源或能力缺失时停止相应阶段并保留原错误。完成后回到套件主线第4步保留成果、第6步交付。
+
+套件只登记并管理独立组件，普通业务调用保持已安装版本；用户显式更新时获取正式latest。台账按用户熟悉的业务流程图展示。基础Skill创建器仍由当前宿主动态提供。

package/src/component-skill-install.mjs

@@ -0,0 +1,16 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import {spawnSync} from 'node:child_process';
+import {fail} from './core.mjs';
+// Only explicitly registered components delegate complete Skill/runtime materialization.
+// The suite owns selection/transaction recovery; the component owns its installation contract.
+export async function materializeComponentSkill(record,name,destination){
+ if(name!=='portable-skill-creator'||record.package!=='@petercjl/portable-skill-creator')throw fail('UNSUPPORTED_COMPONENT_INSTALLER',name);
+ destination=path.join(await fs.realpath(path.dirname(destination)),path.basename(destination));
+ try{const existing=await fs.readdir(destination);if(existing.length)throw fail('UNMANAGED_TARGET','Component destination must be absent or an empty suite stage');await fs.rmdir(destination);}catch(e){if(e.code!=='ENOENT')throw e;}
+ const result=spawnSync(process.execPath,[record.entry,'skill','install','--agent','suite-managed','--target',destination,'--json'],{encoding:'utf8',timeout:60000,env:{...process.env,PORTABLE_SKILL_UPDATE_CHECK:'0'}});
+ let data;try{data=JSON.parse(result.stdout);}catch{}
+ if(result.status!==0||data?.ok!==true||data.package!==record.package||data.name!==name||data.version!==record.version||data.current!==true||data.verification?.verified!==true)throw fail('COMPONENT_SKILL_INSTALL_FAILED',name,{child:data??result.stderr});
+ await fs.access(path.join(destination,'.runtime','bin','portable-skill-creator.mjs'));
+ return data;
+}

package/src/runtime.mjs

@@ -9,7 +9,7 @@ export function componentEnvironment(id,env=process.env,records=componentRecords
  let reportEntries={};
  if(id==='dmp-product-report'){if(!records.tbcli?.entry)throw fail('COMPONENT_NOT_INSTALLED','DMP report requires the registered tbcli component');reportEntries={DMP_REPORT_TBCLI_ENTRY:records.tbcli.entry,AGENT_PACKAGE_UPDATE_CHECK:'0'};}
  const canvasEntries=id==='competitor-visual-canvas'?Object.fromEntries([['tbcli','TBCLI_ENTRY'],['sealseek-media','SEALSEEK_MEDIA_ENTRY'],['boardmixcli','BOARDMIXCLI_ENTRY']].filter(([key])=>records[key]?.entry).map(([key,variable])=>[variable,records[key].entry])):{};
- return {...env,...canvasEntries,...reportEntries,BOARDMIXCLI_UPDATE_CHECK:'0',TBCLI_UPDATE_CHECK:'0',SYCMCLI_DISABLE_AUTO_UPDATE:'1',SEEDAUDIO_AUTO_UPDATE:'0',SEALSEEK_MEDIA_AUTO_UPDATE:'0',COMPETITOR_CANVAS_AUTO_UPDATE:'0',...(id==='cloud-hug-style-transfer'&&media&&!env.CLOUD_HUG_MEDIA_ROOT?{CLOUD_HUG_MEDIA_ROOT:media.root}:{})};
+ return {...env,...(id==='portable-skill-creator'?{PORTABLE_SKILL_UPDATE_CHECK:'0'}:{}),...canvasEntries,...reportEntries,BOARDMIXCLI_UPDATE_CHECK:'0',TBCLI_UPDATE_CHECK:'0',SYCMCLI_DISABLE_AUTO_UPDATE:'1',SEEDAUDIO_AUTO_UPDATE:'0',SEALSEEK_MEDIA_AUTO_UPDATE:'0',COMPETITOR_CANVAS_AUTO_UPDATE:'0',...(id==='cloud-hug-style-transfer'&&media&&!env.CLOUD_HUG_MEDIA_ROOT?{CLOUD_HUG_MEDIA_ROOT:media.root}:{})};
 }
 export function pythonEnvironment(env=process.env){
  return {...env,PYTHONUTF8:'1',PYTHONIOENCODING:'utf-8',PYTHONDONTWRITEBYTECODE:'1'};
@@ -108,6 +108,14 @@ export async function doctor(id,mode='excel'){
    checks.push({id:'dmp-report-capabilities',ok:result.status===0&&detail.ok===true&&detail.tbcliSnapshot===2&&detail.subjectMode==='target-only'&&detail.tbcliItemSummary===1,value:detail});
   }catch(e){checks.push({id:'dmp-report-dependencies',ok:false,code:e.code??'CAPABILITY_UNAVAILABLE',message:e.message});}
  }
+ if(n.component==='portable-skill-creator'){
+  const record=componentRecord(n.component);
+  const result=spawnSync(process.execPath,[record.entry,'doctor','--json'],{encoding:'utf8',timeout:30000,env:componentEnvironment(n.component)});
+  let detail;try{detail=JSON.parse(result.stdout||result.stderr);}catch{detail={ok:false,code:'COMPONENT_DOCTOR_FAILED'};}
+  const version=record.version?.split('.').map(Number);const supported=version?.length===3&&version.every(Number.isInteger)&&(version[0]>0||version[1]>2||version[1]===2&&version[2]>=1);
+  checks.push({id:'creator-version',ok:Boolean(supported),value:record.version,minimum:'0.2.1'});
+  checks.push({id:'creator-runtime',ok:result.status===0&&detail.ok===true&&detail.package===MANIFEST.components[n.component].package&&detail.version===record.version&&detail.python?.version?.length>=2,value:detail});
+ }
  if(n.component==='competitor-visual-canvas'){
   const record=componentRecord(n.component);
   const result=spawnSync(process.execPath,[record.entry,'doctor','--json'],{encoding:'utf8',timeout:30000,env:componentEnvironment(n.component)});

package/src/skill-manager.mjs

@@ -2,7 +2,8 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import os from 'node:os';
 import {randomUUID,createHash} from 'node:crypto';
-import {PACKAGE,source,nodeVersion,closure,json,stat,fileHashes,digest,fail,stateRoot} from './core.mjs';
+import {materializeComponentSkill} from './component-skill-install.mjs';
+import {MANIFEST,componentRecord,PACKAGE,source,nodeVersion,closure,json,stat,fileHashes,digest,fail,stateRoot} from './core.mjs';
 
 const OWNER='.taobao-ai-ops-managed.json';
 export function targetRoot(opts){
@@ -39,9 +40,11 @@ export async function status(root,n){
  return {...base,mode:'copy',managed:true,state:!same?'modified':meta.sourceDigest===base.sourceDigest?'current':'stale'};
 }
 async function makeCopy(dest,n){
- const files=await fileHashes(source(n));await fs.mkdir(dest,{recursive:true});
- for(const relative of Object.keys(files)){const d=path.join(dest,relative);await fs.mkdir(path.dirname(d),{recursive:true});await fs.copyFile(path.join(source(n),relative),d);}
- await fs.writeFile(path.join(dest,'.suite-install.json'),JSON.stringify({package:PACKAGE.name,skill:n.skill,version:nodeVersion(n),sourceDigest:digest(files),files}),{flag:'wx'});
+ const canonical=await fileHashes(source(n));
+ if(MANIFEST.components[n.component]?.skill_installation==='component-managed')await materializeComponentSkill(componentRecord(n.component),n.skill,dest);
+ else{await fs.mkdir(dest,{recursive:true});for(const relative of Object.keys(canonical)){const d=path.join(dest,relative);await fs.mkdir(path.dirname(d),{recursive:true});await fs.copyFile(path.join(source(n),relative),d);}}
+ const files=await fileHashes(dest);
+ await fs.writeFile(path.join(dest,'.suite-install.json'),JSON.stringify({package:PACKAGE.name,skill:n.skill,version:nodeVersion(n),sourceDigest:digest(canonical),files}),{flag:'wx'});
  await fs.writeFile(path.join(dest,'.install-meta.json'),JSON.stringify({title:n.skill,description:`Taobao AI operations: ${n.id}`}),{flag:'wx'});
 }
 async function restore(backup,dest,inPlace){
@@ -67,7 +70,7 @@ export async function install(opts,options={}){
     if(inPlace)await fs.cp(dest,backup,{recursive:true,errorOnExist:true,force:false});
    }
    const record={dest,backup:await stat(backup)?backup:null,inPlace};changed.push(record);
-   const mode=item.mode==='copy'&&item.managed?'copy':(opts.mode||'auto')==='auto'?(process.platform==='win32'?'copy':'link'):opts.mode;
+   const mode=MANIFEST.components[n.component]?.skill_installation==='component-managed'?'copy':item.mode==='copy'&&item.managed?'copy':(opts.mode||'auto')==='auto'?(process.platform==='win32'?'copy':'link'):opts.mode;
    if(!['link','copy'].includes(mode))throw fail('USAGE','Mode must be auto, link or copy');
    if(inPlace){for(const e of await fs.readdir(dest))await fs.rm(path.join(dest,e),{recursive:true,force:true});}
    if(mode==='link')await fs.symlink(source(n),dest,process.platform==='win32'?'junction':'dir');else await makeCopy(dest,n);

package/src/subscription.mjs

@@ -1,6 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import {spawn} from 'node:child_process';
+import {materializeComponentSkill} from './component-skill-install.mjs';
 import {componentEnvironment} from './runtime.mjs';
 import {ROOT,PACKAGE,MANIFEST,fail,stat,fileHashes} from './core.mjs';
 
@@ -84,7 +85,7 @@ export async function collectionPrepare(opts,services={}){
   const installed=[],records={};
   async function copySkill(name,source,entry,member){
    if(installed.some(s=>s.name===name))throw fail('DUPLICATE_SKILL',name);
-   const destination=path.join(skills,name);await fileHashes(source);await fs.cp(source,destination,{recursive:true,dereference:true});
+   const destination=path.join(skills,name);await fileHashes(source);if(MANIFEST.components[member.id]?.skill_installation==='component-managed')await materializeComponentSkill({entry,package:member.package,version:member.version},name,destination);else await fs.cp(source,destination,{recursive:true,dereference:true});
    installed.push({name,package:member.package,version:member.version,source,directory:destination,runtimeEntry:entry});
   }
   for(const member of plan.members){

package/suite-manifest.json

@@ -18,7 +18,8 @@
       "competitor-visual-canvas",
       "cloud-hug-style-transfer",
       "boardmix-tools",
-      "dmp-product-report"
+      "dmp-product-report",
+      "portable-skill-creator"
     ]
   },
   "nodes": [
@@ -50,7 +51,8 @@
         "1688-product-sourcing",
         "1688-opportunity-sourcing-research",
         "cloud-hug-style-transfer",
-        "dmp-product-report"
+        "dmp-product-report",
+        "portable-skill-creator"
       ],
       "python_imports": [],
       "scripts": [],
@@ -307,6 +309,36 @@
         "tbcli": "0.12.0+; dmp snapshot version 2 target-only subject, automatic owned-item execution context and itemSummary version 1"
       },
       "contract_resolution": "Resolve current exact child Skill and CLI capabilities; preserve the selected merchant/buyer endpoints and returned data availability."
+    },
+    {
+      "id": "portable-skill-creator",
+      "skill": "portable-skill-creator",
+      "component": "portable-skill-creator",
+      "stage": "skill-authoring",
+      "method_version": "portable-skill-creator@0.2",
+      "requires_skills": [],
+      "python_imports": [],
+      "scripts": [],
+      "native_requirements": [
+        "agent.skill.base-creator.resolve"
+      ],
+      "input_contract": {
+        "required": [
+          "Skill creation, update, review or test intent"
+        ],
+        "optional": [
+          "business flow in natural language or diagram",
+          "existing Skill and knowledge sources"
+        ]
+      },
+      "output_contract": {
+        "result": "child-scoped design, complete Skill resources and verification evidence",
+        "state": "child owns business flow, strategies, privacy, run ledger and confirmation boundaries"
+      },
+      "required_component_contracts": {
+        "portable-skill-creator": "0.2.1+; business-flow ledger presentation; Node 22+ and Python 3.10+"
+      },
+      "contract_resolution": "Resolve the exact current child Skill and live CLI; dynamically load the host-provided base skill-creator, preserving the child confirmation and regression boundaries."
     }
   ],
   "tools": {
@@ -382,6 +414,11 @@
       "package": "@petercjl/dmp-product-report",
       "component": "dmp-product-report",
       "role": "DMP product performance, promotion and customer composition report with buyer-page product identity"
+    },
+    "portable-skill-creator": {
+      "package": "@petercjl/portable-skill-creator",
+      "component": "portable-skill-creator",
+      "role": "Skill creation, maintenance, portability QA and business-flow run ledger design"
     }
   },
   "targets": {
@@ -509,6 +546,14 @@
       "skills": [
         "dmp-product-report"
       ]
+    },
+    "portable-skill-creator": {
+      "package": "@petercjl/portable-skill-creator",
+      "bin": "portable-skill-creator",
+      "skills": [
+        "portable-skill-creator"
+      ],
+      "skill_installation": "component-managed"
     }
   }
 }