当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
FreePublished on GitHub
project-init
结构化新项目初始化工作流，适用于显式 project-init、仓库开荒、生成项目级 AGENTS.md 或按技术栈落基础脚手架文件的场景；不负责替用户无差别覆盖现有配置。
The English summary is being prepared. Showing the original description.
See how to installFiles included (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 (original)
Review the instructions the agent will receive before you install.
Project Init
当用户明确要求 project-init、cc-project-init、初始化新仓库、生成项目级 AGENTS.md，或按技术栈补基础脚手架时，使用本技能。
不要用于：
- 已成熟项目上的大规模重写
- 代替 feature 开发或 bug 修复
- 无确认地覆盖已有
AGENTS.md、Dockerfile或脚本 - 为 Claude/Gemini 生成专属配置文件
- 默认生成
README.md这类扫描型项目文档；需要生成或刷新 README 时使用project-scan
核心方式
- 先读取仓库现状，判断是不是空仓库、样板仓库，还是已有部分脚手架。
- 优先从现有文件推断技术栈，再只问缺失的关键信息：项目描述、启动方式、数据库迁移、额外约定、是否需要脚手架文件。
- 需要项目级说明时，以
assets/AGENTS.project.md为起点生成仓库根目录AGENTS.md，内容聚焦项目特定约定，不重复用户级全局规则；模板中的AUTO:*区块可供后续project-scan增量刷新。若项目包含 Java 代码，需遵守项目署名约定：文档和代码署名统一使用wwj，新增 Java 文件或补齐文件头注释时使用@author wwj。 - 默认同时初始化项目级
.codex/最小骨架：.codex/tasks/、.codex/tasks/archived/、.codex/templates/，保证后续new-feature可直接持久化任务；若这些目录已存在，则只补缺失项，不整目录覆盖。若项目根目录本身没有写权限，必须先触发平台原生审批流程；只有审批后仍失败，才说明当前会话无法在该项目内初始化骨架。 - 只有用户明确要创建或补齐额外脚手架时，才从
assets/选择对应模板；不要默认把所有模板都写进仓库。 - 如果目标文件已存在，先比较差异并说明保留/合并策略，避免整文件覆盖。
- 若用户预期生成
README.md、技术栈摘要、目录结构或快速开始说明，明确说明这是project-scan的职责，并建议继续执行$project-scan。 - 完成后说明创建了哪些文件、哪些模板没有使用，以及后续建议。
资源选择
- 项目级说明模板：
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/当成已完成的项目初始化
Reviews
No reviews yet. Tell others what you thought.
Comments
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
More skills from this repository
当设计或修改 REST API 响应结构、处理 API 返回值，或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义，以及生成产物时关键字段缺失但静默成功的问题。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
api-proxy-safety
Free网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范，防止纯子串匹配误判正常响应内容中的技术术语（如 Cloudflare、502、error）
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
当 API/任务可能执行超过 10 秒（批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合）时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
bash-style
FreeBash 脚本与系统命令规范。禁止行尾注释，强制使用 tee/heredoc 写入，提升命令执行的可维护性。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
bash-style
Free当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件，或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026