Skip to Content

AI Coding

给 Agent 的边界要写在仓库里，而不是靠口头提醒。

VekUI WeApp 面向人类开发者，也面向 AI Coding。Agent 可以生成组件， 但必须沿着 registry、UI rules、测试和小程序构建链路工作。

Rules

这些规则是 Agent 写代码前必须知道的上下文。

  • 先读 AGENTS.md 和 docs，再改组件源码。
  • 不在 packages/ui 使用 Radix、DOM API、ReactDOM portal 或第三方 UI fallback。
  • 组件样式必须使用语义 token 和小程序安全 utility。
  • 所有公共组件都要有测试、registry item 和 playground 示例。
  • 小程序运行验证由 apps/miniprogram 承担，不用 Web 截图替代。

Prompt entry

推荐把仓库规则作为 Agent 的第一段上下文。

Read AGENTS.md first.
Then inspect docs and registry manifest.
Do not add Radix, DOM APIs, or third-party UI fallback.
Run the required checks before reporting done.

这不是提示词装饰，而是防止 Agent 生成 Web-only 组件或绕过小程序约束。