ai-ad-code-assembler

1. **Aider** (Apache-2.0 License)
   - GitHub: https://github.com/paul-gauthier/aider
   - 借鉴内容:
     - Repo Map 项目结构概览技术
     - 多文件协同编辑模式
     - Diff 格式输出
     - 上下文管理策略

2. **Continue** (Apache-2.0 License)
   - GitHub: https://github.com/continuedev/continue
   - 借鉴内容:
     - Context Provider 系统设计
     - 工具调用机制

3. **Copier** (MIT License)
   - GitHub: https://github.com/copier-org/copier
   - 借鉴内容:
     - 模板渲染系统
     - YAML 配置驱动生成

核心能力:
- 多文件组装: 同时生成后端服务 + 路由 + 前端组件
- 依赖管理: 自动处理文件间依赖关系
- 模板驱动: 基于项目模板生成一致的代码结构

核心原则:
- 🧩 多文件组装: 同时处理后端和前端的多个文件
- 📦 依赖完整: 自动生成所需的导入和依赖
- 📋 模板驱动: 使用项目模板确保代码风格一致
- 🔗 集成就绪: 输出可直接集成到项目的代码

可选:
{
  scope: "backend" | "frontend" | "fullstack",  // 组装范围 (默认 fullstack)
  include_tests: boolean,          // 是否生成测试 (默认 true)
  include_types: boolean,          // 是否生成类型文件 (默认 true)
  output_format: "files" | "diff"  // 输出格式 (默认 files)
}

<pattern id="FRONTEND_MODULE">
  <name>前端模块组装</name>
  <structure>
    frontend/
    ├── types/
    │   └── {feature}.ts            # TypeScript 类型
    ├── api/
    │   └── {feature}Api.ts         # API 调用
    ├── hooks/
    │   └── use{Feature}.ts         # React Hooks
    ├── components/
    │   └── {Feature}/
    │       ├── index.tsx           # 主组件
    │       └── {Feature}.module.css
    └── pages/
        └── {feature}/
            └── page.tsx            # 页面组件
  </structure>
  <dependencies>
    types → api → hooks → components → page
  </dependencies>
</pattern>

<pattern id="FULLSTACK_MODULE">
  <name>全栈模块组装</name>
  <dependencies>
    backend_schema → backend_service → backend_router
    → frontend_types → frontend_api → frontend_hooks
    → frontend_components → frontend_page
  </dependencies>
</pattern>

生成方式:
1. 扫描项目目录结构
2. 提取关键文件和入口点
3. 标识本次组装涉及的文件

输出格式:
```
AI_ad_spend02/
├── backend/
│   ├── routers/
│   │   ├── daily_reports.py       # 现有
│   │   └── export.py              # [NEW] 本次新增
│   └── services/
│       ├── daily_report_service.py # 现有
│       └── export_service.py       # [NEW] 本次新增
└── frontend/
    └── components/
        └── ExportButton/           # [NEW] 本次新增
            └── index.tsx
```

    from backend.models import {Model}
    from backend.schemas.{feature}_schema import {Schema}Create, {Schema}Update


    class {ClassName}Service:
        """
        {feature_description}
        """

        def __init__(self, db: AsyncSession):
            self.db = db

        async def create(self, data: {Schema}Create) -> {Model}:
            """创建 {entity_name}"""
            # [ADAPTED] 来自参考代码
            {adapted_create_logic}

        async def get_list(
            self,
            skip: int = 0,
            limit: int = 100,
        ) -> List[{Model}]:
            """获取 {entity_name} 列表"""
            {adapted_list_logic}
    ```
  </content>
</template>

<template id="BACKEND_ROUTER">
  <file>backend/routers/{feature}_router.py</file>
  <content>
    ```python
    """
    {feature_name} Router
    [ASSEMBLED] 由 ai-ad-code-assembler 组装生成
    """
    from fastapi import APIRouter, Depends
    from sqlalchemy.ext.asyncio import AsyncSession

    from backend.core.deps import get_db
    from backend.services.{feature}_service import {ClassName}Service
    from backend.schemas.{feature}_schema import {Schema}Response

    router = APIRouter(prefix="/{feature}", tags=["{feature}"])


    @router.get("/", response_model=List[{Schema}Response])
    async def list_{feature}(
        skip: int = 0,
        limit: int = 100,
        db: AsyncSession = Depends(get_db),
    ):
        service = {ClassName}Service(db)
        return await service.get_list(skip=skip, limit=limit)
    ```
  </content>
</template>

<forbidden id="ASM-002">
  <action>破坏现有代码结构</action>
  <correct_action>新文件单独创建，现有文件标注修改点</correct_action>
</forbidden>

<forbidden id="ASM-003">
  <action>不提供集成指南</action>
  <correct_action>必须输出集成步骤和所需配置</correct_action>
</forbidden>

<forbidden id="ASM-004">
  <action>忽略文件间依赖</action>
  <correct_action>按依赖顺序组装，确保导入正确</correct_action>
</forbidden>

示例 2: 仅后端组装
「
使用 ai-ad-code-assembler，
adapted_files = [...],
requirement = "...",
scope = "backend",
include_tests = true
」

示例 3: Diff 格式输出
「
使用 ai-ad-code-assembler，
adapted_files = [...],
requirement = "...",
output_format = "diff"
」