本文へ移動
cccskills
無料GitHub で公開

project-init

结构化新项目初始化工作流,适用于显式 project-init、仓库开荒、生成项目级 AGENTS.md 或按技术栈落基础脚手架文件的场景;不负责替用户无差别覆盖现有配置。

インストール方法を見る

含まれるファイル(16)

  • SKILL.md3.1 KB
  • agents/openai.yaml752 B
  • assets/AGENTS.project.md3.7 KB
  • assets/codex-skeleton/tasks/.gitkeep1 B
  • assets/codex-skeleton/tasks/archived/.gitkeep1 B
  • assets/codex-skeleton/templates/.gitkeep1 B
  • assets/docker-compose-mysql.yml.tmpl608 B
  • assets/docker-compose-redis.yml.tmpl410 B
  • assets/docker-compose-sqlite.yml.tmpl243 B
  • assets/Dockerfile-go-frontend.tmpl752 B
  • assets/Dockerfile-go.tmpl539 B
  • assets/dockerignore.tmpl486 B
  • assets/gitignore-go.tmpl1.0 KB
  • assets/restart-go.sh.tmpl955 B
  • assets/restart-java.sh.tmpl824 B
  • references/template-selection.md2.2 KB

SKILL.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/ 当成已完成的项目初始化

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0632026年8月26日 更新

当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0632026年8月26日 更新

网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0632026年8月26日 更新

当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0632026年8月26日 更新

当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0632026年8月26日 更新

Bash 编写规范。当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件, 或在 Markdown 中编写 bash/shell 代码块时触发。 包含注释规范、文件写入方式、Heredoc 引号规则、权限路径、脚本规范等。

日本語の概要は準備中です。原文の説明を表示しています。

doccker/cc-use-exp1,0632026年8月26日 更新

doccker のスキルをすべて見る

このスキルの問題を報告する