Embed badge
Show
Style
[](https://versuz.dev/skills/doccker-cc-use-exp-codex-skills-cc-project-init)Free SKILL.md scraped from GitHub. Clone the repo or copy the file directly into your Claude Code skills directory.
npx versuz@latest install doccker-cc-use-exp-codex-skills-cc-project-initgit clone https://github.com/doccker/cc-use-exp.gitcp cc-use-exp/SKILL.MD ~/.claude/skills/doccker-cc-use-exp-codex-skills-cc-project-init/SKILL.md--- name: project-init description: 结构化新项目初始化工作流，适用于显式 project-init、仓库开荒、生成项目级 AGENTS.md 或按技术栈落基础脚手架文件的场景；不负责替用户无差别覆盖现有配置。 --- # Project Init 当用户明确要求 `project-init`、`cc-project-init`、初始化新仓库、生成项目级 `AGENTS.md`，或按技术栈补基础脚手架时，使用本技能。 不要用于： - 已成熟项目上的大规模重写 - 代替 feature 开发或 bug 修复 - 无确认地覆盖已有 `AGENTS.md`、`Dockerfile` 或脚本 - 为 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-init` 或 `new-feature` 实际落盘，不要把用户级 `~/.codex/project-template/.codex/` 当成已完成的项目初始化