关于 live-dev-config
用于关联代码仓库与云托管并安全收集凭据的配置技能,指导创建 GitHub 仓库、连接 Vercel 项目,并通过凭据表单及安全管道传递密钥。
主要功能
- 01设置 GitHub 仓库
- 02连接 Vercel 项目
- 03本地凭据收集表单
- 04将凭据存入 git 忽略的 .env.local
- 05安全传递密钥
适用场景
- 01将代码仓库连接到 GitHub
- 02关联项目与 Vercel
- 03收集部署所需服务密钥
- 04向 Vercel 或 GitHub Secrets 添加凭据
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ drgarbage/ ag-course-index --skill live-dev-config安装后在 Claude Code 中输入/live-dev-config确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdresources/credential-form.jsread-env-value.js详细介绍
live-dev-config
此技能用于处理代码仓库关联、云托管配置和安全凭据收集。
bash 代码块使用 POSIX 语法(Windows 上为 Git Bash)。超出单条命令或管道的逻辑必须放在 resources/*.js 中,不得使用 shell 控制流。如果你的 Bash 工具是 cmd.exe 或 PowerShell,请在运行前转换每段代码。
1. 配置与项目关联
按以下顺序配置或验证仓库和托管资源:
| 资源 | 满足以下条件时跳过 | 限制 |
|---|---|---|
| GitHub 仓库 | 已存在远程仓库 | 在至少有 1 次提交的仓库中运行 gh repo create --private --source=. --push。仓库名称默认为文件夹名称——无需询问用户其他信息。仅在用户要求时设为公开。 |
| Vercel 项目 | 存在 .vercel/project.json | vercel link --yes — 非交互式。关联时也会配置 Vercel↔GitHub 集成。 |
2. 安全收集凭据
确保凭据不会泄露到 Git 历史记录、命令行日志或 shell 执行路径中。
2.1 收集凭据
生成 .credential-fields.json,仅包含此步骤所需的内容(例如服务账号 JSON 或特定 API 密钥):
[{ "name": "FIREBASE_SERVICE_ACCOUNT", "label": "Firebase 服務帳戶金鑰",
"help": "Project settings → Service accounts → Generate new private key",
"link": "https://console.firebase.google.com/project/<id>/settings/serviceaccounts/adminsdk" }]
node resources/credential-form.js .credential-fields.json # launch via the TOOL's background mode, NOT a shell `&`
- 凭据表单: 启动仅监听 127.0.0.1 的表单,打开浏览器,将内容写入被 Git 忽略的
.env.local文件,然后退出。如果浏览器未自动打开,请将 URL 转发给用户。 - 手动模板回退: 如果无法打开浏览器,请创建
.env.local.template,内容格式为KEY_NAME= # description & link,供用户填写并保存为.env.local。 - 命令行工具登录: 对于命令行工具登录(
gh auth login、vercel login、firebase login),请使用各工具的标准设备授权流程。
2.2 安全指南
切勿 source/eval .env.local,也切勿将凭据插入双引号或 <<< 中(shell 展开可能会执行代码)。使用 read-env-value.js 提取,并通过标准输入传递:
node resources/read-env-value.js .env.local FIREBASE_SERVICE_ACCOUNT | vercel env add FIREBASE_SERVICE_ACCOUNT production
# or GitHub secrets:
node resources/read-env-value.js .env.local FIREBASE_SERVICE_ACCOUNT | gh secret set FIREBASE_SERVICE_ACCOUNT
仅按键名报告:✅ <KEY> set in Vercel/production / ✅ <KEY> set in GitHub Secrets。
评论
支持 Markdown