Skip to content

设计原则

Core 不理解业务

Core 不能包含产品页面、领域状态、接口路径、品牌和 Token 值。它只负责可复用机制:配置、命令解析、诊断、验证、报告和安全写入。

这样做的代价是需要更多显式配置;收益是 Harness 不会被某个业务项目绑死。

项目事实归项目所有

.fe-harness/project.yaml 是目标项目拥有的配置。项目选择 profile、platform、stack,并把符号化验证步骤映射到真实命令。

Harness 可以提供模板和默认值,但不能长期替项目保存真实业务事实。

初始化必须安全

接入已有项目时,Harness 要先预检所有目标文件。只要有真实冲突,就停止写入。已有相同文件保留,已有不同内容报告为项目已维护或冲突。

这条原则是为了避免工程工具用“初始化”的名义覆盖用户维护的规则。

能力默认轻量,按需展开

新项目默认只安装聚合 Consumer H5 Skill。命令级 Skills、OpenAPI、UI System、Design Token discovery 和视觉基线都是按任务需要启用。

这不是删除能力,而是降低默认认知成本。

验证是完成证据

验证报告不是形式化步骤,而是任务完成的证据。失败命令、环境阻塞、未配置能力和业务失败应该被区分记录。

Consumer H5 的完整功能验收不只看构建和首屏,还要看需求闭环。

Business-neutral by design. Project-owned by default.