SuperAPI AI 工具集

authoring-projects

编程与开发

查看项目

更新于 10-16 07:24

技能介绍

用途:在 NVIDIA Elements 仓库中新建一个默认私有的独立工作区项目,内含 Lit 组件、包文件、五类测试与 Wireit 任务,并先接好所有消费方再定制组件。

必要上下文:先读仓库 AGENTS.md 与 references/integration-checklist.md;组件类、API、示例和五个测试文件参考 authoring-components 技能;Wireit 改动参考 guidance-build-system;改测试参考 authoring-testing;仅在需要发布包时读 projects/internals/RELEASE.md。

流程:确认 kebab-case 项目/组件名、用途、包描述及私有或可发布,组件名默认同项目名且新脚手架保持私有;检查 git status,确认 projects/<name> 不存在且不影响无关改动;在仓库根预览确定性脚手架:node .agents/skills/authoring-projects/scripts/scaffold-project.mjs --name <component-name> --description "<package and component description>" --dry-run,确认路径后去掉 --dry-run 重跑,结构更接近其他独立项目时可加 --reference <project-name>。随后按 authoring-components 定制占位组件:index.ts 保持无副作用,注册隔离在 define.ts,使用 @since 0.0.0,@documentation URL 与生成站点路由一致。刷新工作区状态:mise exec -- pnpm install、mise exec -- pnpm run format:fix、mise exec -- pnpm run notice。运行项目 DEVELOPMENT.md 中的检查,再验证仓库集成:mise exec -- pnpm -C projects/<component-name> run ci、mise exec -- pnpm -C projects/<component-name> run test:lighthouse、mise exec -- pnpm -C projects/internals/metadata run generate:api、mise exec -- pnpm -C projects/internals/metadata run build、mise exec -- pnpm -C projects/site run build、mise exec -- pnpm run lint:knip。因脚手架影响跨项目接口与生成产物,定向检查后需在仓库根运行 mise exec -- pnpm run ci。最后检查 diff 中的生成产物、缺失构建边、复制的视觉基线和无关 lockfile 变动。

限制:不得覆盖已有项目或复用其他组件的视觉基线;每个生成的 metadata/site 输入都要声明匹配的 Wireit 构建依赖;仅站点用的工作区包放在 projects/site 的 devDependencies 及其 workspace 作用域依赖 lint 忽略中,因为 Eleventy 动态创建其导入;包含 CSS lint 并使用仓库根 stylelint 路径(../../stylelint.config.mjs);未经用户明确授权不得创建标签、发布包、修改发布接线或把私有项目公开;提交 c88b885b 仅作历史证据而非逐字节模板。