# aicoding

**Repository Path**: cuone/aicoding

## Basic Information

- **Project Name**: aicoding
- **Description**: 常用 AI 编程开发规则，文档编写规范
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 3
- **Created**: 2025-06-19
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: cursor, rules

## README

# aicoding

`aicoding` 是团队统一的 AI 协作规则仓库，规则真源位于 `.agents/`，当前使用环境为 Codex。

## 快速使用

1. 将 `.agents/` 和 `AGENTS.md` 拷贝到业务仓根目录。
2. 保持目录结构不变，开箱即用。

## 目录

- `AGENTS.md`：入口说明（加载顺序、优先级、基线约束）。
- `.agents/rules/`：通用规则与技术栈增量规则。
- `.agents/skills/`：skill 路由与各 skill 执行说明。

## 常用 Skill

- `spec-workflow`：生成 spec/plan/tasks 三件套（`docs/specs/NNN-short-name/`）。
- `dev-document`：生成开发文档三件套（需求分析/概要设计/详细设计）。
- `fix-bug`：执行问题排查、最小改动修复与验证输出。
- `git-commit`：生成规范提交信息建议。
- `create-pr`：生成结构化 PR 标题与正文。

## 规则真源

- skill 命中、优先级与冲突处理，以 `.agents/skills/skills.yaml` 为唯一依据。
- 默认最小改动；未经确认不执行提交、合并、发布。


## 使用命令

- `$<skill-name>`：显式调用 skill（例如 `$fix-bug`、`$dev-document`）。
- `Shift+Tab`：切换 Plan 模式。

## 版本与升级记录

- 详见 [CHANGELOG.md](./CHANGELOG.md)。
- 当前已从 `.cursor` 体系迁移到 `.agents` 体系，请按 `AGENTS.md` + `.agents/skills/skills.yaml` 使用。