# ai_template

**Repository Path**: hxm0203/ai_template

## Basic Information

- **Project Name**: ai_template
- **Description**: Vibe Coding 框架模版
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai_template2

一套跨项目可复用的 **AI 协作架构目录 + 模版**，从 `dlabel-cloud-mall-platform` 抽离而成。

它把三类资产打包为一套可直接拷入新项目的骨架：

1. **规范层（OpenSpec）**：`openspec/`
2. **纪律层（Superpowers）**：`plugins/superpowers/`、`.cursor/skills/openspec-*`、`.cursor/commands/*`
3. **协作层（Harness）**：`.claude/` 分层 agents + 命令 + skills + hooks、`AGENTS.md`、`.cursor/doc/ai-context/`

目标：在新项目里 5–15 分钟完成基础接线，然后按业务填细节。

---

## 1. 一览

```text
ai_template2/
├── README.md                      本说明
├── TEMPLATE-USAGE.md              占位符清单与落地流程
├── AGENTS.md                      项目地图 + AI 执行入口（模板）
├── CLAUDE.md                      编码与 Git 规范（模板）
├── .claude/
│   ├── settings.json              Claude Code 工程设置（通用）
│   ├── agents/                    按层划分的 4 个专业 agent（模板）
│   │   ├── proj-common-agent.md
│   │   ├── proj-service-agent.md
│   │   ├── proj-app-agent.md
│   │   └── proj-message-agent.md
│   ├── commands/                  8 个工作流斜杠命令（模板）
│   │   ├── proj-onboard.md
│   │   ├── proj-dev.md
│   │   ├── proj-module-locate.md
│   │   ├── proj-change-apply.md
│   │   ├── proj-spec-sync.md
│   │   ├── proj-verify.md
│   │   ├── proj-review-risk.md
│   │   ├── proj-review-complete.md
│   │   └── proj-test-bootstrap.md
│   ├── hooks/                     通用 PreToolUse / PostToolUse / Stop hooks
│   │   ├── HOOKS-README.md
│   │   ├── config/
│   │   │   ├── hooks-config.json
│   │   │   └── hooks-config.example.json
│   │   └── scripts/hooks.py
│   └── skills/                    6 个专项检查技能（模板）
│       ├── api-change-checker/
│       ├── orm-change-checker/
│       ├── build-module-verifier/
│       ├── message-consumer-checker/
│       ├── xml-config-checker/
│       └── test-bootstrap/
├── .cursor/
│   ├── settings.json
│   ├── commands/                  通用命令（brainstorming / tdd / opsx-* / ...）
│   │                              + proj-change-apply / proj-test-bootstrap
│   ├── doc/ai-context/            架构、项目结构、编码规范（模板）
│   ├── prompts/                   通用 prompt 卡（api/arch/debug/fix/optimize/review/sql/trace/compact）
│   ├── rules/                     通用规则（skills-create-slash-command.mdc）
│   └── skills/                    OpenSpec 相关 skills（explore/propose/apply/archive）
├── .agents/
│   └── plugins/marketplace.json   本地插件市场注册（含 superpowers 指向）
├── plugins/
│   └── superpowers/               完整 Superpowers 技能包（纯通用）
└── openspec/
    ├── project.md                 OpenSpec 项目上下文（模板）
    ├── config.yaml
    ├── changes/archive/           历史变更归档目录（初始为空）
    └── specs/                     已采纳能力规格目录（初始为空）
```

## 2. 哪些是「纯通用，直接可用」

以下目录原样搬到新项目即可生效，基本不需要改：

- `plugins/superpowers/**`：完整 Superpowers 技能包
- `.cursor/skills/openspec-*`：OpenSpec 四步骤技能（explore / propose / apply / archive）
- `.cursor/prompts/**`：9 张通用 prompt 卡
- `.cursor/commands/` 中非 `proj-*` 命令：`brainstorming` / `executing-plans` / `test-driven-development` / `writing-plans` / `using-superpowers` 等
- `.cursor/rules/skills-create-slash-command.mdc`：新增技能必配套斜杠命令的约束
- `.agents/plugins/marketplace.json`：本地插件市场注册
- `openspec/config.yaml`：OpenSpec 工具默认配置

