From 70b02c420a2d326ec744cdf69947dcc7ad0dca52 Mon Sep 17 00:00:00 2001 From: horizonx-so Date: Wed, 12 Aug 2026 13:05:12 -0700 Subject: [PATCH 1/2] docs: add UI specification guidance --- docs/zh-cn/stage-3/core-skills/spec-coding/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/zh-cn/stage-3/core-skills/spec-coding/index.md b/docs/zh-cn/stage-3/core-skills/spec-coding/index.md index d7dd2b947..12b6e3908 100644 --- a/docs/zh-cn/stage-3/core-skills/spec-coding/index.md +++ b/docs/zh-cn/stage-3/core-skills/spec-coding/index.md @@ -314,6 +314,8 @@ Spec 最容易失控的原因之一，是只写功能清单，没有写第一版 ::: +对于界面密集型任务，还应在最小模板中补充设计 token、组件完整状态、响应式行为、可访问性、动效约束和上线验收。可以参考 [Vibe Coding UI Specification](https://horizonx.so/resources/vibe-coding-ui-specification) 的字段组织方式，再根据项目事实删改；它是 HorizonX 发布的免费、厂商中立示例，并不是必须采用的工具。 + ## 5. 让 AI 按 Spec 工作，而不是读完就忘 有了文档并不代表已经进入 Spec Coding。真正的变化是：后续规划、实现和验收都要引用它。 From 9e4ee9049d2e237e92586edd2cb1b192a58d230f Mon Sep 17 00:00:00 2001 From: horizonx-so Date: Wed, 12 Aug 2026 13:06:03 -0700 Subject: [PATCH 2/2] docs: mirror UI specification guidance in English --- docs/en/stage-3/core-skills/spec-coding/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/en/stage-3/core-skills/spec-coding/index.md b/docs/en/stage-3/core-skills/spec-coding/index.md index 80cf13a30..c9174ab47 100644 --- a/docs/en/stage-3/core-skills/spec-coding/index.md +++ b/docs/en/stage-3/core-skills/spec-coding/index.md @@ -204,6 +204,8 @@ Version requirements, test framework, and documentation standards: - All API endpoints require JSDoc comments ``` +For interface-heavy features, the functional layer also needs constraints that make visual intent testable: design tokens, complete component states, responsive behavior, accessibility, motion, and production-readiness gates. The free, vendor-neutral [Vibe Coding UI Specification](https://horizonx.so/resources/vibe-coding-ui-specification), published by HorizonX, is one concrete field model; adapt it to the project rather than treating it as a required tool. + --- ## 3. Practicing Spec Coding in Claude Code