@optima-chat/dev-skills 0.9.1 → 0.9.3

package/.claude/skills/logs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: "logs"
-description: "当用户请求查看日志、查看服务日志、排查问题、看看日志、检查日志、商品服务日志、后端日志、API日志、正式环境日志、生产环境日志、CI环境日志、开发环境日志、阿里云日志、cn-prod 日志、SAE 日志时，使用此技能。支持 CI、Stage、Prod（AWS ECS/CloudWatch）以及 cn-prod（阿里云 SAE，经 buildbox）四个环境的 commerce-backend、user-auth、agentic-chat、gateway-core、optima-scout、optima-skills 等服务。"
+description: "当用户请求查看日志、查看服务日志、排查问题、看看日志、检查日志、商品服务日志、后端日志、API日志、正式环境日志、生产环境日志、CI环境日志、开发环境日志、阿里云日志、cn-prod 日志、SAE 日志时，使用此技能。支持 CI、Stage、Prod（AWS ECS/CloudWatch）以及 cn-prod（阿里云 SAE/SLS）四个环境的 commerce-backend、user-auth、agentic-chat、gateway-core、optima-scout、optima-skills 等服务。"
 allowed-tools: ["Bash", "SlashCommand"]
 ---
 
@@ -183,10 +183,10 @@ INFO - Database query took 3200ms: SELECT * FROM products WHERE...
 ```
 
 **特点**：
-- 阿里云 **SAE**（cn-beijing），不是 AWS
-- 经 buildbox（`root@47.94.105.163`）调 SAE `DescribeInstanceLog`
-- SAE 未配 SLS → 只取实例**当前 stdout 缓冲**（非历史检索）
-- 技术细节 + service→AppId 映射见 `/logs --help`（第 3 节）
+- 阿里云 **SLS**（日志服务，cn-beijing），不是 AWS CloudWatch
+- ✅ 用 `optima-logs <svc> --env cn-prod` **直连 SLS**（`aliyun sls GetLogs`，公网控制面 API）——免 buildbox 跳板，支持历史检索 + 时间窗（`--since`）+ 关键词（`--grep`）
+- 前置：本机需装 `aliyun` CLI + `aliyun-optima` profile（cn-beijing）
+- 旧的「buildbox → SAE `DescribeInstanceLog` 取当前缓冲」已弃用（缓冲式、重启即丢、不能检索）；技术细节见 `/logs --help`（第 3 节）
 
 ## 支持的服务列表
 

package/bin/helpers/billing-http.ts

@@ -17,6 +17,9 @@ const USER_AUTH_URLS: Record<string, string> = {
 // #201: yzsgo.com 全量迁移 (2026-06-12), 旧 billing-cn.optima.chat 路由已下线
 const CN_PROD_BILLING_URL = 'https://billing-api.yzsgo.com';
 const CN_STAGE_BILLING_URL = 'https://billing-api.stage.optima.chat';
+// cn skills (marketplace) registry — same hardcoded-cn-URL rationale as billing.
+const CN_PROD_SKILLS_URL = 'https://skills.yzsgo.com';
+const CN_STAGE_SKILLS_URL = 'https://skills.stage.optima.chat';
 
 /**
  * Validate the --env flag value at command entry, before any I/O.
@@ -36,11 +39,12 @@ export function validateEnv(env: string): 'stage' | 'prod' {
 }
 
 /**
- * Variant for commands that also support cn-prod — currently grant-balance /
- * grant-subscription, which reach billing + user-auth over HTTPS only.
- * Other commands resolve users via the AWS RDS SSH tunnel, which does not
- * exist for cn-prod (Aliyun VPC-internal RDS) — keep them on validateEnv so a
- * cn-prod typo fails fast instead of dying inside the tunnel setup.
+ * Variant for commands that support all four envs (stage/prod/cn-prod/cn-stage)
+ * because they reach billing / skills / user-auth over HTTPS only — e.g.
+ * grant-balance, grant-subscription, entitlement, account, and optima-plugin
+ * (set-paid/set-default/show). Commands that resolve users via the AWS RDS SSH
+ * tunnel (which does not exist for cn — Aliyun VPC-internal RDS) stay on
+ * validateEnv so a cn typo fails fast instead of dying inside tunnel setup.
  */
 export function validateEnvCnProd(env: string): 'stage' | 'prod' | 'cn-prod' | 'cn-stage' {
   if (env !== 'stage' && env !== 'prod' && env !== 'cn-prod' && env !== 'cn-stage') {
@@ -95,6 +99,8 @@ function getBillingUrl(env: string): string {
 }
 
 function getSkillsUrl(env: string): string {
+  if (env === 'cn-prod') return CN_PROD_SKILLS_URL;
+  if (env === 'cn-stage') return CN_STAGE_SKILLS_URL;
   if (skillsUrlCache[env]) return skillsUrlCache[env];
   const url = fetchInfisicalSecret(env, '/shared-secrets/domain-urls', 'SKILLS_REGISTRY_URL');
   skillsUrlCache[env] = url;

package/bin/helpers/plugin/set-default.ts

@@ -1,4 +1,4 @@
-import { callSkills, validateEnv } from '../billing-http';
+import { callSkills, validateEnvCnProd } from '../billing-http';
 import { confirmIfProd } from '../confirm-prompt';
 
 interface SetDefaultArgs {
@@ -18,7 +18,7 @@ Required:
 
 Optional:
   --yes                  Skip prod confirmation prompt (no-op on stage)
-  --env stage|prod       (default: stage)
+  --env <env>          stage|prod|cn-prod|cn-stage (default: stage)
 
 Note: no skill-sync broadcast — changes what NEW user syncs receive; does not
 retroactively add/remove the plugin for existing users until their next sync.`);
