# aipos

**Repository Path**: dxxyl/aipos

## Basic Information

- **Project Name**: aipos
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-26
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AIPOS — AI Agent 资料收集库

本仓库用于收集和维护平时常用的 AI Agent 资料：规则片段、提示词、技能说明、脚本、文档样例和不同 Agent 的落位说明。
目标不是整包移植到新项目，而是在使用 Codex、Cursor 等 Agent 时，按场景挑选需要的内容，放到目标项目对应的位置。

---

## 这个项目是什么

它不是一个业务系统模板，也不是“复制整仓即可用”的项目脚手架。

它更像一个 **个人/团队常用 Agent 资料库**：

- 收录通用规则：`rules/`
- 收录场景提示词：`prompts/`
- 收录 Agent 技能说明：`skills/`
- 收录初始化/检查脚本：`scripts/`
- 收录不同 Agent 的接入说明：`agents/`
- 提供不同 Agent 的落位说明：某段规则应该放进 `AGENTS.md`、`.cursor/rules/`，还是只在对话中引用

---

## 快速使用

### 维护本仓库

```text
1. 读 AGENTS.md
2. 明确当前对话、Issue、PR 或任务说明中的目标和边界
3. 新增/调整资产前读 docs/ASSET_LIFECYCLE.md + rules/anti-drift.md
4. 只改相关资产，并在 examples/ 或真实项目中验证
```

### 在新项目中取用

```text
1. 先确认目标项目使用的 Agent：Codex / Cursor / 其他
2. 阅读 agents/ 下对应 Agent 的说明
3. 从 rules/、prompts/、skills/、scripts/ 中挑选需要的内容
4. 按目标 Agent 的规则，把内容落到目标项目对应位置
5. 不需要的资料不搬运，避免污染目标项目
```

---

## 目录

| 路径 | 说明 |
|------|------|
| `AGENTS.md` | 跨工具 Agent 入口，解释仓库定位和维护原则 |
| `docs/AGENT_FILE_REFERENCE.md` | **参数词典**（`alwaysApply`、`globs`、`paths` 等） |
| `docs/` | 资料维护方法、结构说明、参考文档 |
| `rules/` | 常用规则片段和规则模板 |
| `prompts/` | 常用场景提示词 |
| `skills/` | 常用 Agent 技能说明 |
| `scripts/` | 可按需取用的自动化脚本 |
| `agents/` | 不同 Agent 的接入说明和示例适配 |
| `examples/` | 资料验证样例 |
| `src/` | 示例源码占位，不是本仓库重点 |
| `tests/` | 示例或脚本验证占位 |

---

## 新资料收录标准

新增任何规则、提示词、技能或脚本前，先问：

1. 现有资料是否已经覆盖？
2. 这条内容是否能被 Agent 执行或验证？
3. 是否适合多个项目复用，而不是某次临时调试？
4. 是否应该放进本收集库，还是只留在某个具体项目中？
5. 是否会导致 Cursor / Codex / Claude 维护三份重复规则？

详细流程见 [docs/ASSET_LIFECYCLE.md](docs/ASSET_LIFECYCLE.md)。

---

## 推荐取用策略

不要整包复制本仓库。按 Agent 和场景取用：

```text
Codex 项目：参考 agents/codex_readme.md
Cursor 项目：参考 agents/cursor_readme.md
规则片段：从 rules/ 挑选并改写到目标项目
提示词：从 prompts/ 挑选，在对话或项目文档中使用
技能说明：从 skills/ 挑选，按目标 Agent 的技能机制落位
脚本：从 scripts/ 挑选，确认路径和依赖后再放入目标项目
```

---

## 维护原则

- 规则少而准，避免“正确废话”。
- 主入口只做索引，具体资料留在对应目录。
- Agent 差异写在 `agents/`，不要把某个 Agent 的目录结构当成通用结构。
- 每份资料必须说明适用场景和不适用边界。
- 在真实项目或示例里用过后，再沉淀为稳定资料。

[MIT](LICENSE)