@chinhae/atw-cli 0.5.0 → 0.6.0

package/dist/migrations/manifests/0.6.0.json

@@ -0,0 +1,442 @@
+{
+  "version": "0.6.0",
+  "description": "atw-ui and atw-prototype are brought up to oil-ui 0.22.1. atw-prototype names the product's category, takes benchmarks apart and offers three directions in words before it builds any screen. atw-ui ships a screenshot tool and a separate manual for the review sub-agent. Three reference files are retired, and atw update removes them.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "The two interface skills, atw-prototype and atw-ui, are synced to oil-ui 0.22.1, the project they were forked from on 2026-10-01. Upstream's paid-version prompts, update check and first-use recommendations are not included. atw-prototype, choosing a direction. Stage one now starts by naming the product's category and two or three benchmarks, and taking the benchmarks apart from real screens saved under the task's references/. When no real screen can be fetched, the direction card says so and marks font, colour and main visual as not yet verified. The AI then writes three directions in three or four lines each, with a recommendation, sends that and stops. A direction picked from the text is the only one carried forward: stage one builds no first screen and no comparison page for it. Three first screens side by side are built only when the user wants to see them, and layout comparisons go words first too. When the user says to decide, or nobody is there, the three screens are still built for the record and the AI writes down why it chose one. Stage one is skipped only when ui-direction.md already exists or the user named one complete direction. Colour for each direction is derived in four steps from the product itself, and directions are no longer told apart by light and dark. The first screen is planned differently for a persuasion page and for a content or workspace page, where the first screen is the first row of content. The direction card gains columns for benchmarks and trade-offs, the form of each section, control grammar, and motion. The eight skeletons for persuasion pages move to a new file, references/direction-persuasion.md. atw-ui, scope and motion. Requests in an existing project are split three ways: polish the UI, change a flow, add a feature. A flow change or a new feature keeps the visual style the project has and does not go through direction exploration. Polishing a single component has its own path: one direction, with the visual protagonist chosen first. A new interface, or one whose operating flow changed, must have three baseline motions: feedback on the main action, where a state change comes from, and the first entrance. Two new guides: references/scroll-narrative.md, required reading for landing, brand, launch and exhibition pages, and references/play.md for small games, draws and controls that depend on feel. media.md takes upstream's structure and absorbs imagery.md; visual-language.md and layout-and-viewport.md follow upstream's current text. atw-ui, screenshot tool. The skill ships scripts/shoot.mjs and a guide to it, references/tools.md. One command takes the evidence set before review and before delivery: state shots, a side-by-side, a version with the text masked, a 2x shot and a screen recording. Each shot also reports default-pattern hints read from the page's styles, in two groups: readability problems to fix, and patterns to either change or justify in the delivery notes. The tool can compare a page against a reference image and draw numbered boxes on elements. It needs Node 22 or later and a local Chrome, Chromium or Edge; without them the skill falls back to the host's browser tool and hands over the same evidence. atw-ui, review. The review protocol is now two files. references/visual-review.md is the dispatch protocol the main agent reads: when to dispatch a reviewer and in which mode, what to hand over, and how to act on the feedback. references/reviewer-manual.md is new and is the only file the review sub-agent reads: a three-second test, deductions for model-default patterns, a motion check, three uplift items, a 'redo' line and a 'keep' line, and a table of thresholds for scores 1 to 10. Its second section covers polishing an existing interface against the project's own design-system.md, in one round and without a score. Inside /atw-implement the pipeline's review step still dispatches the reviewer, not the main agent. One copy of shared documents. atw-prototype no longer carries its own visual-language.md and visual-review.md. Its documents link to atw-ui's copies by relative path; every platform installs the two skills side by side under the same skills directory.",
+  "migrations": [
+    {
+      "type": "safe-file-delete",
+      "from": ".agent/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agent/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agent/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".claude/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".claude/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".claude/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".codebuddy/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".codebuddy/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".codebuddy/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".cursor/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".cursor/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".cursor/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".devin/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".devin/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".devin/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".factory/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".factory/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".factory/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".github/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".github/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".github/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".grok/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".grok/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".grok/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kilocode/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kilocode/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kilocode/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kiro/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kiro/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kiro/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".omp/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".omp/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".omp/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".opencode/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".opencode/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".opencode/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".qoder/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".qoder/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".qoder/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".reasonix/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".reasonix/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".reasonix/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".snow/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".snow/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".snow/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trae/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trae/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trae/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".zcode/skills/atw-prototype/references/visual-language.md",
+      "description": "atw-prototype reads atw-ui's visual-language.md as of 0.6.0",
+      "allowed_hashes": [
+        "76fbb6bc5624fb30896347a4233b2e18944f2b9c6391495fc2ae154c25ca122f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".zcode/skills/atw-prototype/references/visual-review.md",
+      "description": "atw-prototype reads atw-ui's visual-review.md as of 0.6.0",
+      "allowed_hashes": [
+        "4ea6413171b1b19f1af593fa282bb772375b22b2e2fcfafa3912514d59a4b7b1"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".zcode/skills/atw-ui/references/imagery.md",
+      "description": "Folded into media.md in 0.6.0",
+      "allowed_hashes": [
+        "6454e931f0a3428088b5158a7c5e5626f1722febf3b550337b209eccc90ba09b"
+      ]
+    }
+  ],
+  "notes": "No manual migration required. atw update deletes three retired files from the skills directory of every configured platform: atw-ui/references/imagery.md, atw-prototype/references/visual-language.md and atw-prototype/references/visual-review.md. A copy the project left untouched is deleted without asking; a copy that was edited is kept and listed as modified, skipped. In a dev project atw update also adds six files per skills directory (atw-ui/scripts/shoot.mjs, atw-ui/references/tools.md, reviewer-manual.md, scroll-narrative.md and play.md, and atw-prototype/references/direction-persuasion.md) and updates ten: in atw-ui, SKILL.md and references/layout-and-viewport.md, media.md, motion.md, visual-language.md and visual-review.md; in atw-prototype, SKILL.md, UI.md, references/design-direction.md and references/style-explorer.md. They update as Template updated where the project left them untouched; where a project edited them locally, atw update asks before replacing. A general project installs neither skill, so nothing in it changes. No setting in .atw/config.yaml changes, and .atw/workflow.md is the same as in 0.5.0."
+}

package/dist/templates/common/bundled-skills/atw-prototype/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: atw-prototype
-description: "构建一次性原型来解答设计问题。用于验证状态模型或业务逻辑是否合理、探索界面应该长什么样（多个风格方向并排对比后由用户选定），或把选定方向做成能完整点一遍、带业务逻辑的可交互原型。原型只用于做决定，不是正式实现；按选定方向做正式界面、精修和评审交给 atw-ui。"
+description: "构建一次性原型来解答设计问题。用于验证状态模型或业务逻辑是否合理、探索界面应该长什么样（先用文字比较几个风格方向，要看画面时再做成首屏并排对比，由用户选定），或把选定方向做成能完整点一遍、带业务逻辑的可交互原型。原型只用于做决定，不是正式实现；按选定方向做正式界面、精修和评审交给 atw-ui。"
 ---
 
 # Prototype
@@ -12,7 +12,7 @@ description: "构建一次性原型来解答设计问题。用于验证状态模
 先从用户的请求、相关代码判断要回答的是哪个问题；用户在场时可以直接问：
 
 - **“这套逻辑 / 状态模型对不对？”** → [LOGIC.md](LOGIC.md)。做一个可分享的单文件 HTML：自由操作的按钮加按标签页划分的引导演练，把纸面上难以推演的状态组合跑一遍，让不写代码的人也能自己操作。
-- **“这个界面应该长什么样？”** 或 **“这个页面用起来对不对？”** → [UI.md](UI.md)。分两段：先做几个风格明显不同的方向放进对比页，由用户选定；需要时再把选定方向深化成带业务逻辑的可交互原型，业务逻辑按 LOGIC.md 的方式写成独立的纯模块。
+- **“这个界面应该长什么样？”** 或 **“这个页面用起来对不对？”** → [UI.md](UI.md)。分两段：先认品类、拆标杆，用文字写出三个风格明显不同的方向请用户选，用户要看画面时再把三个首屏放进对比页；需要时再把选定方向深化成带业务逻辑的可交互原型，业务逻辑按 LOGIC.md 的方式写成独立的纯模块。
 
 两个分支的产物差别很大，选错等于白做。问题确实模糊且用户不在时，按周边代码选：后端模块走逻辑，页面或组件走界面；并在原型顶部写明这个假设。
 

package/dist/templates/common/bundled-skills/atw-prototype/UI.md

@@ -2,7 +2,7 @@
 
 界面原型分两段：
 
-- **第一段：选方向。** 做几个风格和结构都明显不同的方向，放进同一个对比页，由用户挑选，再说出具体喜欢和不喜欢哪里。
+- **第一段：选方向。** 先认品类、拆标杆，用文字写出三个风格和结构都明显不同的方向请用户选；用户想看实际画面时，再把三个方向各做成一张首屏放进同一个对比页挑，并说出具体喜欢和不喜欢哪里。
 - **第二段：深化成可交互原型。** 只在问题包含“用起来对不对”时才做：把选定方向做成完整页面，接上按 [LOGIC.md](LOGIC.md) 写的纯逻辑模块，让人能把真实业务流程完整点一遍。
 
 两段的产物都是用来做决定的，不是正式代码。选定之后的正式界面由 atw-ui 按设计说明重新实现。
@@ -19,6 +19,8 @@
 
 ## 承载方式：优先挂在已有页面上
 
+要做出画面时才选承载方式：第一段的三个首屏，或第二段的完整页面。用户从文字里就选定了方向、又不做第二段时，不建任何页面。
+
 界面原型**贴着应用的其他部分**才好判断：真实的顶栏、侧栏、数据和密度。一个孤零零的新页面是真空，每个方案单独看都还行。所以只要有合理的宿主页面，就优先方式 A。
 
 ### 方式 A：在已有页面上调整（优先）
@@ -37,49 +39,66 @@
 
 ## 第一段：选方向
 
-### 1. 写下问题，定方案数量
+### 1. 写下问题，定方向数量
 
-默认 **3 个方向**。超过 5 个就不再是“明显不同”而是噪音，上限 5。窄小的任务不强求多方案。
+默认写 **3 个方向**。用户要更多时照做，但超过 5 个就不再是“明显不同”而是噪音，上限 5。窄小的任务不强求多方案；任务明确只要一个方向时只写一个，见第 6 步。
 
-把计划写成一句话，放在原型所在位置或文件顶部注释里：
+把计划写成一句话；做出画面时放在原型所在位置或文件顶部注释里：
 
-> “设置页的三个方向，用 `?variant=` 在现有 `/settings` 路由上切换，并汇总到对比页。”
+> “设置页的三个方向，先用文字问；要看画面时用 `?variant=` 在现有 `/settings` 路由上切换，并汇总到对比页。”
 
 用户在不在场都适用。
 
-### 2. 定调性，写方向卡，做差异检验
+### 2. 认品类，拆标杆，写方向卡
+
+方向未定时按 [设计方向](references/design-direction.md) 的顺序做：先认品类、拆标杆，标杆的真实画面存进 ATW 任务目录的 `references/`（没有任务时放在原型旁边），不写进技能安装目录；再从产品题材、受众和使用场合推出调性；每个方向从一个具体的生成引擎出发，色彩按“定色彩”的四步从产品推出；写文案之前先定首屏骨架，说服型页面按 [说服型页面首屏骨架](references/direction-persuasion.md) 选，内容和工作区页面的首屏就是第一排内容；为每个方向填方向卡，最后逐条做差异检验。
+
+这一轮几个方向共用调性和标杆与取舍，每个方向只填北极星、生成引擎、首屏骨架、字体、色彩、主视觉、图标和控件语法；其余各栏在方向选定后补齐，见第 7 步。
 
-方向未定时按 [设计方向](references/design-direction.md) 的顺序做：先从产品题材、受众和使用场合推出调性；每个方向从一个具体的生成引擎出发；写文案之前先定首屏骨架；为每个方向填方向卡，写下它的记忆点；最后逐条做差异检验。
+方向**必须在结构上不同**：布局、信息层级、主要操作方式都不一样，不只是换颜色。三个微调过的卡片网格不是界面原型，是墙纸。两个方向太像时，回到骨架重选其中一个，不靠换装饰补救。
 
-方向**必须在结构上不同**：布局、信息层级、主要操作方式都不一样，不只是换颜色。三个微调过的卡片网格不是界面原型，是墙纸。两个方向做出来太像时，回到骨架表重选其中一个，不靠换装饰补救。
+方向由用户的品味来定，不直接采用模型自己想出的方向。任务目录里已有 `ui-direction.md`，或用户明确指定了一个完整的方向时，跳过第一段，直接进入第二段或交给 atw-ui。用户只给了参考图、品牌规范或说了想要的风格，不算给定方向：仍写三个方向、走第 3 步，三个方向怎样写见第 6 步。
 
-方向由用户的品味来定，不直接采用模型自己想出的方向。用户已经给定方向时跳过这一步，直接进入第二段或交给 atw-ui。
+### 3. 先用文字问一次
 
-### 3. 做小样
+方向卡写完，不急着做页面。把每个方向用三四行写给用户：它给人什么感觉，首屏长什么样，用什么字体和色彩，主视觉靠什么。附上你推荐哪一个和理由，然后问：按其中一个定下来，还是把三个都做成首屏放在一起比。发给用户后这一轮结束。
 
-每个方向只做首屏和最能体现方向的一两个区块；用户明确要完整页面时照做。挑能暴露方向优缺点的内容：含复杂表单的产品不能只做封面。
+- 用户选了一个，或者从描述里已经说清想要什么：方向就定了，定下的就是这一个方向。第一段不做首屏，也不做对比页：按 [设计方向](references/design-direction.md) 的“差异检验”把它和拆过的标杆并排比一次，确认不撞脸，然后到第 7 步补齐方向卡、写设计说明。完整页面在第二段或 atw-ui 里做。
+- 用户想看实际画面：按第 4 步把三个都做成首屏。
+- 之后凡是要做出几个候选让用户挑，都先这样用文字问一次：用户从文字里定得下来，就定选中的那一个，不把几个候选都做成画面。
 
-每个方向要守住：
+### 4. 用户要看实际画面时，做三个首屏
 
-- 页面的用途和它能拿到的数据；所有方向共享同样的核心内容和主要操作。
-- 方式 A 用项目已有的组件库和样式体系（TailwindCSS、shadcn、MUI、纯 CSS 等）；方式 B 的独立小样不受此限，但图标只内联用到的 SVG，不引用外部资源。
-- 方式 A 中每个方向导出清楚的组件名，例如 `VariantA`、`VariantB`、`VariantC`。
+每个方向都是一张真实的首屏，骨架、字体、色彩和主视觉都拉开。只做看得出风格所需的东西：
 
-示例内容按真实产品的样子写，避免整数指标和“标题”“描述”这类占位字；画面上不出现“示例”“示意图”“按钮未接入”这类制作说明，这些写进交付说明。视觉层级、字体、色彩和留白的判断见 [视觉语言](references/visual-language.md)。
+- 每个方向一个文件（方式 A 是一个方向组件，导出清楚的组件名，例如 `VariantA`、`VariantB`、`VariantC`；方式 B 是一个 HTML）、一个视口、只有主状态；不写交互，不做响应式和动效，不取证，不派评审。
+- 几个方向共用同一份示例文字和数据，只写一次；页面的用途、核心内容和主要操作也相同。结构和样式各写各的：不用同一个模板换几组样式来生成，那样几个方向的骨架天生是同一个。
+- 方式 A 用项目已有的组件库和样式体系（TailwindCSS、shadcn、MUI、纯 CSS 等）；方式 B 的独立首屏不受此限，但图标只内联用到的 SVG，不引用外部资源。
+- 主视觉靠图的方向，生成一张，至多重新生成一次；其余图位先用从页面取色的色块占着。
+- 每个方向用宿主的浏览器工具截一张图自己看过，改掉重叠、裁切和明显的粗糙就交。
 
-### 4. 生成对比页
+首屏选能暴露方向优缺点的那一页：含复杂表单的产品不能只做封面。示例内容按真实产品的样子写，避免整数指标和“标题”“描述”这类占位字；画面上不出现“示例”“示意图”“按钮未接入”这类制作说明，这些写进交付说明。视觉层级、字体、色彩和留白的判断见 [视觉语言](../atw-ui/references/visual-language.md)。
 
 按 [风格对比页](references/style-explorer.md) 准备 `manifest.json`，把方向卡里的北极星、字体、色板和特征写进去，用内置生成器组装成一个离线 HTML。不要每次自己重做对比工具。对比页和 manifest 放在 ATW 任务目录（没有任务时放在原型旁边），不写进技能安装目录。
 
-### 5. 交给用户选
+### 5. 交对比页，版式也先用文字问
+
+把对比页交给用户，这一轮到此结束：附上推荐理由，请用户选一个方向、说出具体喜欢和不喜欢哪里，并说明想比较不同的版式也可以说。用户只说“再高级一点”这类模糊词时，用设计方向里的翻译表追问，或拿两张首屏让用户比较。三个首屏和版式变体不派评审；用户明确要求时，才按 atw-ui 的 [视觉评审派发协议](../atw-ui/references/visual-review.md) 评一轮。协议里说的“本 Skill 目录”是 atw-ui 的目录：给评审者的是 [评审手册](../atw-ui/references/reviewer-manual.md) 的绝对路径。首屏没跑截图工具，没有 `report.json`，不交默认做法提示，交接里写明未跑截图工具。
+
+用户要比版式，先用文字写出两三种骨架的差别；从文字里定得下来就按选中的定，要看实际画面再做成首屏，连同选中的那一版放进对比页再选一次。版式之间保持选定方向的字体、色彩和控件语法，只在骨架、主视觉的摆法和页面结构上拉开。用户只回了选哪个，就把意见并进去，到第 7 步；想把两个方向拼在一起的，先做出拼合后的首屏给用户确认。
+
+### 6. 哪些情况不这样走
 
-给出简短的方向清单和对比页，附推荐理由，请用户选定，并说出具体喜欢和不喜欢哪里。用户只说“再高级一点”这类模糊词时，用设计方向里的翻译表追问，或拿两张小样让用户比较。
+- 只要设计说明时不做页面，用文字写下方向的决定。
+- 用户已经给了参考图、品牌规范或说清了风格，风格就定了：三个方向都留在这个风格里，只在骨架、主视觉和页面结构上拉开。
+- 用户说了“你定”“直接做”，或者无人值守时，不问：三个首屏仍做出来放进对比页留档，把三张截图缩到 480px 宽并排看一次，自己选定并写明理由，接着到第 7 步。
+- 任务明确只要一个方向时不问也不做对比页，直接写方向卡，再按 [设计方向](references/design-direction.md) 的“差异检验”把它和拆过的标杆并排比一次，确认不撞脸。
 
-交付对比页时，把一轮独立评审作为**推荐的下一步**告诉用户：说明它能改善什么（打破几个方向共用的模板骨架）、大约需要多少时间和调用，由用户决定是否执行，不默认派发。用户同意时按 [视觉评审协议](references/visual-review.md) 给每个方向各评审、修改一轮；用户直接选定方向时跳过。
+### 7. 写设计说明
 
-用户明确让你自行决定、或当前无法交互时，仍然先做小样、生成对比页留档，再按任务适配、辨识度和可执行性选定，并说明理由。
+方向选定后先把方向卡补齐：第 2 步没填的页面结构、各区块的形式、动效、结构性突破、记忆点和放弃什么都填上，“标杆与取舍”里写明标杆画面的存放路径。
 
-选定后写一份简短的**设计说明**：用户任务、内容与主动作、选定方向（附方向卡）、用户的喜欢与不喜欢、视觉关系、关键状态、设备约束和验收重点。放在 ATW 任务目录的 `ui-direction.md`；已有说明直接更新。这份说明是第二段和 atw-ui 的依据。
+再写一份简短的**设计说明**：用户任务、内容与主动作、选定方向（附补齐后的方向卡，标杆与取舍、各区块的形式、控件语法和动效四栏都在）、用户的喜欢与不喜欢、视觉关系、关键状态、设备约束和验收重点。放在 ATW 任务目录的 `ui-direction.md`；已有说明直接更新。这份说明是第二段和 atw-ui 的依据。
 
 ## 第二段：深化成可交互原型
 
@@ -91,7 +110,7 @@
 
 ### 2. 选定方向做成完整页面
 
-把选定方向从小样扩展成完整页面，作为逻辑模块外面的一层外壳：页面只调用模块、渲染模块返回的状态。关键状态都要在界面上有样子——空、加载、成功、失败、被拒绝的非法操作——不只做漂亮的默认状态。
+把选定方向做成完整页面（做过首屏的从首屏扩展），作为逻辑模块外面的一层外壳：页面只调用模块、渲染模块返回的状态。关键状态都要在界面上有样子——空、加载、成功、失败、被拒绝的非法操作——不只做漂亮的默认状态。
 
 方向卡里的记忆点（某个动作的反馈、完成的那一刻）在这里做出来；动效遵循方向的调性。修改数据的动作一律经过逻辑模块，接口用桩代替，不接真实后端。
 
@@ -149,7 +168,7 @@ return (
 
 ## 交给用户
 
-给出对比页路径、页面地址和 `?variant=` 的取值；第二段还要说明状态抽屉怎么打开、有哪些演练场景。用户有空时会翻看。最有价值的反馈常常是 **“我要 B 的顶栏配 C 的侧栏”**——那才是他们真正想要的设计。
+做了画面时，给出对比页路径、页面地址和 `?variant=` 的取值；第二段还要说明状态抽屉怎么打开、有哪些演练场景。用户有空时会翻看。最有价值的反馈常常是 **“我要 B 的顶栏配 C 的侧栏”**——那才是他们真正想要的设计。
 
 交付说明里写清：哪些是模拟数据、生成图片、未接入的动作；实际查看过哪些视口；哪一步没做以及原因。
 
@@ -165,6 +184,7 @@ return (
 
 ## 反模式
 
+- **不问就做三个首屏。** 用户在场时先用文字问一次；从文字里定得下来，就不做首屏和对比页。
 - **方向之间只差颜色或文案。** 那是微调，不是原型。真正的方向在结构上互不相同。
 - **按明暗分方向。** “一个亮、一个暗、一个暖”是最常见的失败；每个方向要有自己的色彩身份。
 - **默认左右分栏。** 一轮里最多一个方向用左右分栏，并写出为什么非它不可。