@@ -45,7 +45,7 @@ retroactively add/remove the plugin for existing users until their next sync.`);
 
 export async function runSetDefault(argv: string[]): Promise<void> {
   const args = parseArgs(argv);
-  validateEnv(args.env);
+  validateEnvCnProd(args.env);
 
   await confirmIfProd(
     args.env,

package/bin/helpers/plugin/set-paid.ts

@@ -1,4 +1,4 @@
-import { callSkills, validateEnv } from '../billing-http';
+import { callSkills, validateEnvCnProd } from '../billing-http';
 import { confirmIfProd } from '../confirm-prompt';
 
 interface SetPaidArgs {
@@ -18,7 +18,7 @@ Required:
 
 Optional:
   --yes                Skip prod confirmation prompt (no-op on stage)
-  --env stage|prod     (default: stage)
+  --env <env>          stage|prod|cn-prod|cn-stage (default: stage)
 
 Note: salesUrl is NOT settable here (skills PATCH is strict; salesUrl is
 publish-time-only via plugin.json metadata). When isPaid=true and salesUrl is
@@ -46,7 +46,7 @@ null, the 402 falls back to sales.optima.onl.`);
 
 export async function runSetPaid(argv: string[]): Promise<void> {
   const args = parseArgs(argv);
-  validateEnv(args.env);
+  validateEnvCnProd(args.env);
 
   await confirmIfProd(
     args.env,

package/bin/helpers/plugin/show.ts

@@ -1,4 +1,4 @@
-import { callSkills, validateEnv } from '../billing-http';
+import { callSkills, validateEnvCnProd } from '../billing-http';
 
 interface ShowArgs {
   slug: string;
@@ -13,7 +13,7 @@ Required:
   --slug <slug>
 
 Optional:
-  --env stage|prod   (default: stage)
+  --env <env>          stage|prod|cn-prod|cn-stage (default: stage)
 
 Note: reads the public GET /api/plugins/:slug — shows isPaid, salesUrl, and
 descriptive fields, but NOT defaultForUser / status / trustLevel (public
@@ -36,7 +36,7 @@ endpoint omits them). Returns 404 for non-ACTIVE plugins.`);
 
 export async function runShow(argv: string[]): Promise<void> {
   const args = parseArgs(argv);
-  validateEnv(args.env);
+  validateEnvCnProd(args.env);
   const res = await callSkills(args.env, 'GET', `/api/plugins/${encodeURIComponent(args.slug)}`);
   console.log(JSON.stringify(res.body, null, 2));
 }

package/dist/bin/helpers/billing-http.js

@@ -27,6 +27,9 @@ const USER_AUTH_URLS = {
 // #201: yzsgo.com 全量迁移 (2026-06-12), 旧 billing-cn.optima.chat 路由已下线
 const CN_PROD_BILLING_URL = 'https://billing-api.yzsgo.com';
 const CN_STAGE_BILLING_URL = 'https://billing-api.stage.optima.chat';
+// cn skills (marketplace) registry — same hardcoded-cn-URL rationale as billing.
+const CN_PROD_SKILLS_URL = 'https://skills.yzsgo.com';
+const CN_STAGE_SKILLS_URL = 'https://skills.stage.optima.chat';
 /**
  * Validate the --env flag value at command entry, before any I/O.
  *
@@ -44,11 +47,12 @@ function validateEnv(env) {
     return env;
 }
 /**
- * Variant for commands that also support cn-prod — currently grant-balance /
- * grant-subscription, which reach billing + user-auth over HTTPS only.
- * Other commands resolve users via the AWS RDS SSH tunnel, which does not
- * exist for cn-prod (Aliyun VPC-internal RDS) — keep them on validateEnv so a
- * cn-prod typo fails fast instead of dying inside the tunnel setup.
+ * Variant for commands that support all four envs (stage/prod/cn-prod/cn-stage)
+ * because they reach billing / skills / user-auth over HTTPS only — e.g.
+ * grant-balance, grant-subscription, entitlement, account, and optima-plugin
+ * (set-paid/set-default/show). Commands that resolve users via the AWS RDS SSH
+ * tunnel (which does not exist for cn — Aliyun VPC-internal RDS) stay on
+ * validateEnv so a cn typo fails fast instead of dying inside tunnel setup.
  */
 function validateEnvCnProd(env) {
     if (env !== 'stage' && env !== 'prod' && env !== 'cn-prod' && env !== 'cn-stage') {
@@ -100,6 +104,10 @@ function getBillingUrl(env) {
     return url;
 }
 function getSkillsUrl(env) {
+    if (env === 'cn-prod')
+        return CN_PROD_SKILLS_URL;
+    if (env === 'cn-stage')
+        return CN_STAGE_SKILLS_URL;
     if (skillsUrlCache[env])
         return skillsUrlCache[env];
     const url = (0, infisical_secrets_1.fetchInfisicalSecret)(env, '/shared-secrets/domain-urls', 'SKILLS_REGISTRY_URL');

package/dist/bin/helpers/plugin/set-default.js

@@ -13,7 +13,7 @@ Required:
 
 Optional:
   --yes                  Skip prod confirmation prompt (no-op on stage)
-  --env stage|prod       (default: stage)
+  --env <env>          stage|prod|cn-prod|cn-stage (default: stage)
 
 Note: no skill-sync broadcast — changes what NEW user syncs receive; does not
 retroactively add/remove the plugin for existing users until their next sync.`);
@@ -52,7 +52,7 @@ retroactively add/remove the plugin for existing users until their next sync.`);
 }
 async function runSetDefault(argv) {
     const args = parseArgs(argv);
-    (0, billing_http_1.validateEnv)(args.env);
+    (0, billing_http_1.validateEnvCnProd)(args.env);
     await (0, confirm_prompt_1.confirmIfProd)(args.env, `Action: set defaultForUser=${args.default} on plugin '${args.slug}' (${args.env.toUpperCase()})`, args.yes);
     console.log(`\n🔧 Setting defaultForUser=${args.default} on ${args.slug} (${args.env.toUpperCase()})...`);
     const res = await (0, billing_http_1.callSkills)(args.env, 'PATCH', `/api/admin/plugins/${encodeURIComponent(args.slug)}`, { defaultForUser: args.default });

package/dist/bin/helpers/plugin/set-paid.js

@@ -13,7 +13,7 @@ Required:
 
 Optional:
   --yes                Skip prod confirmation prompt (no-op on stage)
-  --env stage|prod     (default: stage)
+  --env <env>          stage|prod|cn-prod|cn-stage (default: stage)
 
 Note: salesUrl is NOT settable here (skills PATCH is strict; salesUrl is
 publish-time-only via plugin.json metadata). When isPaid=true and salesUrl is
@@ -53,7 +53,7 @@ null, the 402 falls back to sales.optima.onl.`);
 }
 async function runSetPaid(argv) {
     const args = parseArgs(argv);
-    (0, billing_http_1.validateEnv)(args.env);
+    (0, billing_http_1.validateEnvCnProd)(args.env);
     await (0, confirm_prompt_1.confirmIfProd)(args.env, `Action: set isPaid=${args.paid} on plugin '${args.slug}' (${args.env.toUpperCase()})`, args.yes);
     console.log(`\n💰 Setting isPaid=${args.paid} on ${args.slug} (${args.env.toUpperCase()})...`);
     const res = await (0, billing_http_1.callSkills)(args.env, 'PATCH', `/api/admin/plugins/${encodeURIComponent(args.slug)}`, { isPaid: args.paid });

package/dist/bin/helpers/plugin/show.js

@@ -10,7 +10,7 @@ Required:
   --slug <slug>
 
 Optional:
-  --env stage|prod   (default: stage)
+  --env <env>          stage|prod|cn-prod|cn-stage (default: stage)
 
 Note: reads the public GET /api/plugins/:slug — shows isPaid, salesUrl, and
 descriptive fields, but NOT defaultForUser / status / trustLevel (public
@@ -39,7 +39,7 @@ endpoint omits them). Returns 404 for non-ACTIVE plugins.`);
 }
 async function runShow(argv) {
     const args = parseArgs(argv);
-    (0, billing_http_1.validateEnv)(args.env);
+    (0, billing_http_1.validateEnvCnProd)(args.env);
     const res = await (0, billing_http_1.callSkills)(args.env, 'GET', `/api/plugins/${encodeURIComponent(args.slug)}`);
     console.log(JSON.stringify(res.body, null, 2));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/dev-skills",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "Claude Code Skills for Optima development team - cross-environment collaboration tools",
   "main": "index.js",
   "bin": {