Project Init

SkillFiles & storage

Project-init helps your AI set up a brand-new coding project from scratch. Once added, your AI can create a standard folder structure, write a project-level AGENTS.md file, and lay down starter files that match your tech stack. It is meant for empty or newly started repositories and leaves existing configuration files in place rather than overwriting them.

Available today. Use it from your connected AI after setup.

After adding it, ask your AI to initialize a new project and tell it which tech stack you are using. It will build out the folder structure, AGENTS.md, and starter files from there.

Then ask your AI: use the Project Init skill

What your AI can do with it

  • Start a new coding project from an empty repository
  • Create a standard folder structure for the project
  • Generate a project-level AGENTS.md file
  • Lay down starter scaffolding files based on the chosen tech stack
  • Leave existing configuration files untouched instead of overwriting them

What this skill tells your AI

The instructions your AI receives, as published by doccker/cc-use-exp in .codex/skills/cc-project-init/SKILL.md and read by ahel’s review.

当用户明确要求 project-initcc-project-init、初始化新仓库、生成项目级 AGENTS.md,或按技术栈补基础脚手架时,使用本技能。

不要用于:

  • 已成熟项目上的大规模重写
  • 代替 feature 开发或 bug 修复
  • 无确认地覆盖已有 AGENTS.mdDockerfile 或脚本
  • 为 Claude/Gemini 生成专属配置文件
  • 默认生成 README.md 这类扫描型项目文档;需要生成或刷新 README 时使用 project-scan

核心方式

  1. 先读取仓库现状,判断是不是空仓库、样板仓库,还是已有部分脚手架。
  2. 优先从现有文件推断技术栈,再只问缺失的关键信息:项目描述、启动方式、数据库迁移、额外约定、是否需要脚手架文件。
  3. 需要项目级说明时,以 assets/AGENTS.project.md 为起点生成仓库根目录 AGENTS.md,内容聚焦项目特定约定,不重复用户级全局规则;模板中的 AUTO:* 区块可供后续 project-scan 增量刷新。若项目包含 Java 代码,需遵守项目署名约定:文档和代码署名统一使用 wwj,新增 Java 文件或补齐文件头注释时使用 @author wwj
  4. 默认同时初始化项目级 .codex/ 最小骨架:.codex/tasks/.codex/tasks/archived/.codex/templates/,保证后续 new-feature 可直接持久化任务;若这些目录已存在,则只补缺失项,不整目录覆盖。若项目根目录本身没有写权限,必须先触发平台原生审批流程;只有审批后仍失败,才说明当前会话无法在该项目内初始化骨架。
  5. 只有用户明确要创建或补齐额外脚手架时,才从 assets/ 选择对应模板;不要默认把所有模板都写进仓库。
  6. 如果目标文件已存在,先比较差异并说明保留/合并策略,避免整文件覆盖。
  7. 若用户预期生成 README.md、技术栈摘要、目录结构或快速开始说明,明确说明这是 project-scan 的职责,并建议继续执行 $project-scan
  8. 完成后说明创建了哪些文件、哪些模板没有使用,以及后续建议。

资源选择

  • 项目级说明模板:assets/AGENTS.project.md
  • 项目级 .codex 骨架:assets/codex-skeleton/
  • Go/Docker/compose/重启脚本模板:按需从 assets/ 选择
  • 具体选择规则:references/template-selection.md

输出要求

  • 先说明识别到的项目形态和技术栈假设
  • 只为用户确认过的文件落盘
  • 新建文件默认可直接用,但保留最少必要占位符
  • 明确指出哪些内容仍需用户补充或替换
  • 若用户已执行 tools/sync-config.sh,必须明确说明项目级 .codex 骨架仍需在目标项目根目录内由 project-initnew-feature 实际落盘,不要把用户级 ~/.codex/project-template/.codex/ 当成已完成的项目初始化

Signals

GitHub stars
1k
Forks
112
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
project-init-doccker
Source
github.com/doccker/cc-use-exp