# sliver-vibe-coding

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

## Basic Information

- **Project Name**: sliver-vibe-coding
- **Description**: 抖音vibe coding实战篇中包含的所有知识点所蒸馏而成的Skill，其中包含立项、开发规范、加功能规范、宪法模版等等，反正应有尽有。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2026-07-12
- **Last Updated**: 2026-07-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sliver Vibe Coding

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

面向非技术用户的 AI 项目全生命周期开发治理 skill。

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

它是 AI 项目开发的顶层入口，不是单纯写代码执行器，也不是只在“隐藏治理风险”出现时才用的边缘插件；已经内置旧 `sliver-engineering-workflow` 的工程执行骨架。普通 bug、局部 UI、单文件改动、单测失败会先做轻量适配评估；如果没有治理风险，就按普通工程任务窄修窄验，不强制套完整项目治理流程。

技术选型会先判断平台能力、前端设计系统、单运行时优先级和跨语言成本。不会把低约束样式工具、临时组件片段、Web 无法覆盖的本地能力，或多语言后端组合直接当成默认方案。

仓库内置空项目和半路接管模板，并提供项目 guardrail 脚本，用来检查用户项目里的 `AGENTS.md`、内部真源、架构 owner、验收证据和明显漂移标记是否真正落地。它们是当前公开 skill 的一部分，不需要再安装第二套 workflow。

## 这一版重点加强了什么

- 自然语言自动路由：用户可以直接说“我要加一个功能”“项目跑不起来”“我接手了一个项目”“这个能不能上线”“上下文太长”，不需要记 slash command。
- 生命周期主入口：加功能、改行为、改页面、改流程、debug、review、release、handoff 都先进入本 skill，再由它决定是否需要轻量设计、测试先行、报错救援或质量验收。
- 普通工程任务先评估再处理：修 bug、局部 UI、单文件改动不会被强行套完整治理，但如果碰到架构、数据、权限、支付、部署、真源缺失，会自动升级。
- 空项目和半路项目都能进入：从零项目按需使用 bootstrap 模板；首次接管、启动未知、owner 不清或真源冲突的已有项目才先只读审计，并按需使用 adoption 模板。目标和 owner 明确的普通改动直接窄查、窄改、窄验。
- Git 保护更细：初始化、`.gitignore`、内部资料、参考项目库、远程地址配置、推送审批、回滚、reset、revert 都必须先做风险判断。
- 混合 commit 回滚保护：一个 commit 里混了多个功能时，不能直接整 commit revert，要先判断用户到底想撤哪个功能，再按文件或 hunk 拆。
- 技术选型更保守：优先选择 AI 熟悉、文档清楚、强规范、少从零搭架子的主路线；资料不足时先补资料，不急着吐技术栈。
- 交接不中断：上下文过长或要换 AI 时，会生成带路径、Git 状态、验证证据、风险和下一步命令的交接文本。
- 工程执行不丢失：旧 `sliver-engineering-workflow` 的 feature/change/refactor/debug/review/release/handoff 执行纪律已并入 `references/engineering-execution.md`，并由统一 `/开发执行` 主流程及救援、验收、发布、交接流程加载。
- 安全形成三层闭环：用户可以发起一次全面、只读优先的 `/安全审计`；AI 在写代码、改配置、动数据、接第三方和发布时会自动判断本次安全影响；长期安全红线会进入项目 agent 宪法模板，约束后续所有 AI。

## 适合谁

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

## 解决什么问题

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

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

## 使用方式

