@kevlns/art-workshop 0.5.0 → 0.5.2

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 (42) hide show
  1. package/AGENTS.md +6 -90
  2. package/README.md +1 -1
  3. package/art-workshop.mjs +15 -9
  4. package/docs/commands.md +116 -8
  5. package/docs/configuration.md +1 -1
  6. package/lib/agent.mjs +19 -34
  7. package/lib/analysis-worker.mjs +5 -2
  8. package/lib/analyze.mjs +27 -20
  9. package/lib/asset-profile.mjs +2 -0
  10. package/lib/candidates.mjs +2 -0
  11. package/lib/conversation.mjs +77 -0
  12. package/lib/core.mjs +3 -17
  13. package/lib/edit.mjs +2 -1
  14. package/lib/errors.mjs +32 -0
  15. package/lib/generate.mjs +2 -1
  16. package/lib/object-format.mjs +112 -0
  17. package/lib/process-identity.mjs +17 -9
  18. package/lib/service.mjs +16 -8
  19. package/lib/settings.mjs +1 -1
  20. package/lib/shared.mjs +10 -9
  21. package/lib/style-contract.mjs +39 -0
  22. package/lib/style-evidence.mjs +39 -0
  23. package/lib/style-lifecycle.mjs +6 -1
  24. package/lib/style-report.mjs +201 -0
  25. package/lib/style-review.mjs +7 -68
  26. package/lib/task-contract.mjs +2 -0
  27. package/lib/tasks.mjs +2 -0
  28. package/lib/templates.mjs +7 -1
  29. package/lib/vision.mjs +16 -6
  30. package/lib/worker-process.mjs +6 -6
  31. package/lib/workspace.mjs +74 -20
  32. package/package.json +3 -5
  33. package/skills/art-workshop/SKILL.md +9 -108
  34. package/skills/art-workshop/references/conversation.md +11 -0
  35. package/skills/art-workshop/references/expression.md +27 -0
  36. package/skills/art-workshop/references/getty.md +76 -0
  37. package/skills/art-workshop/references/project.md +109 -0
  38. package/skills/art-workshop/references/style-discussion.md +27 -0
  39. package/skills/art-workshop/scripts/getty.py +269 -0
  40. package/v-cli.plugin.json +271 -15
  41. package/scripts/sync-skill.mjs +0 -6
  42. /package/{skills/art-workshop → adapters/codex}/agents/openai.yaml +0 -0
