# AI_coding

**Repository Path**: ai-code-fun/ai_coding

## Basic Information

- **Project Name**: AI_coding
- **Description**: 企业 AI 辅助编程公共资产库：编码规范、行为规范、Skills 工作流、知识库与同步工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-08
- **Last Updated**: 2026-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai_coding

企业 **AI 辅助编程公共资产库**：编码规范、行为规范、Skills 工作流、知识库与同步工具。与业务代码仓库解耦，由 Cursor **`.cursor/`** 单源维护。

## 核心入口（必读）

| 入口 | 路径 | 给谁看 | 干什么 |
|------|------|--------|--------|
| **AGENTS** | [AGENTS.md](./AGENTS.md) | AI Agent | 操作入口：档位路由、阶段、红线、改哪个仓 |
| **基座手册** | [doc/AI编码基座说明手册.html](./doc/AI编码基座说明手册.html) | 人（浏览器） | 体系说明：档位、八阶段、Skills/规则/知识库、红线（与当前 Skill 同步） |
| **流水线手册** | [.cursor/skills/ai-coding-workflow/全流程使用样例.html](./.cursor/skills/ai-coding-workflow/全流程使用样例.html) | 人（浏览器） | 按档位复制各阶段提示词；阶段 × 档位一览 |

> Agent 以 **AGENTS** + Skills/知识库为准；人读说明看 **基座手册**，跑流水线复制提示词看 **流水线手册**。

---

## 知识库

路径：[`.cursor/knowledge/`](.cursor/knowledge/)（唯一权威源，会话内 `@` 引用）

