# sliver-vibe-coding

**Repository Path**: sliver-ring_admin/sliver-vibe-coding

## Basic Information

- **Project Name**: sliver-vibe-coding
- **Description**: vibe coding
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-19
- **Last Updated**: 2026-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sliver Vibe Coding

![Sliver Vibe Coding 海报](assets/sliver-vibe-coding-poster.png)

面向非技术用户的 AI 项目开发治理 skill。

它不是一套“让用户自己学会写代码”的教程，而是一套给 AI 使用的项目开发规则、提问规则、技术决策规则、验收规则和防跑偏规则。目标是让完全没有技术背景的用户，也能在 AI 引导下从想法、接手半成品项目、功能开发、质量验收到部署发布，尽量按规范推进。

## 适合谁

- 完全没有技术背景，但想用 AI 做出一个真实项目的人。
- 已经让 AI 写了一半项目，但项目跑不起来、文件混乱、功能真假难辨的人。
- 想让 AI 帮自己做技术选型、架构、前端、后端、数据库、第三方接入、发布上线的人。
- 不想靠一句“帮我写代码”硬冲，而是希望 AI 多问、多判断、多验收、多保护项目的人。

## 解决什么问题

这个 skill 会要求 AI 主动处理这些小白最容易卡住的问题：

- 项目从哪里开始，先做什么，后做什么。
- 现有项目能不能半路接管，而不是必须从零开始。
- 没有 `dev-docs`、开发资料混乱、真源文档缺失时怎么处理。
- 技术栈应该怎么选，为什么只推荐一个主路线。
- 什么时候不能直接写代码，必须先做实施真源。
- 功能开发前会不会动到底层架构、数据库、权限、支付、部署。
- 第三方 API、SDK、OAuth、支付、AI 服务是否需要查官方文档。
- Git、`.gitignore`、密钥、内部资料、AGENTS 宪法、参考项目库怎么保护。
- AI 写乱、重复文件、mock 假数据、假成功、报错循环怎么救。
- 用户不会验收时，如何变成点击路径、截图证据、通过/失败判断。
- 上线前如何检查环境变量、密钥、数据库迁移、回滚、监控、成本和公开访问风险。

## 使用方式

安装到 Codex skills 目录后，在对话里直接用自然语言描述需求即可，不要求用户记住命令。

示例：

```text
Use $sliver-vibe-coding to 帮我从零做一个客户管理系统。
Use $sliver-vibe-coding to 接管这个项目，告诉我现在该先做什么。
Use $sliver-vibe-coding to 项目跑不起来，先帮我救一下。
Use $sliver-vibe-coding to 我要加会员付费功能，先评估能不能直接做。
Use $sliver-vibe-coding to 上线前帮我做发布准备。
```

skill 内部有 `/项目体检`、`/环境启动`、`/技术选型`、`/功能开工评估`、`/收费权益设计`、`/质量验收`、`/部署路线` 等路由标签，但这些是给 AI 调度流程用的。普通用户可以不输入这些命令。

## 安装

推荐使用 HTTPS，适合没有配置 Gitee SSH Key 的用户：

```bash
git clone https://gitee.com/sliver-ring_admin/sliver-vibe-coding.git ~/.codex/skills/sliver-vibe-coding
```

已经配置 Gitee SSH Key 的用户也可以用 SSH：

```bash
git clone git@gitee.com:sliver-ring_admin/sliver-vibe-coding.git ~/.codex/skills/sliver-vibe-coding
```

如果已经克隆到别的位置，也可以移动整个 `sliver-vibe-coding` 目录到：

```text
~/.codex/skills/sliver-vibe-coding
```

固定版本安装：

```bash
cd ~/.codex/skills/sliver-vibe-coding
git checkout v0.1.0
```

如果还没有发布 tag，可以用具体 commit hash 固定版本。升级和兼容说明见 [COMPATIBILITY.md](COMPATIBILITY.md)，版本变化见 [CHANGELOG.md](CHANGELOG.md)。

## 目录结构

```text
sliver-vibe-coding/
├── VERSION
├── CHANGELOG.md
├── COMPATIBILITY.md
├── SKILL.md
├── agents/
│   └── openai.yaml
├── scripts/
│   ├── validate_skill.py
│   └── evaluate_routes.py
├── tests/
│   └── route-eval-cases.json
└── references/
    ├── project-flow.md
    ├── project-intake.md
    ├── task-risk-gates.md
    ├── commands.md
    ├── routes-intake.md
    ├── routes-rescue.md
    ├── routes-git.md
    ├── routes-feature.md
    ├── routes-backend.md
    ├── routes-validation.md
    ├── routes-release.md
    ├── routes-constitution.md
    ├── question-bank.md
    ├── tech-stack.md
    ├── frontend-skeleton.md
    ├── database-design.md
    ├── backend-boundary.md
    ├── backend-skeleton.md
    ├── third-party-integration.md
    ├── monetization-and-entitlements.md
    ├── beginner-failure-modes.md
    ├── security.md
    ├── git-and-delivery.md
    ├── agent-constitution.md
    └── agent-constitution-template.md
```

## 核心工作流

默认顺序是：

1. 确认项目目录、开发资料真源和 Git 保护。
2. 建立启动基线，确认项目能不能跑起来。
3. 补齐立项、用户、MVP、功能边界和不做什么。
4. 拆分复杂功能和大阶段。
5. 只推荐一个技术路线，并说明拒绝其他路线的原因。
6. 建立项目架构和 agent 宪法。
7. 按需要建立前端、数据库、后端、安全基础。
8. 为当前阶段写实施真源，再按子阶段开发。
9. 做用户验收、质量验收、Git checkpoint。
10. 上线前做部署路线、发布准备和运维交接。

已有项目不会被强行重来。skill 会先做只读体检，找到当前项目最早缺失或不稳定的环节，再选择下一步。

## 验证

本仓库自带校验脚本，不依赖 PyYAML 或其他第三方包：

```bash
python3 scripts/validate_skill.py
python3 scripts/evaluate_routes.py
```

也可以用官方 skill 校验脚本检查基础结构：

```bash
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py /path/to/sliver-vibe-coding
```

当前要求：`SKILL.md` 的 frontmatter 有效，执行路由不再依赖单个大 `commands.md`，引用文件在仓库内，轻量/标准/高风险门禁存在，安装和版本治理说明完整，README 只作为仓库说明，不作为 skill 运行依赖。

## 许可证

本项目采用 Apache License 2.0 开源许可，SPDX 标识为 `Apache-2.0`。完整许可文本见 [LICENSE](LICENSE)。