mcpField
L
live-dev-config

live-dev-config

github.com/drgarbage云与 DevOps054 次安装9 周前更新
代码仓库

关于 live-dev-config

用于关联代码仓库与云托管并安全收集凭据的配置技能,指导创建 GitHub 仓库、连接 Vercel 项目,并通过凭据表单及安全管道传递密钥。

主要功能

  1. 01设置 GitHub 仓库
  2. 02连接 Vercel 项目
  3. 03本地凭据收集表单
  4. 04将凭据存入 git 忽略的 .env.local
  5. 05安全传递密钥

适用场景

  1. 01将代码仓库连接到 GitHub
  2. 02关联项目与 Vercel
  3. 03收集部署所需服务密钥
  4. 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.md
resources/
credential-form.js
read-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.jsonvercel 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