@xgent-ai/skills 0.7.8 → 0.7.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/README.md +8 -19
  2. package/bin/xgent-skills.js +23 -55
  3. package/dist/phoenix-diagram/VERSION.json +18 -18
  4. package/dist/phoenix-diagram/bundle/ENGINE.json +18 -18
  5. package/dist/phoenix-diagram/bundle/manifest.json +4 -4
  6. package/dist/phoenix-diagram/bundle/references/migration.md +1 -1
  7. package/dist/phoenix-diagram/bundle/scripts/phoenix-bootstrap.cjs +4 -103
  8. package/dist/phoenix-ui/THIRD-PARTY.json +1 -1
  9. package/dist/phoenix-ui/VERSION.json +19 -19
  10. package/dist/phoenix-ui/bundle/blobs/{567c3f42394f9aee9b048a001016a7ba9d8773d78027f8c995c379886634e719 → 0c95d5c7163bc162cca460e2297ab146e331fd279a738a2055643b45b161c706} +1 -1
  11. package/dist/phoenix-ui/bundle/blobs/{f077545caeb3ecb9f51a3f703a09736ca924869f4b4345c1b1ffbd9bf927a287 → 14bd6a733ce89fcd02bf6dcf0f91378625cb7739a0baaca9cb7611c332ac4580} +1 -1
  12. package/dist/phoenix-ui/bundle/blobs/{125bc7030d7f2ba789d7b1d5f474af34f8902b764e7bc351b98f1f6f55779929 → 14f329a7925311958685a16ba370c4997e924d909091e0977e5d32b3e64ecc4f} +1 -1
  13. package/dist/phoenix-ui/bundle/blobs/{8078b804bea630ed9c4ea07ec2f8ac92aba4128725860a66599eda90390d98f6 → 2b168c9ff212b8daea0d4334c94810458a683cde62f26b985855f8bf3f959db7} +1 -1
  14. package/dist/phoenix-ui/bundle/blobs/{00f4a6a630f31eb05fbdd5725e4a294233d24574bd70f4f32f4597d8256a7c1c → 2fbbc46784d2ab789675941ce81d91822ac00bd5c3e144d06743d0b8ccaccc90} +2 -17
  15. package/dist/phoenix-ui/bundle/blobs/{90f8b07ec12b78e633e306322cda58415aea70d8e0f9ff85bd439361c01dabe1 → 35913e9a7ac47f91c8af70867c71d938aa7f200b562c867fa6a43c4a6209ef61} +1 -1
  16. package/dist/phoenix-ui/bundle/blobs/{0e684572eb98d24b39cd70fa23e66c163178f5a11756dcf8a98fe2335636b33f → 3b62a4d253765fe0bdb180581cf493434d15de94e1b31470c573c0a21ece9e31} +1 -1
  17. package/dist/phoenix-ui/bundle/blobs/{68b454a99ba72c3b9b93ed96c4267847297169f6a5bf321b20e60d637c271068 → 557baa7f9ea3d863f40602f37a85e9af09f9120cfa0669b0b95539774e87b9dc} +1 -1
  18. package/dist/phoenix-ui/bundle/blobs/{c0a70ab2889e5c16e1f09249aefad948ce352c42cfe2b5afb758a4524e1b21b6 → 67fc771aa87556ecc8236c44e76251a41fa4e1809c6ad8c6a1f8eb9de91bb2d7} +1 -1
  19. package/dist/phoenix-ui/bundle/blobs/{88b150cb804bc141b80a5687a091f61b99627155c465a27adb88546ef615af92 → 6b3068f23e684f8566e7f4b069a5554624f479d57ff9073610a0917fe5b5e5af} +1 -1
  20. package/dist/phoenix-ui/bundle/blobs/{61450dbef64859e3136cd17ae3e997134d5df5721d96985c4e07367f38522129 → 6f600dfa082ed593159d3906d108baff9f4cb6bf90817a47429d613a95771d6f} +1 -1
  21. package/dist/phoenix-ui/bundle/blobs/{36310febe3e7bd4c9b21407603f2a04afefdc87b7821758bb47098b1b2876765 → 7bff2e1985a347235ef84b783f801eb3f5872d6e2a8d0278fc8c52c3cd1ac4a4} +1 -1
  22. package/dist/phoenix-ui/bundle/blobs/{e46d63e5f8a6ead1d44c8b6302a0c7247af8585b975ab5715518381777622ede → 821bda87cb9fc9f4349cf5243e18d7b4afc899ee884e33b16007ca3f1f5c9de1} +1 -1
  23. package/dist/phoenix-ui/bundle/blobs/{cadc2daefcf238aab981fa56388381d3d5ab9c0686bb9dd8187035c9933dfcee → 8291ff7c0eef14199f7d209cb8eb5e6643034c1923805b5c7023c93010d7af6e} +1 -1
  24. package/dist/phoenix-ui/bundle/blobs/{6b8d4c71355429a0b16bf367163fea46103a0a99b4e34f87608a39d85b1b980a → 94e595bc8239f72e0f5389f83aa022b18541839fb651d87b5933e89c92836a15} +1 -1
  25. package/dist/phoenix-ui/bundle/blobs/{55277fa15eb4bd2f09bf7bb24c4e79df417b06654b1e10f502c7928b192fd7cc → ba015e8aac17711d7dfbcfce3e8c92190af383af595b9ca58b7df2c0c30ba579} +1 -1
  26. package/dist/phoenix-ui/bundle/blobs/{3625c5c2750f117021232ce81c1e39ac5ef7c21445729327b88cf54dfc937df0 → fddd4bd853ad367d7f755477ee7c5ac3d0d3965c81c8a8e20eb83edc9cb7d43b} +1 -1
  27. package/dist/phoenix-ui/bundle/manifest.json +34 -34
  28. package/docs/phoenix-diagram.md +8 -6
  29. package/{skills/review-ui/references/phoenix-review.md → docs/phoenix-ui-review.md} +7 -12
  30. package/docs/phoenix-ui.md +17 -19
  31. package/package.json +2 -1
  32. package/skills/apply-ui-review/SKILL.md +1 -1
  33. package/skills/optimize-agents-md/SKILL.md +39 -21
  34. package/skills/optimize-agents-md/assets/coding-principles.md +78 -38
  35. package/skills/phoenix-diagram/ENGINE.json +18 -18
  36. package/skills/phoenix-diagram/references/migration.md +1 -1
  37. package/skills/phoenix-diagram/scripts/phoenix-bootstrap.cjs +4 -103
  38. package/skills/phoenix-ui/GENERATED.json +78 -78
  39. package/skills/phoenix-ui/SKILL.md +1 -1
  40. package/skills/phoenix-ui/scripts/ENGINE.json +19 -19
  41. package/skills/phoenix-ui/scripts/phoenix-bootstrap.cjs +2 -17
  42. package/skills/review-ui/SKILL.md +2 -1
  43. package/skills/xgent-init/SKILL.md +1 -1
  44. package/skills/review-ui/references/rules.v1.json +0 -1853