安装到 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 帮我全面检查项目安全，发现问题先不要改。
Use $sliver-vibe-coding to 上下文太长，给我一份新窗口继续的交接。
Use $sliver-vibe-coding to 上线前帮我做发布准备。
```

skill 会自动判断用户是在立项、接管、正常开发、救援、验收、发布还是交接。普通用户不需要说流程术语或记任何命令，只需要描述希望项目发生什么变化。

## 常用自然语言入口

| 用户可以直接说 | skill 会优先做什么 |
| --- | --- |
| 我想从零做一个项目 | 补齐立项、用户、MVP、边界和第一闭环 |
| 我接手了一个写了一半的项目 | 只读体检现状，判断从哪一步接入 |
| 项目跑不起来 | 建立启动基线，先找启动、依赖、环境变量和端口问题 |
| 帮我选技术栈 | 先检查项目资料是否足够，再给一个主推荐和拒绝理由 |
| 我要加一个功能 / 给用户增加一个角色 | 读取当前项目，完善这次改动的专业设计，确定 owner 后直接按正确深度开发和验收 |
| 只有作者能看到 / 支持上传头像 / 提交后通知管理员 | 仍按正常开发处理，并根据真实影响自动检查权限、数据、接口、第三方和安全边界 |
| 全面检查一下项目安全，先别改 | 只读审计接口、权限、数据、配置、第三方和发布面，先给风险、证据与修复顺序 |
| 没有实施真源，可以直接开发吗 | 先判断本次影响；单 owner 常规改动可直接做，跨 owner 或高风险改动才补当前阶段真源 |
| 要接 API、SDK、OAuth、支付、AI 服务 | 仍走正常开发，同时自动查官方文档、供应商边界、费用、回调、安全和验收证据 |
| 没有 git / 内部资料不能推 / 配远程仓库 | 建立 Git、忽略规则、双仓或私密资料保护边界 |
| 我要回滚 / revert 这个 commit | 先做损失审计和意图分类，禁止直接整 commit 撤销 |
| 上下文太长，换窗口继续 | 生成可复制交接，包含现状、变更、验证、风险和下一步 |

## 能力边界

- 它不是替代工程师的万能执行器，而是让 AI 在小白项目里先做正确判断、正确提问、正确留证据。
- 它不会因为任务小就完全不接管；会先做轻量评估，确认没有治理风险后再窄修窄验。
- 它不会把每次改动都包装成一套额外流程：单 owner 的常规改动可以直接完成；跨 owner 或高风险改动才补实施真源。用户只确认业务结果和重大取舍，技术落点与验证方法由 AI 负责。
- 内置模板只是起点，不能原样复制成项目真源；必须结合用户项目、文件路径、命令、owner 和验证证据改写。
- `check_project_guardrails.py` 只能检查结构和明显漂移，不替代真实启动、测试、UI、API、数据库、安全、部署或用户验收。

## 微信群

### 二群

![微信群二群：甲壳虫 Agent-vibe coding 交流](assets/wechat-group-2.jpg)

二维码有效期以图片显示为准，失效后替换 `assets/wechat-group-2.jpg`。

### 一群

![微信群一群：甲壳虫 Agent-vibe coding 交流](assets/wechat-group.jpg)

二维码有效期以图片显示为准，失效后替换 `assets/wechat-group.jpg`。

## 安装

推荐使用 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 rev-parse HEAD
git checkout <上一步输出的commit-hash>
```

如果仓库已经发布 tag，也可以把 `<上一步输出的commit-hash>` 换成具体 tag，例如 `v0.1.0`。升级和兼容说明见 [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
│   ├── evaluate_selector_pressure.py
│   ├── evaluate_execution_backbone.py
│   ├── check_project_guardrails.py
│   ├── validation_support.py
│   └── test_validation_contracts.py
├── tests/
│   ├── route-eval-cases.json
│   ├── selector-pressure-cases.json
│   └── execution-backbone-cases.json
├── assets/
│   ├── project-bootstrap/
│   ├── project-adoption/
│   ├── sliver-vibe-coding-poster.png
│   ├── wechat-group-2.jpg
│   └── wechat-group.jpg
└── references/
    ├── project-flow.md
    ├── project-intake.md
    ├── project-templates.md
    ├── context-handoff.md
    ├── engineering-execution.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. 做用户验收、质量验收、项目 guardrail、Git checkpoint。
10. 上下文过大或换 agent 时生成交接。
11. 上线前做部署路线、发布准备和运维交接。

已有项目不会被强行重来。首次接管、启动未知或真源严重不清时才先做只读体检；当前 owner 和目标明确的正常改动会直接进入开发主流程。

## 验证

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

```bash
python3 scripts/validate_skill.py
python3 scripts/evaluate_selector_pressure.py
python3 scripts/evaluate_execution_backbone.py
python3 scripts/evaluate_routes.py
python3 scripts/test_validation_contracts.py
```

也可以用你本机实际安装的官方 skill 校验脚本检查基础结构：

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

官方脚本路径在不同 Codex/Claude 环境里可能不同；本仓库 CI 不依赖该命令。当前要求：`SKILL.md` 的 frontmatter 有效，执行路由不再依赖单个大 `commands.md`，引用文件在仓库内，普通工程/轻量/标准/高风险门禁存在，安装和版本治理说明完整，README 只作为仓库说明，不作为 skill 运行依赖。selector 压力语料池覆盖 100+ 条非技术用户可能说法，用来防止入口重新变成业务词堆砌；离线脚本只验证 skill owner、生命周期语料和 discovery contract，不会把字符串匹配冒充模型已经逐条命中。execution backbone 测试按 owner 和关键章节检查执行纪律；路由契约测试验证生命周期入口、条件专业检查、owner 文件和覆盖边界，也不执行真实模型选择。负向合同测试会验证注释内容不能冒充真源、重复定义会失败、语料不能退化为空壳、合同路径不能逃出仓库。真实命中率仍必须在安装后重启 Codex，用不显式点名 skill 的新会话单独验收。

检查用户项目是否真正落地了治理真源时，用：

```bash
python3 scripts/check_project_guardrails.py /path/to/user-project --mode bootstrap
python3 scripts/check_project_guardrails.py /path/to/user-project --mode adoption
python3 scripts/check_project_guardrails.py /path/to/user-project --mode constitution
python3 scripts/check_project_guardrails.py /path/to/user-project --mode stage --stage-file dev-docs/stages/current-stage.md
```

这个脚本只做结构和明显漂移检查，不替代真实启动、测试、UI、API、数据库、安全或用户验收。

## 许可证

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