用途：在本地搭建一个 Next.js 的 Alpaca 仪表盘，用于模拟交易（paper trading）和市场数据演示。生成的应使用已发布的 @alpacahq/alpaca-ts-alpha 包，并通过该 SDK 直接调用 Trading API 与 Market Data API。
主要能力：脚手架会生成包含 package.json、app/、components/、lib/ 和 .env.local 的应用，并带有 dashboard、positions、stocks、stock detail、trade、orders 等页面。默认 APCA_PAPER="true"，即模拟交易，不配置实盘。
使用方式：在本技能目录下运行：
npx tsx scripts/scaffold.ts
--target-directory /path/to/my-alpaca-dashboard
--app-name my-alpaca-dashboard
若本地运行时支持，也可用 node scripts/scaffold.ts 或 bun scripts/scaffold.ts；Node 20 建议优先用 npx tsx。省略参数时脚本会读取环境变量 APCA_API_KEY_ID 与 APCA_API_SECRET_KEY；若本地没有凭据，可加 --allow-placeholder-credentials，生成的 .env.local 会写入占位符，需用户自行填写后再运行。常用参数：--create-subdirectory（把 --target-directory 当作父目录，创建 target/app-name）、--key-id / --secret（直接写入模拟凭据，不读环境变量）、--paper（设置生成的 APCA_PAPER，默认 true，演示时保持开启）。目标目录可含无关文件，脚手架会把模板合并进去，但拒绝覆盖任何已存在的生成路径，包括 .env.local。
完成后命令： cd /path/to/my-alpaca-dashboard npm install npm run dev
限制与安全规则：默认仅模拟交易，除非用户明确要求并理解风险，否则不配置实盘。目标不能是文件或符号链接，生成路径不得已存在。不得在聊天或命令输出中回显 APCA_API_SECRET_KEY。除非用户要求，不运行 npm install 或 npm run dev。常见失败：缺少 TypeScript 运行器、缺少凭据、应用名不合法（需小写 npm 包名，不含空格、大写字母、前导点或下划线）、目标不安全。