@@ -7,7 +7,7 @@ metadata:
7
7
  internal: true
8
8
  version: 0.1.0
9
9
  source: skills/phoenix-ui/src
10
- source_sha256: 91409c0e7e0eb2e3b013f79a49bc0e897da22cd1adef8fb3eed370a834a79fc9
10
+ source_sha256: 3a90920fc0c5443a5a657a49d83dfc899503fe8f237b5f8272d4143195e62d63
11
11
  ---
12
12
 
13
13
  Phoenix UI provides local design tools for any UI project, including standalone sites, applications, and embedded interfaces. Follow the target project's product truth, accepted direction, and design rules; derive platform and host constraints from that project's own context. Use the command references to create complete, accessible interfaces with a clear visual direction.
@@ -2,38 +2,38 @@
2
2
  "schemaVersion": 1,
3
3
  "distribution": "release",
4
4
  "toolVersion": "0.1.0",
5
- "npmPackageVersion": "0.7.8",
6
- "sourceCommit": "4e2a4e4dccbbceb84152eb93bc74662aa4b759d0",
7
- "sourceTree": "eb87c0c92741ca9a268d570424977f881409f859",
5
+ "npmPackageVersion": "0.7.9",
6
+ "sourceCommit": "7229a8ba08f7d37bc37530e00e4d933903f1b5cf",
7
+ "sourceTree": "8f59135bcd1e6ef1cb1db6974fae9dffac0ff0c7",
8
8
  "sourceState": "dirty",
9
- "sourceInputSha256": "39ffc51ac021550f2ef80f7a2587a1d6f46cfc2c30b6a72ba9705cf2bc95ca21",
9
+ "sourceInputSha256": "3088d11390806058b527f5bbc4b0a4860f34c7cdd52a104d7806f8c46fccf310",
10
10
  "bundleSchema": 1,
