# ai-native-skills

**Repository Path**: laboratorycoder/ai-native-skills

## Basic Information

- **Project Name**: ai-native-skills
- **Description**: 实践AI-sdlc开发流程
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-12
- **Last Updated**: 2026-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai-native-skills

用于集中存放 AI Native Skills 的仓库。每个 skill 独立成一个目录，包含一份 `SKILL.md` 作为入口说明。

## 目录结构

```
ai-native-skills/
├── README.md                        # 本文件，仓库说明
├── understanding-and-requirements/  # 理解与需求组
├── design-and-standards/            # 设计与规范组
├── testing-and-deployment/          # 测试与部署组
├── spec-templates/                  # 规格模板组
├── skills/                          # 早期 skill 存放目录（保留）
├── reference/                       # 参考资料
└── <group>/<skill-name>/            # 一个 skill 一个目录，名称用 kebab-case
    ├── SKILL.md                     # 必需：skill 入口说明
    └── ...                          # 可选：脚本、模板、参考资料等
```

## 新增一个 Skill

1. 在所属小组目录（见下方「小组与目录映射」）下创建目录，目录名使用小写 kebab-case（如 `web-search`）。
2. 在目录内创建 `SKILL.md`，至少包含以下 frontmatter：

```markdown
---
name: skill-name          # 唯一标识，与目录名一致
description: 一句话说明这个 skill 做什么、什么时候使用
---

# Skill 标题

## 何时使用
说明触发场景。

## 使用方式
具体步骤或指令。
```

3. 如需附带脚本、示例或资源，放在同一 skill 目录内，并在 `SKILL.md` 中引用。

## 约定

- 目录名与 `SKILL.md` 中的 `name` 保持一致。
- `description` 需清晰写明「做什么」和「何时用」，便于被检索和调用。
- 一个 skill 只解决一类明确的任务，避免功能过于宽泛。
- 不要把资源散落在仓库根目录，一律归入对应 skill 目录。

## 小组与目录映射

仓库根目录按小组划分独立文件夹，各组代码统一提交至对应目录下。文件夹名统一使用英文，配套中文小组名称便于识别。

| 目录（英文） | 小组（中文） | 说明 |
| --- | --- | --- |
| `understanding-and-requirements/` | 理解与需求组 | 需求理解、澄清与需求侧产出 |
| `design-and-standards/` | 设计与规范组 | 方案设计与研发规范相关产出 |
| `testing-and-deployment/` | 测试与部署组 | 测试用例、自动化与部署相关产出 |
| `spec-templates/` | 规格模板组 | 规格说明与模板类产出 |

### 提交约定

- 各组只在本组对应目录内提交代码与文档，避免跨目录混放。
- 各目录内均放置一份 `README.md`，标明该目录对应的中文小组名称。
- 根目录原有文件与目录（如 `skills/`、`reference/`）保持不变。

## 现有 Skills

### understanding-and-requirements/（理解与需求组）

| Skill | 说明 |
| --- | --- |
| [project-init](understanding-and-requirements/project-init/SKILL.md) | 初始化项目标准目录结构与工程化基线文件（AGENTS.md、docs/ 等） |
| [prd-generator](understanding-and-requirements/prd-generator/SKILL.md) | 基于 grilling 拷问澄清需求，产出产品视角的 PRD |
| [prd-review](understanding-and-requirements/prd-review/SKILL.md) | 审阅 PRD 并结合仓库代码核对现状，输出评审结论与建议 |
| [prototype](understanding-and-requirements/prototype/SKILL.md) | 用一次性原型回答设计问题（逻辑验证 / UI 探索） |

### testing-and-deployment/（测试与部署组）

| Skill | 说明 |
| --- | --- |
| [testcase-skill](testing-and-deployment/testcase-skill/SKILL.md) | 从 Spec + 测试点知识库 + 源码 diff 生成结构化测试用例集 |
| [testpoint-kb-skill](testing-and-deployment/testpoint-kb-skill/SKILL.md) | 构建与维护测试点知识库（导入、增量迭代、自适应建议） |
| [api-automation](testing-and-deployment/api-automation/SKILL.md) | 将测试用例集转换为可长期维护的接口自动化资产 |
| [ui-test-skill](testing-and-deployment/ui-test-skill/SKILL.md) | 将 UI 测试用例集转化为 Playwright 自动化脚本并产出报告 |
| [quality-gate-skill](testing-and-deployment/quality-gate-skill/SKILL.md) | 质量门禁 / 上线准出审核，核验扫描结果与准出报告 |
| [deploy-skill](testing-and-deployment/deploy-skill/SKILL.md) | 自动化软件交付：构建、打包、部署编排与流程反馈 |

### 其他目录

- `design-and-standards/`、`spec-templates/`：暂无 skill，等待各组补充。
- `skills/`：早期沉淀的 skill（如 `prd-from-brief`、`to-spec`、`to-tickets`、`repo-llm-wiki-skill` 等）及各小组子目录，保持原样。
- `testing-and-deployment/quality-gate-verify/`：质量门禁验证样例；`操作手册.md` 与 `skill开发记录【含skill操作手册】/` 为测试与部署组文档。