一组用于调研产品想法、记录待确认事项、生成开发文档,并在完成实现后部署前端项目的 Agent Skills。
推荐使用 skills CLI:
npx skills add songyang0603/vibe-coding-loop
只安装需要的 Skill:
npx skills add songyang0603/vibe-coding-loop \ --skill vibe-deep-research \ --skill vibe-decision-docs \ --skill github-repo-vercel-deploy
安装过程会让你选择 Agent 和安装范围。不同 Agent 的目录、权限提示和工具连接方式不同,请先用一个小任务确认本地环境。
产品想法或既有项目
→ 调研报告与待确认事项
→ 用户确认
→ Build Context
→ 产品、技术、UI 文档
→ ds-spec-loop 实现与验证
→ GitHub + Vercel 前端部署
| Skill | 何时使用 | 主要输出 |
|---|---|---|
🔍 vibe-deep-research |
有产品 Idea,或已有项目需要竞品、前端、后端/数据、Agent、开源参考调研时。 | research.md、待确认事项;用户确认后生成 context.md。 |
📝 vibe-decision-docs |
context.md 已由用户确认,需要定义第一版范围时。 |
product.md、technical.md、ui.md。 |
💻 ds-spec-loop |
三份文档确认后,开始涉及功能、接口、架构、测试或长期文档的仓库改动时。 | 由独立仓库维护的实现、测试、文档和决策记录流程。 |
🚀 github-repo-vercel-deploy |
前端项目已通过本地检查,需要设置 GitHub 自动部署、Vercel 项目或环境变量时。 | 项目设置、环境变量映射、公开 URL 和验证记录。 |
ds-spec-loop 是独立项目。本仓库只提供工作流中的调用位置:
npx skills add songyang0603/ds-spec-loop
Use $vibe-deep-research to research this product idea.
Compare relevant product references, frontend interaction patterns,
backend/data options, Agent approaches, and open-source implementations.
Give recommendations with sources, then ask for the decisions needed before planning.
这一步可以从一句想法、一个仓库、项目文档、截图或历史对话开始。Skill 会将已确认事实、参考资料、建议、假设和待确认事项分开记录。用户确认方向后,同一 Skill 会按七段结构填写 Build Context:背景与目标、重点关注、三项交付物、技术约束、已有 Context、工作顺序、授权与确认边界。
Use $vibe-decision-docs to turn the confirmed Build Context into
product.md, technical.md, and ui.md. Keep unresolved details marked as Draft.
Do not start implementation until I confirm the documents.
product.md:用户、关键路径、功能范围、MVP、非目标和验收例子;technical.md:前后端、数据与状态、Agent/工具、接口、失败处理和测试;ui.md:信息架构、页面、输入、运行、结果、空态、错误态和移动端体验。
Use $github-repo-vercel-deploy to deploy this buildable GitHub Web app.
Inspect the repository first. Before linking Vercel, changing settings,
adding environment variables, committing, pushing, or deploying, show me
the exact target and ask for confirmation.
Skill 会检查 Git 状态、构建命令、app root、workspace 配置和环境变量名称。环境变量通过 Vercel Dashboard 或交互式 CLI 输入;不要在聊天、Git 或日志中保存 secret。
支持:
- 静态站、SPA、Next.js;
- 请求生命周期内完成的 Vercel Function 或 Route Handler;
- 单应用仓库,以及每个前端应用独立部署的 monorepo;
- GitHub 自动部署、Root Directory、Framework、环境变量和公开 URL 配置。
不处理:
- 长时间运行的 Agent、Worker、Queue 或持续任务;
- 持久任务恢复、数据库迁移/回填、私有网络和 IP allowlist;
- 容器平台、消息系统和复杂多服务编排。
这些系统可以将前端单独部署到 Vercel;后端和基础设施需要独立方案。
读取仓库、检查构建、查看 Vercel 项目状态和访问 URL 可以直接进行。以下操作必须先得到用户确认:
- 新建或关联 Vercel 项目;
- 连接 GitHub、修改生产分支、Root Directory、Framework 或访问保护;
- 添加、覆盖或删除环境变量;
- 修改部署文件、commit、push 或触发生产部署。
Skill 不会读取 Vercel 凭据文件,不会要求把 token 或 secret 发送到聊天,也不会提交 .env 或 .vercel/project.json。
v0.1 已完成三个 Skill 的结构校验、两次从产品想法到三文档的独立试跑、Vercel CLI 命令核对,以及部署审计脚本的 Shell 检查。
这些检查覆盖了当前流程的基本用法。不同 Agent、项目类型和云端权限仍需要在各自环境中确认。
欢迎提交 Issue 和反馈。
本项目采用 Creative Commons Attribution-NonCommercial 4.0 International(CC BY-NC 4.0)。使用、改编或再发布时需要署名、附上许可证链接并说明修改;不得用于商业用途。