OpenParable
Skip to content
← Back to skills

Import

Development
import

Import is an Agent Skill for development published in the JaguarJack/catch-admin repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Generate Excel import class for CatchAdmin module.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/JaguarJack/catch-admin/blob/HEAD/.claude/skills/08-import/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/import, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Step 8: Generate Import Class

创建数据导入类。

File Location

modules/{Module}/Import/{Model}.php

Template

<?php

namespace Modules\{Module}\Import;

use Catch\Support\Excel\Import;
use Illuminate\Support\Collection;
use Modules\{Module}\Models\{Model};

class {Model} extends Import
{
    public function collection(Collection $rows): void
    {
        // Skip header row
        $rows->skip(1)->each(function ($row) {
            {Model}::create([
                'name' => $row[0],
                // map other columns
            ]);
        });
    }
}

Column Mapping

Excel 列索引从 0 开始:

  • Column A = $row[0]
  • Column B = $row[1]
  • Column C = $row[2]

With Validation

public function collection(Collection $rows): void
{
    $rows->skip(1)->each(function ($row, $index) {
        $data = [
            'name' => $row[0] ?? null,
            'email' => $row[1] ?? null,
        ];

        $validator = Validator::make($data, [
            'name' => 'required|string|max:100',
            'email' => 'required|email',
        ]);

        if ($validator->fails()) {
            return; // Skip invalid row
        }

        {Model}::create($data);
    });
}

Controller Usage

public function import(Request $request, {Model}Import $import)
{
    return $import->import($request->file('file'));
}