@@ -0,0 +1,269 @@
1
+ #!/usr/bin/env python3
2
+ """Getty AAT JSON adapter; Python 3.9+, standard library only."""
3
+
4
+ import argparse
5
+ import hashlib
6
+ import http.client
7
+ import json
8
+ import math
9
+ import os
10
+ from pathlib import Path
11
+ import re
12
+ import socket
13
+ import sys
14
+ import tempfile
15
+ import time
16
+ import urllib.error
17
+ import urllib.parse
18
+ import urllib.request
19
+
20
+ ENDPOINT = "https://services.getty.edu/vocab/reconcile/"
21
+ SCHEMA = "art-workshop/getty-v1"
22
+ CORE_FIELDS = {"preferredTerms": "/aat_prefterm", "variantTerms": "/aat_varterms",
23
+ "scopeNotes": "/aat_notes"}
24
+ HIERARCHY_FIELD = "/aat_hier"
25
+ MAX_BYTES = 5 * 1024 * 1024
26
+ MAX_ERROR_BYTES = 4096
27
+
28
+
29
+ class GettyError(Exception):
30
+ def __init__(self, code, message, *, http_status=None, details=None):
31
+ super().__init__(message)
32
+ self.code = code
33
+ self.http_status, self.details = http_status, details
34
+
35
+ def to_dict(self):
36
+ return {"code": self.code, "message": str(self),
37
+ **({"httpStatus": self.http_status} if self.http_status is not None else {}),
38
+ **({"details": self.details} if self.details else {})}
39
+
40
+
41
+ def encoded(value):
42
+ return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"), allow_nan=False)
43
+
44
+
45
+ def read_json(text):
46
+ return json.loads(text, parse_constant=lambda value: (_ for _ in ()).throw(ValueError(value)))
47
+
48
+
49
+ def validate(value):
50
+ if not isinstance(value, dict) or set(value) - {"queries", "limit"}:
51
+ raise GettyError("INVALID_INPUT", "Expected {queries:[{id?,query,context,properties?}],limit?}")
52
+ limit = value.get("limit", 5)
53
+ if type(limit) is not int or not 1 <= limit <= 10:
54
+ raise GettyError("INVALID_INPUT", "limit must be an integer from 1 to 10")
55
+ queries = value.get("queries")
56
+ if not isinstance(queries, list) or not 1 <= len(queries) <= 10:
57
+ raise GettyError("INVALID_INPUT", "queries must contain 1 to 10 items; split larger batches")
58
+ result, ids = [], set()
59
+ for index, item in enumerate(queries):
60
+ if not isinstance(item, dict) or set(item) - {"id", "query", "context", "properties"}:
61
+ raise GettyError("INVALID_INPUT", "Unknown query fields")
62
+ identifier, query = item.get("id", "q" + str(index)), item.get("query")
63
+ if not isinstance(identifier, str) or not identifier or identifier in ids:
64
+ raise GettyError("INVALID_INPUT", "Query IDs must be nonempty and unique")
65
+ if not isinstance(query, str) or not query.strip():
66
+ raise GettyError("INVALID_INPUT", "query must be a nonempty string")
67
+ context = item.get("context")
68
+ if (not isinstance(context, dict) or not isinstance(context.get("original"), str)
69
+ or not context["original"] or ("target" in context and not isinstance(context["target"], str))):
70
+ raise GettyError("INVALID_INPUT", "context requires original text and an optional target string")
71
+ properties = item.get("properties", {})
72
+ if (not isinstance(properties, dict) or set(properties) - {"note", "broaderExt", "label"}
73
+ or any(not isinstance(v, str) or not v.strip() for v in properties.values())):
74
+ raise GettyError("INVALID_INPUT", "properties accepts nonempty note, broaderExt and label strings")
75
+ ids.add(identifier)
76
+ result.append({**item, "id": identifier, "properties": properties})
77
+ return {"queries": result, "limit": limit}
78
+
79
+
80
+ def transport(params, timeout):
81
+ request = urllib.request.Request(ENDPOINT, data=urllib.parse.urlencode(params).encode("utf-8"), headers={
82
+ "Accept": "application/json", "Content-Type": "application/x-www-form-urlencoded; charset=utf-8",
83
+ "User-Agent": "Vant-Art-Workshop-Getty/1"})
84
+ try:
85
+ with urllib.request.urlopen(request, timeout=timeout) as response:
86
+ data = response.read(MAX_BYTES + 1)
87
+ if len(data) > MAX_BYTES:
88
+ raise GettyError("RESPONSE_TOO_LARGE", "Getty response exceeds 5 MiB")
89
+ return read_json(data.decode("utf-8-sig"))
90
+ except urllib.error.HTTPError as error:
91
+ try:
92
+ details = error.read(MAX_ERROR_BYTES).decode("utf-8", errors="replace")
93
+ except OSError:
94
+ details = None
95
+ finally:
96
+ error.close()
97
+ raise GettyError("HTTP_ERROR", "Getty returned HTTP " + str(error.code),
98
+ http_status=error.code, details=details) from error
99
+ except (TimeoutError, socket.timeout) as error:
100
+ raise GettyError("TIMEOUT", "Getty request timed out") from error
101
+ except urllib.error.URLError as error:
102
+ if isinstance(error.reason, (TimeoutError, socket.timeout)):
103
+ raise GettyError("TIMEOUT", "Getty request timed out") from error
104
+ raise GettyError("NETWORK_ERROR", "Getty connection failed: " + str(error.reason)) from error
105
+ except (OSError, http.client.HTTPException) as error:
106
+ raise GettyError("NETWORK_ERROR", "Getty connection failed: " + str(error)) from error
107
+ except (ValueError, UnicodeError) as error:
108
+ raise GettyError("INVALID_RESPONSE", "Getty did not return valid UTF-8 JSON") from error
109
+
110
+
111
+ class Client:
112
+ def __init__(self, cache_dir, timeout=15, ttl=86400, refresh=False, fetch=transport):
113
+ self.cache_dir, self.timeout, self.ttl = Path(cache_dir), timeout, ttl
114
+ self.refresh, self.fetch, self.warnings = refresh, fetch, []
115
+
116
+ def request(self, params, check):
117
+ # 完整请求精确命中,不裁剪、翻译或归一化检索文字。
118
+ key = hashlib.sha256(encoded({"schema": SCHEMA, "endpoint": ENDPOINT,
119
+ "method": "POST", "params": params}).encode("utf-8")).hexdigest()
120
+ path = self.cache_dir / (key + ".json")
121
+ if not self.refresh and self.ttl > 0:
122
+ try:
123
+ cached = read_json(path.read_text(encoding="utf-8"))
124
+ age = time.time() - cached["fetchedAt"]
125
+ if cached["key"] == key and 0 <= age < self.ttl:
126
+ check(cached["data"])
127
+ return cached["data"], "hit"
128
+ except (OSError, ValueError, KeyError, TypeError, GettyError):
129
+ pass
130
+ data = self.fetch(params, self.timeout)
131
+ check(data)
132
+ if self.ttl > 0:
133
+ temporary = None
134
+ try:
135
+ self.cache_dir.mkdir(parents=True, exist_ok=True)
136
+ with tempfile.NamedTemporaryFile(mode="w", encoding="utf-8", dir=self.cache_dir,
137
+ suffix=".tmp", delete=False) as output:
138
+ temporary = output.name
139
+ output.write(encoded({"key": key, "fetchedAt": time.time(), "data": data}))
140
+ os.replace(temporary, path)
141
+ except OSError:
142
+ self.warnings.append("Cache write failed; live result retained")
143
+ finally:
144
+ if temporary:
145
+ try:
146
+ Path(temporary).unlink(missing_ok=True)
147
+ except OSError:
148
+ pass
149
+ return data, "miss"
150
+
151
+
152
+ def check_candidates(data, keys):
153
+ if not isinstance(data, dict):
154
+ raise GettyError("INVALID_RESPONSE", "Expected Getty reconciliation object")
155
+ for key in keys:
156
+ group = data.get(key)
157
+ if not isinstance(group, dict) or not isinstance(group.get("result"), list):
158
+ raise GettyError("INVALID_RESPONSE", "Missing reconciliation results for " + key)
159
+ for candidate in group["result"]:
160
+ if (not isinstance(candidate, dict)
161
+ or not isinstance(candidate.get("id"), str)
162
+ or not re.fullmatch(r"aat/[0-9]+", candidate["id"])
163
+ or not isinstance(candidate.get("name"), str)
164
+ or type(candidate.get("score")) not in (int, float)
165
+ or not math.isfinite(candidate["score"])
166
+ or type(candidate.get("match")) is not bool):
167
+ raise GettyError("INVALID_RESPONSE", "Malformed AAT candidate")
168
+
169
+
170
+ def check_details(data, ids, fields):
171
+ if not isinstance(data, dict) or not isinstance(data.get("rows"), dict):
172
+ raise GettyError("INVALID_RESPONSE", "Missing Getty detail rows")
173
+ for identifier in ids:
174
+ row = data["rows"].get(identifier)
175
+ if not isinstance(row, dict):
176
+ raise GettyError("INVALID_RESPONSE", "Missing detail row for " + identifier)
177
+ for field in fields:
178
+ if (field not in row or not isinstance(row[field], list)
179
+ or any(not isinstance(v, dict) or not isinstance(v.get("str"), str) for v in row[field])):
180
+ raise GettyError("INVALID_RESPONSE", "Malformed Getty detail field " + field)
181
+
182
+
183
+ def execute(value, client):
184
+ request = validate(value)
185
+ wire = {"q" + str(i): {"query": item["query"], "type": "/aat", "limit": request["limit"],
186
+ "properties": [{"pid": k, "v": v} for k, v in sorted(item["properties"].items())]}
187
+ for i, item in enumerate(request["queries"])}
188
+ data, search_cache = client.request({"queries": encoded(wire)}, lambda d: check_candidates(d, wire))
189
+ ids = sorted({c["id"] for key in wire for c in data[key]["result"]})
190
+ details, detail_cache, detail_error = {}, None, None
191
+ hierarchy, hierarchy_cache = {}, None
192
+ enrichment = {"status": "not_requested"}
193
+ if ids:
194
+ try:
195
+ extended, detail_cache = client.request({"extend": encoded({"ids": ids,
196
+ "properties": [{"id": field} for field in CORE_FIELDS.values()]})},
197
+ lambda d: check_details(d, ids, CORE_FIELDS.values()))
198
+ details = extended["rows"]
199
+ except GettyError as error:
200
+ detail_error = error.to_dict()
201
+ if detail_error is None:
202
+ try:
203
+ extended, hierarchy_cache = client.request({"extend": encoded({"ids": ids,
204
+ "properties": [{"id": HIERARCHY_FIELD}]})},
205
+ lambda d: check_details(d, ids, [HIERARCHY_FIELD]))
206
+ hierarchy = extended["rows"]
207
+ enrichment = {"status": "succeeded"}
208
+ except GettyError as error:
209
+ enrichment = {"status": "failed", "error": error.to_dict()}
210
+ groups = []
211
+ for index, item in enumerate(request["queries"]):
212
+ candidates = []
213
+ for candidate in sorted(data["q" + str(index)]["result"], key=lambda c: -c["score"]):
214
+ identifier = candidate["id"]
215
+ row = details.get(identifier, {})
216
+ candidates.append({"id": identifier, "uri": "http://vocab.getty.edu/" + identifier,
217
+ "label": candidate["name"], "serviceScore": candidate["score"],
218
+ "serviceMatch": candidate["match"], "detailsAvailable": identifier in details,
219
+ "hierarchyAvailable": identifier in hierarchy,
220
+ "hierarchy": [v["str"] for v in hierarchy.get(identifier, {}).get(HIERARCHY_FIELD, [])],
221
+ **{name: [v["str"] for v in row.get(field, [])] for name, field in CORE_FIELDS.items()}})
222
+ groups.append({**item, "status": "candidates" if candidates else "no_match", "candidates": candidates})
223
+ status = "partial" if detail_error else "candidates" if ids else "no_match"
224
+ return {"schema": SCHEMA, "ok": not detail_error, "status": status, "request": request,
225
+ "source": {"endpoint": ENDPOINT, "vocabulary": "aat", "license": "ODC-By-1.0",
226
+ "attribution": "J. Paul Getty Trust, Getty Research Institute, Art & Architecture Thesaurus"},
227
+ "cache": {"search": search_cache, "details": detail_cache, "hierarchy": hierarchy_cache}, "queries": groups,
228
+ "enrichment": {"hierarchy": enrichment},
229
+ "warnings": client.warnings + (["Candidates retained; core concept details could not be verified"] if detail_error else [])
230
+ + (["Core concept details verified; hierarchy unavailable"] if enrichment["status"] == "failed" else []),
231
+ "error": detail_error}
232
+
233
+
234
+ class Parser(argparse.ArgumentParser):
235
+ def error(self, message):
236
+ raise GettyError("INVALID_INPUT", message)
237
+
238
+
239
+ def main():
240
+ for stream in (sys.stdin, sys.stdout, sys.stderr):
241
+ if hasattr(stream, "reconfigure"):
242
+ stream.reconfigure(encoding="utf-8")
243
+ parser = Parser(description=__doc__)
244
+ parser.add_argument("--input", default="-", help="UTF-8 JSON file, or - for stdin")
245
+ parser.add_argument("--cache-dir", default=str(Path(os.environ.get("VANT_HOME", str(Path.home() / ".vant")))
246
+ / "tools/art-workshop/cache/getty"))
247
+ parser.add_argument("--timeout", type=float, default=15, help="Seconds per request; no automatic retries")
248
+ parser.add_argument("--cache-ttl", type=float, default=86400, help="Seconds; 0 disables cache")
249
+ parser.add_argument("--refresh", action="store_true", help="Bypass existing cache")
250
+ result = None
251
+ try:
252
+ args = parser.parse_args()
253
+ if not math.isfinite(args.timeout) or not 0 < args.timeout <= 60:
254
+ raise GettyError("INVALID_INPUT", "timeout must be greater than 0 and at most 60 seconds")
255
+ if not math.isfinite(args.cache_ttl) or args.cache_ttl < 0:
256
+ raise GettyError("INVALID_INPUT", "cache-ttl must be finite and nonnegative")
257
+ text = sys.stdin.read() if args.input == "-" else Path(args.input).read_text(encoding="utf-8-sig")
258
+ value = read_json(text)
259
+ result = execute(value, Client(args.cache_dir, args.timeout, args.cache_ttl, args.refresh))
260
+ except (GettyError, OSError, ValueError) as error:
261
+ result = {"schema": SCHEMA, "ok": False, "status": "error", "queries": [],
262
+ "error": error.to_dict() if isinstance(error, GettyError)
263
+ else {"code": "INVALID_INPUT", "message": str(error)}}
264
+ sys.stdout.write(encoded(result) + "\n")
265
+ return 0 if result["ok"] else 1
266
+
267
+
268
+ if __name__ == "__main__":
269
+ sys.exit(main())
package/v-cli.plugin.json CHANGED
@@ -17,10 +17,6 @@
17
17
  {
18
18
  "name": "ART_WORKSHOP_CONFIG",
19
19
  "description": "外部本地配置文件路径;未指定时使用用户配置目录/art-workshop/config.json"
20
- },
21
- {
22
- "name": "CODEX_HOME",
23
- "description": "可选 Codex 配置目录,用于随包 skill 同步"
24
20
  }
