SuperAPI AI 工具集

vertical-creator

设计与创作

查看项目

更新于 10-15 21:40

技能介绍

用途:创建、审查或更新 Harness Anything 的 vertical。Vertical 保持声明式,定义实体形状、模板目录、脚手架、默认值和适用预设,不依赖针对特定领域的 CLI 核心分支。CLI 仅提供通用 vertical 基础设施,包括模式校验、模板目录加载、模板物化、设置/开发模式门控、通用预设与配置选择。领域特有行为应放在 vertical 资产、模板目录、预设清单和流程脚本中。

主要能力与工作流:命名领域并列出实体种类,使用实体声明五元组:id、entityType、packageKind(生命周期实体)或 schemaRef(模式实体)、contractEntity,以及必要的匹配脚手架/根成员关系。区分生命周期包实体与仅模式元数据实体;为每个生命周期实体定义包脚手架和仓库根;模板正文放在 assets/<vertical>/templates/<slot>/<locale>.md 下的 Markdown 资产中,并在 template-catalog/v2 中通过 bodyPath 注册,不使用内联正文;必需文档以 templateSelections 指向目录引用;选择 checker profile 和投影模式;适用预设单独用 preset-manifest/v2 定义,不埋入 vertical。发布前运行 ha vertical validate <path>。

设计规则:用模板承载文档结构而非临时写文件;用预设承载可选流程或内容覆盖;新预设示例统一使用 preset-manifest/v2;template-catalog/v2 必须使用 bodyPath;项目/用户覆盖应可叠加,并在活动覆盖无效时失败关闭;在仅支持 Legacy Intake 加显式重建时,不承诺无人值守转换;除非明确设计公开产品文档,否则将私有 harness 运行状态排除在公开文档外。

用法与限制:通过 ha vertical validate 校验 vertical,通过 ha preset validate 校验预设清单。生命周期实体必须同时具备 packageScaffolds 与 repositoryScaffold.entityRoots;模式实体不得有包脚手架或仓库根。模板引用需存在于目录并物化到稳定路径,必需锚点需与各 locale 正文资产匹配。v2 profile 即使为空也必须显式声明 completionGates。自定义 vertical 受用户开发模式与项目设置门控。新增测试文件需放入正确的测试层级清单。具体收费、平台支持等资料暂未提供。