## 3. 哪些是「占位模板，需要替换后才生效」

以下文件含 `{{...}}` 占位符，**落地到新项目时必须替换**；清单见 `TEMPLATE-USAGE.md`。

- `AGENTS.md`、`CLAUDE.md`
- `.claude/agents/proj-*-agent.md`（建议重命名文件与内部 `name`）
- `.claude/commands/proj-*.md`
- `.claude/skills/**/SKILL.md`
- `.cursor/commands/proj-*.md`
- `.cursor/doc/ai-context/*.md`
- `openspec/project.md`
- `.claude/hooks/config/hooks-config.json`（按项目高风险路径与构建命令调整）

## 4. 落地步骤（Quick Start）

1. **拷贝骨架**：把 `ai_template2/` 内容整体拷贝到新项目根目录（可保留或丢弃顶级 `README.md` / `TEMPLATE-USAGE.md`）。
2. **通读 `AGENTS.md`**：第 2、4、7、8 节是按项目实际结构必填的。
3. **执行占位符替换**：参见 `TEMPLATE-USAGE.md` 的完整清单。建议先决定 `{{CMD_PREFIX}}`（例如 `mall`、`ops`、`pay`、`shop`），再做全局替换。
4. **重命名文件**：将 `.claude/agents/proj-*-agent.md`、`.claude/commands/proj-*.md`、`.cursor/commands/proj-*.md` 中的 `proj-` 改成你的 `{{CMD_PREFIX}}-`；同步把文件内的 `name:` / `id:` / 引用也改掉。
5. **调整 hooks**：编辑 `.claude/hooks/config/hooks-config.json`，把 `high_risk_markers`、`build_command_keyword`、`verify_command_hint`、`review_risk_command_hint` 设为项目实际值（示例字段见 `hooks-config.example.json`）。
6. **按业务补规格**：在 `openspec/specs/`、`openspec/changes/` 下按 OpenSpec 流程开始写。
7. **最小冒烟**：在新项目根目录执行 `python .claude/hooks/scripts/hooks.py < NUL` 或等价空输入，确认 hooks 脚本不报错；在 Cursor / Claude Code 里试用一条 `/{{CMD_PREFIX}}-onboard` 命令，验证命令被识别。

## 5. 工程化三层与本模板的对应

| 层次 | 管什么 | 本模板落点 |
| ---- | ---- | ---- |
| 规范层（OpenSpec） | 需求、接口、验收 | `openspec/`、`.cursor/skills/openspec-*`、`.cursor/commands/opsx-*` |
| 纪律层（Superpowers） | 计划、TDD、审查、完成前验证 | `plugins/superpowers/`、`.cursor/commands/*`、`.cursor/prompts/*` |
| 协作层（Harness） | 谁来做、如何并行、如何兜底 | `AGENTS.md`、`.claude/agents/**`、`.claude/commands/**`、`.claude/skills/**`、`.claude/hooks/**` |

调用链：**读取 OpenSpec 变更或规格 → 按 `AGENTS.md` 划分模块与风险 → 用 Superpowers / 项目规则约束实现过程 → 用构建工具（及 CI）做硬门禁 → 回到 OpenSpec 做验收或归档。**

## 6. 不在本模板里的东西

为避免引入项目强绑定，以下内容 **不** 包含：

- 具体技术栈（Spring / Dubbo / MyBatis / 业务包结构）的 `.cursor/rules/*`
- 原项目 `docs/**`（留给各项目自己写）
- 原项目 `.claude/commands/mall-*`、`.claude/agents/mall-*`、`.claude/skills/mall-test-bootstrap` 等硬编码文件（都已以 `proj-*` 模板形式重写）
- 原项目构建产物、target、log

## 7. 版本与来源

- 模板出处：从 `dlabel-cloud-mall-platform` 抽离（`F:\claude\mall\project\dlabel-cloud-mall-platform`）
- 生成时间：{{TEMPLATE_GENERATED_DATE}}（落地时可写入实际日期）
- 命名约定：`proj-*` 为占位文件名前缀；`{{CMD_PREFIX}}` 为占位斜杠命令前缀