Skip to content

Latest commit

 

History

History
101 lines (74 loc) · 6.05 KB

File metadata and controls

101 lines (74 loc) · 6.05 KB

AGENTS.md - DESIGN-LAB 设计实验室 Operating Guide

本文件是 DESIGN-LAB 的根执行规则,单仓自包含。不依赖外部项目即可正确执行。

项目定位

DESIGN-LAB 是面向职业视觉设计的、AI 原生、平台中立、宿主原生的专业设计智能与生产能力层。

拥有:

  • Design Brief、Reference、Direction、Design System、Design IR、Domain Pack 和 Method
  • 品牌、UI/UX、平面/出版、电商/营销、包装、动效/视频、3D/VFX 等设计域能力
  • 专业 Jury、视觉质量、反 AI 痕迹、可访问性、rights 与 production preflight
  • Host/Tool Adapter、可编辑交付、BOM、provenance、readback 与 rollback
  • 设计实践产生的受审 KnowledgeCandidate,但长期知识真值归 ArcheAxis

不拥有:

  • 第二画布、通用聊天客户端、Agent runtime、模型网关、账号系统或通用知识库
  • WORK-LAB 的跨软件全局配置、权限、任务和 Observer
  • ArcheAxis 的长期知识与学习状态
  • Adobe/Figma/Penpot/Blender 等宿主的私有数据库或用户个人素材库

宿主与入口(Standalone-first,ADR-001)

  • DESIGN-LAB 可独立完成完整设计生产闭环;启动/测试/恢复/Golden Workflow 不探测也不要求 WORK-LAB 或 ArcheAxis(二者默认关闭)
  • Open Design 是宿主/工具 Adapter 之一(Open Design host adapter),不是运行依赖或默认宿主
  • DESIGN 以官方插件/CLI/MCP 扩展形成下游发行层
  • 外部项目只能通过版本化公共合同(Schema/API/Manifest)连接,不读私有 DB 或目录
  • MiniGame 是游戏视觉 Domain/回归 fixture,不是项目运行时产品线
  • 运行/证据/缓存根统一为 .project-local/PROJECT_LOCAL_ROOT);.hermes 不是活跃写入路径(旧引用见历史文档标记)

Owner 与 SSOT

  • 项目 Owner:DTALEX66
  • 代码 SSOT:D:/All projects/DESIGN-LAB(本地)/ github.com/DTALEX66/DESIGN-LAB(云端)
  • 设计真值:本仓库内的 Design IR、Domain Pack、Jury、Human Gate、rights、preflight
  • 知识出口:经 rights 检查和人工批准的 KnowledgeCandidate 可提交 ArcheAxis

Evidence 等级(E0-E5)

等级 必须证明 不能冒充
E0 DECLARED 身份、范围、许可候选、owner README、链接、prompt
E1 STRUCTURAL schema/manifest/adapter 合同与静态测试 文件存在、mock response
E2 CONTROLLED_RUNTIME 固定版本、合成/专用 fixture 的真实调用与读回 只启动进程、只截图
E3 REAL_WORKFLOW 真实 brief→原生可编辑产物→重开读回→失败/回滚 一个旧版本/另一个工具的 E3
E4 INDEPENDENT_ACCEPTANCE 独立人审、黄金集、质量/rights/preflight 全通过 VLM 自评、像素相似度
E5 RELEASED/REPEATABLE exact-SHA release、安装/升级/恢复、连续复现 历史 release、手写 status

任何 evidence record 必须绑定 repo SHA、adapter version、host version、OS、fixture hash、artifact hash、命令/动作、审批、readback 和 rollback。

执行规范

  • 执行任务前先扫描匹配 SKILL(见全局执行标准步骤②)
  • 设计产物留在本项目内,不外溢到其他项目/共享库
  • 更新以官方发布为准,不私自打包
  • E 盘受保护,无精确授权不得访问

模块

  • design-lab/:设计核心(reconstruction、providers、config、tests、evals)
  • packages/design-system/:设计系统
  • fixtures/domains/game-visual/:游戏视觉 Domain fixture(不是独立产品线)
  • evals/:评估与黄金语料
  • docs/:文档与任务包
  • reports/:交接文档与当前状态投影

Human Gate(人工门)

人工门按风险和生命周期决定,不能被模式绕过:

  • Direction gate:目标、受众、品牌/参考、rights
  • Quality gate:视觉判断、可访问性、反 AI 痕迹、专业 Jury
  • Rights gate:字体、图片、模型、商标、第三方素材与生成权利
  • Production gate:可编辑性、preflight、BOM、交付范围
  • Release gate:最终验收、签名、版本与回滚

production 可以减少低风险交互,不能把所有 gate 设为空。自动通过必须由预先批准的 policy 和低风险证据决定,并保留 receipt。

KnowledgeCandidate 出口

  • 只允许经 rights 检查和人工批准的 Method/Jury correction/Production lesson 输出到 ArcheAxis
  • 包含 source/artifact/evidence hash、DESIGN exact SHA、license/rights、candidate type、supersedes 和撤销入口
  • 原始商业资产、客户 brief 和未授权素材默认不外溢

模型与工具

  • 未校验模型(UNQUALIFIED_*)默认 defaultEnabled: false
  • 零 checksum、许可冲突、模型不存在或硬件不足时,runtime resolver 必须 fail closed
  • 第三方 AGENTS/CLAUDE/cursorrules/SKILL/install/affiliate 作为 inert source blobs 保存,不进入根指令、prompt、tool discovery 或能力计数

当前任务包

  • 当前有效任务包:docs/taskpacks/DESIGN-LAB-TODAY-EXECUTION-TASKPACK-2026-09-04.md(DL-TP-20260904-STANDALONE-FIRST)
  • 下一阶段产品方案(已登记,未冻结):docs/taskpacks/DESIGN-LAB-MULTIMODAL-TASK-PLAN-2026-09-05.md(T01–T18;执行按 DEEPSEEK/CODEX 交接分工:D:\All projects\DESIGN-LAB-MULTIMODAL-CODEX-HANDOFF-2026-09-05.mdreports/current/ 下 T01/T02 报告)
  • 历史任务包(superseded,保留为历史证据,不作为 current 派工入口):
    • docs/taskpacks/DLR-FINAL-20260826-R2-OSS-FAST-TRACK.md(2026-08-26)
    • docs/taskpacks/TRI-OSS-FAST-TRACK-20260826-R1.md(三项目总规划,superseded by standalone-first ADR-001)
  • 执行波次:Truth/Safety(P0 真值)→ Reproducibility(Wave 1)→ Core contracts/runtime(Wave 2)→ Real Host → Quality → Domain → Federation/Release;Wave-0-first,其余 REGISTER_ONLY 直至前序绿色
  • 进度账本:reports/current/TASKPACK_PROGRESS-2026-09-04.json(evidence 口径,PR115 复核版);基线冻结:reports/history-baseline.json

(项目特有规则在此基础上补充)