ContiNew Start Skill

自动化 ContiNew Admin 项目初始化，支持自定义品牌和配置

---

概述

ContiNew Start Skill 是一个专为 Claude Code 设计的技能，用于自动化初始化和定制基于 ContiNew Admin 框架的项目。它简化了品牌化、包重命名和项目配置的流程。

功能特性

• 🚀 快速初始化：几分钟内完成项目设置，而非数小时
• 🎨 品牌定制：将 continew 品牌替换为您自己的品牌
• 📦 包重构：自动更新 Java 包路径
• 🗂️ 目录重命名：重组项目目录以匹配您的品牌
• ⚙️ 模块管理：移除不需要的可选组件
• 📝 元数据更新：更新 README、配置文件和文档

功能说明

操作	描述	示例
品牌替换	替换文件中的品牌名称	continew → mycompany
包路径更新	更新 Java 包结构	top.continew.admin → com.mycompany.admin
目录重命名	重命名项目目录	continew-admin → mycompany-admin
内容替换	智能文本替换	保留 ContiNew 首字母大写
模块移除	移除可选模块	continew-extension-schedule-server

安装

方法 1：使用 Claude Skills CLI（推荐）

npx skills add itxaiohanglover/continew-start-skill

方法 2：手动安装

1. 从 Releases 下载 continew-start-skill.skill
2. 使用以下命令安装：

npx skills add path/to/continew-start-skill.skill

快速开始

交互模式

直接让 Claude 帮您初始化项目：

"初始化一个新的 ContiNew Admin 项目，名称为 'MyCompany Admin'，包名为 'com.mycompany.admin'"

配置文件模式

1. 从 assets/ 目录复制 config-template.yaml
2. 根据您的需求自定义配置：

brand:
  old: continew
  new: mycompany

package:
  old: top.continew.admin
  new: com.mycompany.admin

directories:
  rename:
    - from: continew-admin
      to: mycompany-admin
    - from: continew-server
      to: mycompany-server

modules:
  remove:
    - continew-extension-schedule-server

3. 运行初始化脚本：

python scripts/init_project.py --config my-config.yaml

使用示例

示例 1：公司品牌化

创建公司品牌的管理局平台：

brand:
  old: continew
  new: techcorp

package:
  old: top.continew.admin
  new: com.techcorp.admin

示例 2：学习项目

设置个人学习环境：

brand:
  old: continew
  new: learn

package:
  old: top.continew.admin
  new: com.learn.admin

modules:
  remove: []  # 保留所有模块

示例 3：SaaS 产品

初始化 SaaS 产品：

brand:
  old: continew
  new: cloudadmin

package:
  old: top.continew.admin
  new: com.saas.cloud

modules:
  remove:
    - continew-extension-schedule-server
    - continew-plugin-generator  # 移除代码生成器

项目结构

continew-start-skill/
├── logo.png                              # 项目 Logo
├── SKILL.md                              # 主技能文档
├── README.md                             # 本文件
├── LICENSE                               # Apache License 2.0
├── scripts/
│   └── init_project.py                   # Python 初始化脚本
├── references/
│   └── replacement-rules.md              # 详细的替换模式指南
└── assets/
    └── config-template.yaml              # 配置文件模板

文档

• SKILL.md - 完整的技能文档和工作流程详情
• 替换规则 - 替换模式综合指南
• 配置模板 - 带注释的配置文件

系统要求

• Python 3.7 或更高版本
• PyYAML 库：pip install pyyaml

重要提示

⚠️ 运行初始化前务必备份您的项目！

• 先备份：创建原始项目的备份
• 大小写敏感：替换保留大小写（如 ContiNew 保持不变）
• 模块依赖：移除模块前验证依赖关系
• IDE 设置：包更改后更新 IDE 项目设置
• Git 历史：考虑为定制的项目初始化新的 git 历史

常见问题

常见问题解决

问题	解决方案
找不到模块	检查模块是否存在于您的项目中
包路径不匹配	验证旧包名是否与您的项目匹配
替换后导入错误	运行 mvn clean install 刷新依赖
Git 推送失败	检查远程仓库权限和分支设置

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 Apache License 2.0 许可证 - 详见 LICENSE 文件。

相关链接

• ContiNew Admin - 基础框架
• ContiNew Starter - Starter 依赖
• ContiNew 文档 - 官方文档

---

为 ContiNew 社区用 ❤️ 打造