# ai_source

**Repository Path**: li_dg/ai_source

## Basic Information

- **Project Name**: ai_source
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-07
- **Last Updated**: 2026-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai_source

## 项目介绍

本仓库是自建全局 Skill 的统一源码仓库，用于保存可以在多个项目或工作区中复用的 Skill。

本仓库只收纳用户自行创建的通用全局 Skill，不收纳以下内容：

- Codex 官方、第三方、插件或其他外部来源安装的 Skill。
- 只服务于单个项目、产品或个人固定流程的项目私有 Skill。
- 密码、Token、私钥、Cookie 或其他敏感信息。

已收纳的 Skill 及其用途见 [Skill 目录说明](skills/README.md)。

## 目录结构

```text
ai_source/
├── AGENTS.md
├── README.md
├── scripts/
│   └── validate-skills.ps1
└── skills/
    ├── README.md
    └── <skill-name>/
        ├── SKILL.md
        ├── README.md
        └── scripts、references、assets 等可选资源
```

每个 Skill 必须同时包含：

- `SKILL.md`：Codex 的触发和执行入口。
- `README.md`：面向维护者的用途、边界、组成、依赖、验证和安装说明。

## 创建与修改流程

1. 确认目标是自行创建、可跨项目复用的全局 Skill。
2. 只在本仓库的 `skills/<skill-name>/` 中创建或修改源码。
3. 同步维护该 Skill 的 `README.md`。
4. 在仓库根目录运行校验，并检查 Git Diff。
5. 每次创建或修改完成后提交 Git 代码。
6. 提交成功后，才允许将该提交对应版本复制到实际全局安装目录。

禁止直接在 `~/.codex/skills`、`~/.agents/skills` 或其他安装目录中修改自建全局 Skill。

## 校验

在仓库根目录运行：

```powershell
.\scripts\validate-skills.ps1
```

校验内容包括 Skill 目录名、`SKILL.md`、`README.md` 和 YAML frontmatter。

## 文档语言

项目说明、维护文档和提交信息统一使用简体中文，不维护英文版项目说明。