11
- "bundleSha256": "637ec2dbcaad98d0765bf0d73fd2fc5935004212288c69f3f5798a13fb584c78",
11
+ "bundleSha256": "edc5115dbdd52a5b834ae242ffd46c76d76e6c24ae10ec2dfc6a13cc0ac28921",
12
12
  "reviewSchema": 1,
13
13
  "engines": {
14
14
  "darwin-arm64": {
15
15
  "asset": "phoenix-ui-darwin-arm64",
16
- "sha256": "7e0ff1a5e492ce23227dbe59aaa0430383ca53427af51cfa64d1a37addc489cb",
17
- "size": 18350304,
18
- "url": "https://download.xgent.ai/vendor/phoenix-ui/v0.7.8/darwin-arm64/phoenix-ui-darwin-arm64"
16
+ "size": 18366832,
17
+ "sha256": "b843dce661874b9ab7a4799c529193a6cdc7415e6a0a78a5a28e5c87072df0eb",
18
+ "url": "https://download.xgent.ai/vendor/phoenix-ui/v0.7.9/ci-41410951647/darwin-arm64/phoenix-ui-darwin-arm64"
19
19
  },
20
20
  "darwin-x64": {
21
21
  "asset": "phoenix-ui-darwin-x64",
22
- "sha256": "8dfad2ee41cfbebb0a17f77d62c93a58098f4e4cb5c05e193519305d73dc6d22",
23
- "size": 20842304,
24
- "url": "https://download.xgent.ai/vendor/phoenix-ui/v0.7.8/darwin-x64/phoenix-ui-darwin-x64"
25
- },
26
- "linux-x64": {
27
- "asset": "phoenix-ui-linux-x64",
28
- "sha256": "85e7f2bbd01983a0c89153602152d68b42e6c21fce314f8b1fc4b7178cf73996",
29
- "size": 22932672,
30
- "url": "https://download.xgent.ai/vendor/phoenix-ui/v0.7.8/linux-x64/phoenix-ui-linux-x64"
22
+ "size": 20858712,
23
+ "sha256": "9af56bc51bdf6096228fe36ffe7096b85ce0653a21a29554938d94f596d48681",
24
+ "url": "https://download.xgent.ai/vendor/phoenix-ui/v0.7.9/ci-41410951647/darwin-x64/phoenix-ui-darwin-x64"
31
25
  },
32
26
  "linux-arm64": {
33
27
  "asset": "phoenix-ui-linux-arm64",
34
- "sha256": "311aefb7b8451bc61b3eb20303b62a5ddf32f658860db90165cfcc716e0523f8",
35
28
  "size": 19768520,
36
- "url": "https://download.xgent.ai/vendor/phoenix-ui/v0.7.8/linux-arm64/phoenix-ui-linux-arm64"
29
+ "sha256": "174507b2150985556544ba7cfb61613d054e9908750defb123b981c54b3ec297",
30
+ "url": "https://download.xgent.ai/vendor/phoenix-ui/v0.7.9/ci-41410951647/linux-arm64/phoenix-ui-linux-arm64"
31
+ },
32
+ "linux-x64": {
33
+ "asset": "phoenix-ui-linux-x64",
34
+ "size": 22950336,
35
+ "sha256": "ec268516406c0660116c9a1c912bad46580916e8645778dccea2942b8f4cb3a2",
36
+ "url": "https://download.xgent.ai/vendor/phoenix-ui/v0.7.9/ci-41410951647/linux-x64/phoenix-ui-linux-x64"
37
37
  }
38
38
  }
39
39
  }
@@ -67,25 +67,13 @@ function projectRoot(start) {
67
67
  const initial = fs.realpathSync(path.resolve(start));
68
68
  let dir = initial;
69
69
  for (;;) {
70
- if (fs.existsSync(path.join(dir, '.phoenix-ui/install/active.json')) || fs.existsSync(path.join(dir, '.git'))) return dir;
70
+ if (['.agents', '.claude', '.cursor', '.gemini', '.github', '.grok'].some(provider => fs.existsSync(path.join(dir, provider, 'skills/phoenix-ui/scripts/ENGINE.json'))) || fs.existsSync(path.join(dir, '.git'))) return dir;
71
71
  const parent = path.dirname(dir);
72
72
  if (parent === dir) return initial;
73
73
  dir = parent;
74
74
  }
75
75
  }
76
76
 