| 文档 | 用途 |
|------|------|
| [AI编码行为规范](.cursor/knowledge/AI编码行为规范.md) | 协作边界、测试/文档/Git、变更 SQL 执行门禁 |
| [AI Git操作规范](.cursor/knowledge/AI Git操作规范.md) | 可写 / 高风险 / 禁止执行的 Git 操作 |
| [AI 共享目录操作规范](.cursor/knowledge/AI共享目录操作规范.md) | `\\192.168.1.6\` 白名单路径；全域禁删 |
| [AI Apollo操作规范](.cursor/knowledge/AI Apollo操作规范.md) | 仅登录与配置拉取；禁修改/删除/发布 |
| [AI向人提问规范](.cursor/knowledge/AI向人提问规范.md) | 决策式提问：分轮、选项、回复模板 |
| [Java代码规范](.cursor/knowledge/Java代码规范.md) | Java / P3C 融合完整版 |
| [模块开发规范流程](.cursor/knowledge/模块开发规范流程.md) | 八阶段流水线详表 |
| [架构设计双格式约定](.cursor/knowledge/架构设计双格式约定.md) | 详设 MD + HTML 成对 |
| [设计文档HTML生成规范](.cursor/knowledge/设计文档HTML生成规范.md) | HTML 图表放大等 |
| [工作区仓库分工](.cursor/knowledge/工作区仓库分工.md) | 多仓改哪个 |
| [数据库脚本命名规范](.cursor/knowledge/数据库脚本命名规范.md) | Flyway `V{YYYYMMDDHHMM}__*.sql` |
| [企业工程结构知识库模板](.cursor/knowledge/企业工程结构知识库模板.md) | 微服务结构模板 |
| [概要设计知识库模板](.cursor/knowledge/概要设计知识库模板.md) | 概要设计章节模板 |

索引：[.cursor/knowledge/README.md](.cursor/knowledge/README.md)

## 规则

路径：[`.cursor/rules/`](.cursor/rules/)（打开本仓即生效，无需 `@`；正文以知识库为准）

| Rule | 对应知识库 | 作用 |
|------|------------|------|
| `ai-coding-behavior` | AI编码行为规范 | 交付边界、变更 SQL 门禁/删数、设计→落地物→计划交接 |
| `ai-git-operations` | AI Git操作规范 | Git 安全红线 |
| `shared-network-path-gate` | AI 共享目录操作规范 | `\\192.168.1.6\` 白名单 + 禁删 |
| `apollo-readonly-gate` | AI Apollo操作规范 | Apollo 仅登录与拉取；禁写 |
| `ai-human-questioning` | AI向人提问规范 | 拍板提问仪式 |
| `ai-coding-workflow` | 模块开发规范流程 | 档位路由、阶段门禁 |
| `java-code-standards` | Java代码规范 | 写 Java 时触发摘要 |
| `design-doc-dual-format` | 架构设计双格式约定 | 详设双格式同步 |
| `workspace-repos` | 工作区仓库分工 | 多仓不得静默默认第一仓 |

## 技能

路径：[`.cursor/skills/`](.cursor/skills/) · 完整清单见 [skills/README.md](.cursor/skills/README.md)

### 总控

| Skill | 说明 |
|-------|------|
| [ai-coding-workflow](.cursor/skills/ai-coding-workflow/) | 四档位路由；设计 1～4 / 研发 5～8 编排（`Spec → 落地物补齐 → 计划 → 编码`） |

### 企业自有

| Skill | 位置 | 说明 |
|-------|------|------|
| [iteration-scoping](.cursor/skills/iteration-scoping/) | 阶段 1 前置 | 迭代范围界定（仅用户显式要求锁定范围时） |
| [architecture-review](.cursor/skills/architecture-review/) | 阶段 2a | Spec 技术审阅，产出 P0/P1/P2 与 GO / 有条件 GO / NO-GO |
| [human-questioning](.cursor/skills/human-questioning/) | 阶段 2b 等 | 结构化决策式提问，回写 Spec 决策表 |
| [architecture-group-freeze](.cursor/skills/architecture-group-freeze/) | 阶段 3 | 大迭代架构组验收冻结（产品/架构/研发/测试） |
| [api-smoke-testing](.cursor/skills/api-smoke-testing/) | 阶段 7 | 基于 API **场景测试 / 单接口**自动化冒烟；失败则 Loop 消缺至通过；集成 `local-service-manager` 做服务启停与就绪 |
| [spec-code-consistency](.cursor/skills/spec-code-consistency/) | 阶段 8 | 需求→设计→计划→代码→冒烟 追溯核对与 baseline 校验 |
| [change-request-flow](.cursor/skills/change-request-flow/) | 贯穿 | 需求变更 CR、影响面矩阵、按层级回流 |
| [detailed-design-doc](.cursor/skills/detailed-design-doc/) | 按需 | 从 Spec 生成双格式详细设计（MD + HTML） |
| [quality-compliance-doc](.cursor/skills/quality-compliance-doc/) | 按需 | 质量合规五类 HTML（概要/详细/库表/需求点/禅道） |
| [domain-docs-init](.cursor/skills/domain-docs-init/) | 辅助 | 业务仓 `docs/` 目录标准与根 README |
| [java-ddd-scaffold](.cursor/skills/java-ddd-scaffold/) | 辅助 | 标准 Java DDD / BFF Maven 多模块脚手架 |
| [code-review-simplify](.cursor/skills/code-review-simplify/) | 辅助 | 代码评审简化 |

### 开源 Skills（Superpowers）

目录：[superpowers/](.cursor/skills/superpowers/)（上游同步，勿手改）

本仓流水线实际用到的：

| Skill | 说明 |
|-------|------|
| `brainstorming` | 需求探索与 Spec 设计（阶段 1） |
| `writing-plans` | 研发计划总分/分包（阶段 5） |
| `executing-plans` | 按 plan 编码执行（阶段 6） |

## 工具

路径：[`.cursor/tools/`](.cursor/tools/)（Skill 调用的公共手段，非仓库根目录维护脚本）

| 工具 | 说明 |
|------|------|
| [local-service-manager](.cursor/tools/local-service-manager/) | 本地服务启停与就绪探测 |
| [jwtgen](.cursor/tools/jwtgen/) | 开发用 JWT Token 生成 |
| [api-smoke-testing](.cursor/tools/api-smoke-testing/) | 冒烟报告 HTML、env 模板、人机交接等配套 |
| [md-to-html](.cursor/tools/md-to-html/) | Markdown → HTML（详设双格式等） |
| [xlsx-to-md](.cursor/tools/xlsx-to-md/) | Excel → Markdown |
| [mybatis-sql-probe](.cursor/tools/mybatis-sql-probe/) | MySQL 只读探测 |

---

## 快速开始

1. 工作区同时打开 **ai_coding** + 目标业务仓（如 eworld-dam）。
2. **新功能 / 头脑风暴 / 版本迭代** 默认走 `ai-coding-workflow`（先宣告档位，再 invoke 子 Skill）；`@需求` 或口述即可。
3. 编码：`@业务仓/docs/...详细设计.md`（优先 Markdown）。
4. 规范变更：在本仓提 PR，不在业务仓复制规范正文。

---

## 流水线档位（摘要）

| 档位 | 场景 | 阶段 |
|------|------|------|
| **Enterprise** | 正式版本交付、跨仓库、表结构或对外接口变更 | 设计到提交全流程（落地物补齐强制；无接口可跳过冒烟） |
| **Standard** | 业务仓内单功能 / 单模块增量 | 设计 →（可选评审）→ 落地物补齐 → 计划 → 编码 → 冒烟 → 提交前门禁 |
| **Lite** | 原型 / 最小可用版本 | 设计 → 落地物补齐 → 计划 → 编码 → 冒烟 → 提交前门禁 |
| **Direct** | 单点修改 / 紧急修补 | 不走流水线 |

提示词与完整矩阵 → **流水线手册**；体系说明 → **基座手册**；Agent 操作 → **AGENTS**。