用途:在已脚手架的 Cribl 应用目录中,依据 APP_BRIEF.md 实现或迭代 Cribl 应用。默认对所有组件使用 Capra UI。开始前需阅读 ./references/cribl-apps-guidance.md 以规避 KV store、状态管理、错误处理等常见问题。
工作流程:1)校验前置条件:确认处于已脚手架目录,否则提示“You must run this skill from within a scaffolded Cribl app folder.”;确认 APP_BRIEF.md 存在,否则报错“APP_BRIEF.md not found. Run /app-brief first.”;按需创建 /executions 目录。2)加载并比较版本:读取当前 APP_BRIEF.md,在 /executions 中按文件名时间戳找最近一份 APP_BRIEF_*.md;无历史则整个 brief 视为新增工作,有历史则对比找出新增、修改、删除的章节(删除的不回退)。3)把差异解析为动作项,每项一行清晰可执行描述。4)若提供 --dry-run,输出“=== DRY RUN: Planned Changes ===”、逐行动作项、“=== End Dry Run ===”后结束。5)正常执行:创建文件、修改代码、更新配置;从 APP_DEFINITION.md 的“## App ID”读取 app id,并把 package.json 的 name 字段改为该 id;清除 linter 错误并运行 npm run lint。6)归档本次运行:把当前 APP_BRIEF.md 复制为 /executions/APP_BRIEF_[ISO8601-timestamp].md,格式如 APP_BRIEF_2026-07-31T14-30-45Z.md(冒号替换为连字符),作为下次基线。7)确认 package.json 的 name 字段与 APP_DEFINITION.md 的 app id 一致。
原则:当前 APP_BRIEF.md 始终为准;具备幂等性,每次仅改动变化部分;运行间无状态,/executions 目录是唯一持久化状态。限制:必须从已脚手架 Cribl 应用目录运行,且依赖 APP_BRIEF.md 与 APP_DEFINITION.md;其余平台、收费等信息暂未提供。