@wdyy/skills 0.1.1 → 0.1.3

package/README.md

@@ -31,6 +31,18 @@ wdyy init
 
 `wdyy init` 自动执行 `openspec init`，将 5 个受管理 Skill 安装到 `.agents/skills/`，并在 `docs/bug_record.md` 创建或追加 BUG 记录模板。若目标项目已有 `AGENTS.md`，原文件保持不变，命令将生成 `AGENTS_new.md`；每次运行都会覆盖更新 `.agents/skills/wdyy-*`，但不修改同级自定义 Skill。
 
+### 仅更新已安装的 Skill
+
+发布包含 Skill 更新的新版本后，先升级全局 CLI 包，再在目标项目根目录按需更新一个或全部受管理 Skill：
+
+```bash
+npm install -g @wdyy/skills@latest
+wdyy update-skill wdyy-logging-standard
+wdyy update-skill --all
+```
+
+`wdyy update-skill <skill-name>` 只接受 5 个受管理的 `wdyy-*` Skill，且仅替换指定目录；`--all` 替换全部 5 个受管理 Skill。两种方式都不会写入 `AGENTS.md` 或 `AGENTS_new.md`、追加 `docs/bug_record.md`，也不会执行 `openspec init`。首次初始化或需要重新生成项目规则时，使用 `wdyy init`。
+
 中大型变更先使用 `/opsx:explore` 或 `/opsx:propose <change-name>`，在方案确认后使用 `/opsx:apply`；完成验证后使用 `/opsx:archive`。涉及数据库、内部 API、日志、部署时，按 `AGENTS.md` 的路由加载相应企业 Skill。配置仅从环境变量读取，不得提交秘密或生产环境 `.env`。
 
 ## 固定技术栈
@@ -62,11 +74,14 @@ npm pack --dry-run
 确认身份与组织权限后，发布公开包：
 
 ```bash
+npm login
 npm whoami
 npm org ls wdyy
 npm publish --access public
 ```
 
+`npm whoami` 返回 `E401` 表示当前 CLI 没有有效登录态，应重新执行 `npm login` 后再发布。已成功登录但 `npm publish --access public` 仍返回 `E404` 时，通常表示当前账号没有 `@wdyy` 组织的包创建或发布权限；请由该组织的 Owner 授予权限后重试。不要通过在命令行中传入 access token、验证码或恢复码来规避认证。
+
 同一包名和版本只能发布一次。后续发布必须先升级版本，再重新执行全部发布前验证：
 
 ```bash

package/lib/wdyy-cli.js

@@ -50,21 +50,23 @@ const bugRecordTemplate = '- 日期：yyyy-mm-dd\n- 问题描述：\n- 解决方
 function printHelp() {
   console.log('用法: wdyy init');
   console.log('在当前项目生成 AGENTS 规则、安装 wdyy Skill，并执行 openspec init。');
+  console.log('用法: wdyy update-skill <skill-name> | --all');
+  console.log('仅更新当前项目的一个或全部受管理 wdyy Skill，不执行项目初始化。');
 }
 
-async function installManagedSkills(targetRoot, writtenPaths) {
+async function installManagedSkills(targetRoot, writtenPaths, skillNames = managedSkillNames) {
   const skillsRoot = join(targetRoot, '.agents', 'skills');
   await mkdir(skillsRoot, { recursive: true });
   const temporaryRoot = await mkdtemp(join(skillsRoot, '.wdyy-skills-'));
 
   try {
-    for (const skillName of managedSkillNames) {
+    for (const skillName of skillNames) {
       const source = join(packageRoot, '.well-known', 'skills', skillName);
       const prepared = join(temporaryRoot, skillName);
       await cp(source, prepared, { recursive: true, force: true, errorOnExist: false });
     }
 
-    for (const skillName of managedSkillNames) {
+    for (const skillName of skillNames) {
       const destination = join(skillsRoot, skillName);
       await rm(destination, { recursive: true, force: true });
       await rename(join(temporaryRoot, skillName), destination);
@@ -139,6 +141,30 @@ export async function run(argumentsList) {
     }
   }
 
+  if (argumentsList[0] === 'update-skill') {
+    const skillArguments = argumentsList.slice(1);
+    const skillNames = skillArguments.length === 1 && skillArguments[0] === '--all'
+      ? managedSkillNames
+      : skillArguments.length === 1 && managedSkillNames.includes(skillArguments[0])
+        ? [skillArguments[0]]
+        : null;
+
+    if (!skillNames) {
+      printHelp();
+      return 1;
+    }
+
+    const writtenPaths = [];
+    try {
+      await installManagedSkills(process.cwd(), writtenPaths, skillNames);
+      return 0;
+    } catch (error) {
+      console.error(`Skill 更新失败: ${error.message}`);
+      if (writtenPaths.length > 0) console.error(`已写入路径:\n${writtenPaths.map((path) => `- ${path}`).join('\n')}`);
+      return 1;
+    }
+  }
+
   printHelp();
   return argumentsList.length === 1 && ['--help', '-h'].includes(argumentsList[0]) ? 0 : 1;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdyy/skills",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "企业内部开发 Skill 与项目初始化命令",
   "type": "module",
   "bin": {