25
21
  ],
26
22
  "agent": {
@@ -217,33 +213,35 @@
217
213
  {
218
214
  "path": [
219
215
  "agent",
220
- "init"
216
+ "export"
221
217
  ],
222
- "usage": "art-workshop agent init [--directory <dir>] [--dry]",
223
- "description": "将随包 skill 同步到目标下已有 Agent 技能目录",
218
+ "usage": "art-workshop agent export --host codex --directory <DIR> [--dry]",
219
+ "description": "显式导出技能到指定宿主目录;默认安装不导出",
224
220
  "arguments": [],
225
221
  "options": [
226
222
  {
227
- "flags": "--directory <dir>",
228
- "description": "同步目标根目录,默认 cwd"
223
+ "flags": "--host <HOST>",
224
+ "description": "目标宿主 codex 或 claude"
225
+ },
226
+ {
227
+ "flags": "--directory <DIR>",
228
+ "description": "明确指定导出目录"
229
229
  },
230
230
  {
231
231
  "flags": "--dry",
232
- "description": "只读预演,不联网、不创建参考目录"
232
+ "description": "仅预演"
233
233
  }
234
234
  ],
235
235
  "output": {
236
236
  "format": "json",
237
- "description": "将随包 skill 同步到目标下已有 Agent 技能目录"
237
+ "description": "显式导出技能到指定宿主目录;默认安装不导出"
238
238
  },
239
239
  "exitCodes": {
240
240
  "0": "成功;验收状态以返回内容为准",
241
241
  "1": "参数、配置、计划或执行失败"
242
242
  },
243
243
  "safety": [
244
- "查询与预演不创建参考目录",
245
- "无网络调用",
246
- "覆盖同名随包 skill 和 runtime.json,保留扩展文件"
244
+ "仅显式请求时导出,不扫描用户目录,不生成安装绝对路径回执"
247
245
  ]
248
246
  },
249
247
  {
@@ -2485,7 +2483,265 @@
2485
2483
  "safety": [
2486
2484
  "冻结风格包只读;不覆盖已有文件;修改请派生草稿;只导出明确引用的参考图片"
2487
2485
  ]
2486
+ },
2487
+ {
2488
+ "path": [
2489
+ "conversation",
2490
+ "start"
2491
+ ],
2492
+ "usage": "art-workshop conversation start --config <path> --input <path>",
2493
+ "description": "编译并幂等提交会话出图,不创建项目任务",
2494
+ "arguments": [],
2495
+ "options": [
2496
+ {
2497
+ "flags": "--config <path>",
2498
+ "description": "隔离配置路径"
2499
+ },
2500
+ {
2501
+ "flags": "--input <path>",
2502
+ "description": "结构化会话请求 JSON"
2503
+ }
2504
+ ],
2505
+ "output": {
2506
+ "format": "json",
2507
+ "description": "请求身份、运行状态、停止确认与哈希产物"
2508
+ },
2509
+ "exitCodes": {
2510
+ "0": "成功",
2511
+ "1": "输入或运行错误"
2512
+ },
2513
+ "safety": [
2514
+ "bounded",
2515
+ "idempotent",
2516
+ "no-job-create"
2517
+ ]
2518
+ },
2519
+ {
2520
+ "path": [
2521
+ "conversation",
2522
+ "status"
2523
+ ],
2524
+ "usage": "art-workshop conversation status --config <path> --session <id> --request <id>",
2525
+ "description": "查询原运行与真实产物",
2526
+ "arguments": [],
2527
+ "options": [
2528
+ {
2529
+ "flags": "--config <path>",
2530
+ "description": "隔离配置路径"
2531
+ },
2532
+ {
2533
+ "flags": "--session <id>",
2534
+ "description": "会话身份"
2535
+ },
2536
+ {
2537
+ "flags": "--request <id>",
2538
+ "description": "原请求身份"
2539
+ }
2540
+ ],
2541
+ "output": {
2542
+ "format": "json",
2543
+ "description": "请求身份、运行状态、停止确认与哈希产物"
2544
+ },
2545
+ "exitCodes": {
2546
+ "0": "成功",
2547
+ "1": "输入或运行错误"
2548
+ },
2549
+ "safety": [
2550
+ "bounded",
2551
+ "idempotent",
2552
+ "no-job-create"
2553
+ ]
2554
+ },
2555
+ {
2556
+ "path": [
2557
+ "conversation",
2558
+ "cancel"
2559
+ ],
2560
+ "usage": "art-workshop conversation cancel --config <path> --session <id> --request <id>",
2561
+ "description": "取消原运行",
2562
+ "arguments": [],
2563
+ "options": [
2564
+ {
2565
+ "flags": "--config <path>",
2566
+ "description": "隔离配置路径"
2567
+ },
2568
+ {
2569
+ "flags": "--session <id>",
2570
+ "description": "会话身份"
2571
+ },
2572
+ {
2573
+ "flags": "--request <id>",
2574
+ "description": "原请求身份"
2575
+ }
2576
+ ],
2577
+ "output": {
2578
+ "format": "json",
2579
+ "description": "请求身份、运行状态、停止确认与哈希产物"
2580
+ },
2581
+ "exitCodes": {
2582
+ "0": "成功",
2583
+ "1": "输入或运行错误"
2584
+ },
2585
+ "safety": [
2586
+ "bounded",
2587
+ "idempotent",
2588
+ "no-job-create"
2589
+ ]
2590
+ },
2591
+ {
2592
+ "path": [
2593
+ "conversation",
2594
+ "resume"
2595
+ ],
2596
+ "usage": "art-workshop conversation resume --config <path> --session <id> --request <id>",
2597
+ "description": "仅恢复原上游身份,不重新提交",
2598
+ "arguments": [],
2599
+ "options": [
2600
+ {
2601
+ "flags": "--config <path>",
2602
+ "description": "隔离配置路径"
2603
+ },
2604
+ {
2605
+ "flags": "--session <id>",
2606
+ "description": "会话身份"
2607
+ },
2608
+ {
2609
+ "flags": "--request <id>",
2610
+ "description": "原请求身份"
2611
+ }
2612
+ ],
2613
+ "output": {
2614
+ "format": "json",
2615
+ "description": "请求身份、运行状态、停止确认与哈希产物"
2616
+ },
2617
+ "exitCodes": {
2618
+ "0": "成功",
2619
+ "1": "输入或运行错误"
2620
+ },
2621
+ "safety": [
2622
+ "bounded",
2623
+ "idempotent",
2624
+ "no-job-create"
2625
+ ]
2626
+ },
2627
+ {
2628
+ "path": [
2629
+ "conversation",
2630
+ "close"
2631
+ ],
2632
+ "usage": "art-workshop conversation close --config <path> --session <id> --request <id>",
2633
+ "description": "宿主退出时停止本请求的worker,保留外部共享服务",
2634
+ "arguments": [],
2635
+ "options": [
2636
+ {
2637
+ "flags": "--config <path>",
2638
+ "description": "隔离配置路径"
2639
+ },
2640
+ {
2641
+ "flags": "--session <id>",
2642
+ "description": "会话身份"
2643
+ },
2644
+ {
2645
+ "flags": "--request <id>",
2646
+ "description": "原请求身份"
2647
+ }
2648
+ ],
2649
+ "output": {
2650
+ "format": "json",
2651
+ "description": "请求身份、运行状态、停止确认与哈希产物"
2652
+ },
2653
+ "exitCodes": {
2654
+ "0": "成功",
2655
+ "1": "输入或运行错误"
2656
+ },
2657
+ "safety": [
2658
+ "bounded",
2659
+ "idempotent",
2660
+ "no-job-create"
2661
+ ]
2662
+ },
2663
+ {
2664
+ "path": [
2665
+ "style",
2666
+ "migration-complete"
2667
+ ],
2668
+ "usage": "art-workshop style migration-complete",
2669
+ "description": "校验当前迁移草稿并完成配置迁移;input 为 {note},不分析、不生成或定版",
2670
+ "arguments": [],
2671
+ "options": [
2672
+ {
2673
+ "flags": "--project <id>",
2674
+ "description": "工程身份"
2675
+ },
2676
+ {
2677
+ "flags": "--id <id>",
2678
+ "description": "对象身份"
2679
+ },
2680
+ {
2681
+ "flags": "--revision <number>",
2682
+ "description": "预期对象版本"
2683
+ },
2684
+ {
2685
+ "flags": "--input <file>",
2686
+ "description": "JSON {rules,summary,note};rules 为完整规则数组,每条 id/scope/strength/instruction/when,avoid 可含 negative 抽象排除表达数组"
2687
+ }
2688
+ ],
2689
+ "output": {
2690
+ "format": "json",
2691
+ "description": "校验预期版本及空闲状态后更新对象"
2692
+ },
2693
+ "exitCodes": {
2694
+ "0": "成功",
2695
+ "1": "校验、版本冲突或执行失败"
2696
+ },
2697
+ "safety": [
2698
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
2699
+ ]
2700
+ },
2701
+ {
2702
+ "path": [
2703
+ "job",
2704
+ "migration-complete"
2705
+ ],
2706
+ "usage": "art-workshop job migration-complete",
2707
+ "description": "校验当前迁移草稿并完成配置迁移;input 为 {note},不分析、不生成或定版",
2708
+ "arguments": [],
2709
+ "options": [
2710
+ {
2711
+ "flags": "--project <id>",
2712
+ "description": "工程身份"
2713
+ },
2714
+ {
2715
+ "flags": "--id <id>",
2716
+ "description": "对象身份"
2717
+ },
2718
+ {
2719
+ "flags": "--revision <number>",
2720
+ "description": "预期对象版本"
2721
+ },
2722
+ {
2723
+ "flags": "--input <file>",
2724
+ "description": "JSON {rules,summary,note};rules 为完整规则数组,每条 id/scope/strength/instruction/when,avoid 可含 negative 抽象排除表达数组"
2725
+ }
2726
+ ],
2727
+ "output": {
2728
+ "format": "json",
2729
+ "description": "校验预期版本及空闲状态后更新对象"
2730
+ },
2731
+ "exitCodes": {
2732
+ "0": "成功",
2733
+ "1": "校验、版本冲突或执行失败"
2734
+ },
2735
+ "safety": [
2736
+ "查询不写入;修改验证 revision、归属和停止确认;冻结风格只读"
2737
+ ]
2488
2738
  }
2489
2739
  ]
2490
- }
2740
+ },
2741
+ "skills": [
2742
+ {
2743
+ "id": "art-workshop",
2744
+ "path": "skills/art-workshop/SKILL.md"
2745
+ }
2746
+ ]
2491
2747
  }
@@ -1,6 +0,0 @@
1
- import {autoSync} from '../lib/agent.mjs';
2
- import {loadSettings} from '../lib/settings.mjs';
3
- try {
4
- const result=process.env.npm_lifecycle_event==='postinstall'&&!loadSettings().autoSyncSkills?{skipped:true,reason:'autoSyncSkills=false'}:autoSync({cwd:process.env.INIT_CWD??process.cwd()});
5
- console.log(JSON.stringify(result,null,2));
6
- } catch(error) {console.error(`美术工坊 skill 同步失败:${error.message};可稍后运行 agent init 重试。`);process.exitCode=1;}