77
- // The transactional installer writes this receipt last. It names the package and
78
- // bundle, not a platform, so one project serves every supported engine target.
79
- function verifyReceipt(project, manifest) {
80
- const file = path.join(project, '.phoenix-ui/install/active.json');
81
- if (!fs.existsSync(file)) return;
82
- const receipt = JSON.parse(fs.readFileSync(file, 'utf8'));
83
- if (receipt.schema_version !== 1 || receipt.manifest?.version !== manifest.data.npmPackageVersion
84
- || receipt.manifest?.sha256 !== manifest.data.bundleSha256) {
85
- throw failure(`Project receipt requires a different Phoenix package. Run @xgent-ai/skills@${receipt.manifest?.version || manifest.data.npmPackageVersion} for this project.`);
86
- }
87
- }
88
-
89
77
  function verifyEngine(file, manifest, target, env = process.env) {
90
78
  const meta = manifest.data.engines[target];
91
79
  if (!meta) throw failure(`This development package has no verified engine for ${target}.`);
@@ -313,13 +301,10 @@ async function main(args, options = {}) {
313
301
  }
314
302
  else releaseDir = path.resolve(args[i]);
315
303
  }
316
- verifyReceipt(project, manifest);
317
304
  const binary = await installEngine(manifest, target, project, releaseDir, env);
318
305
  process.stdout.write(json ? `${JSON.stringify({ status: 'installed', toolVersion: manifest.data.toolVersion, target, binary })}\n` : `Phoenix UI ${manifest.data.toolVersion} ready: ${binary}\n`);
319
306
  return 0;
320
307
  }
321
- // Installer verbs replace or roll back the installed package themselves.
322
- if (!['install', 'migrate'].includes(args[0])) verifyReceipt(project, manifest);
323
308
  const binary = verifyEngine(enginePath(manifest, target, env), manifest, target, env);
324
309
  clearReminders(project, manifest, env);
325
310
  const childEnv = { ...env, PHOENIX_UI_SELF: options.self || process.argv[1], PHOENIX_UI_SKILL_DIR: options.skillDir || path.resolve(__dirname, '..') };
@@ -365,5 +350,5 @@ async function main(args, options = {}) {
365
350
  }
366
351
  }
367
352
 
368
- module.exports = { TARGETS, platformTarget, manifestAt, enginePath, verifyEngine, verifyReceipt, setupCommand, shellQuote, proxyFor, installEngine, sha256, main };
353
+ module.exports = { TARGETS, platformTarget, manifestAt, enginePath, verifyEngine, setupCommand, shellQuote, proxyFor, installEngine, sha256, main };
369
354
  if (require.main === module) main(process.argv.slice(2)).then(code => { process.exitCode = code; }).catch(error => { process.stderr.write(`${error.message}\n`); process.exitCode = 4; });
@@ -52,7 +52,8 @@ RULE @applicability:
52
52
 
53
53
  RULE @tool_independence:
54
54
  MUST: complete_review_using_target_package_real_evidence_and_markdown_reports
55
- MUST_NOT: block_review_due_to_absent_or_incompatible_independent_tools
55
+ MUST_NOT: [block_review_due_to_absent_or_incompatible_independent_tools,
56
+ bind_workflow_to_tool_versions_rule_versions_or_skill_document_hashes]
56
57
 
57
58
  WORKFLOW @review_ui:
58
59
  DO: [read_applicable_rules_and_goal_sources,
@@ -20,7 +20,7 @@ when_to_use: "用户会说「初始化这个 XGENT 仓库」「补上 PRODUCT.md
20
20
 
21
21
  `PRODUCT.md` 与 `DESIGN.md` 分别使用 [references/external-app-PRODUCT.template.md](references/external-app-PRODUCT.template.md) 和 [references/external-app-DESIGN.template.md](references/external-app-DESIGN.template.md)。填槽位前读 [references/fill-guide.md](references/fill-guide.md),保留模板里的 Portal 产品边界与设计规范,不替换成通用设计建议。
22
22
 
23
- `install` 保留 hooks / Phoenix UI 安装,可选步骤直接创建仓根 `AGENTS.md`,不安装本 skill,也不生成产品和设计文档。需要补齐这些文档时显式安装并使用本 skill;非交互 install 用 `--xgent-init` 创建 AGENTS.md,`--force` 也不覆盖已有文件。
23
+ `install` 负责 hooks、settings 与 Phoenix 工具安装,不安装本 skill,也不生成项目文档。需要补齐这些文档时显式安装并使用本 skill。
24
24
 
25
25
  ## 约束
26
26