Files
HexTrails/design/AGENTS.md
T
cabinw 10cf93a324 feat: add Paper Routes and package five design systems
Add the paper direction with thin tracks, outlined hexagons and line arrows, without exterior color markers or piece numbers. Add a unified catalog for five designs and their 25 themes, with direct review links.

Organize each design into an authored design.md, generated tokens.json and preview. Add Agent routing, shared integration guidance, a machine-readable manifest and an executable rendering example. Preserve legacy preview and document links.

Validation: 16 focused design, theme and package tests passed; npm run design and static build passed. Confirmed all eight authored documents survive generation unchanged. Browser checks covered mobile, tablet and desktop layouts, theme links and migrated previews. Native engine integration and visual verification remain pending.
2026-09-13 13:24:34 +08:00

1.6 KiB

使用与维护设计方案

这是主游戏五套并列设计的入口。先读 README.md,再读 shared.md 和本次指定方案的 directions/<id>/design.md。可通过 manifest.json 发现全部 ID、规范、配色和预览路径;不必依赖先前会话。

  • 设计 ID 固定为 calm、vivid、toy、animals、paper;方案编号为 01–05。每套都有相同的五个主题 ID。不得把设计、主题、关卡版本混成同一个参数。
  • 使用方案时复用 src/art-directions.js 的 artDirection / directionTheme 和 src/renderer.js 的 drawScene。样式接入、颜色映射和跨引擎限制见 shared.md。
  • 修改指定方案时,先核对该方案的 design.md。遵循用户已确认的共用规则:通知在步数下方、居中棋盘、大尺寸扁平道具、金色发光星星。paper 不画外围色标或棋子编号。
  • README.md、shared.md、本文件及各套 design.md 是人工维护的文档源。manifest.json、各套 tokens.json、预览 HTML 由脚本生成;修改源 JS/CSS 和设计规则后重新构建,不手改生成结果。
  • 每套仍是可单独使用、可同时保留的设计方向。除非任务明确选择默认方案,不因新增方案而替换 calm 默认值或其他审核选择。
  • UI 任务以用户本次授权为边界。仅使用设计不需要改关卡、玩法、碰撞数学、存档或原生工程。不要为文档整理顺便改这些模块。
  • 按 shared.md 的验证流程检查受影响内容。没有原生实机证据时,不报告 Cocos 已完成视觉接入或验收。