activity-init
Installation
SKILL.md
activity-init
本项目用 c init 初始化活动页面,两种形态:
c init act— 源码活动(从 prod 拉分支 + 建目录 + 按页面模板渲染)c init mdc— MDC 活动(在已有活动上挂 MDC 组件)
核心契约
- 独立调用执行
c init时永远带--non-interactive。交互已经在聊天里补齐,再让 CLI 弹交互会割裂体验。 - 默认只问一轮,缺失的必填和非必填一起问完;只有值非法时才补问第二轮。
- 直接问缺失字段,不给 A/B/C 备选项,不让用户在多个完整命令里挑。
- 已给过的不要重问。先从用户初始消息里解析活动名、区服、ID、组件名。
- 用户给了需求文档时,先尝试从文档提取初始化参数。如果缺少活动名、区服、pages、act-id 等字段,先做初始化前轻量分析,再把候选参数和命令发给用户确认;不要在未分析文档前直接追问文档里可能已有的信息。
- 独立调用执行
c init前先确认c命令存在。c来自 npm 包@activity-fe/cli;如果本机没有c,先处理 CLI 安装,不要直接跑初始化命令。 - 独立调用的
c init成功后创建活动级需求目录。这是 skill 的后置补齐步骤,不是 CLI 自动行为;只在c init退出码为 0 时执行。 - 初始化产物只稳定骨架,不冻结示例业务。保留活动目录层级和既有
docs/;router.js保持整体结构,且每个路由的path/pageCenter/id使用当前活动真实值,其中id = act_id;page.vue保留导航、初始化、生命周期和异步模块容器等入口框架。模板中的mod1/mod2只是参考,无业务依据时允许删除或替换,并同步清理 import 与挂载。 - 编排调用模式复用平台分支和活动 worktree,不创建替代分支,也不派遣需求/原型/设计分析。
- 独立调用拿不准参数、默认值、区服能力、报错含义时,先读 references/init-commands.md。这是本 skill 的随附参考,不是可选背景。