当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。
日本語の概要は準備中です。原文の説明を表示しています。
结构化新项目初始化工作流,适用于显式 project-init、仓库开荒、生成项目级 AGENTS.md 或按技术栈落基础脚手架文件的场景;不负责替用户无差别覆盖现有配置。
インストール方法を見るインストールする前に、エージェントに与えられる指示の中身を確認できます。
当用户明确要求 project-init、cc-project-init、初始化新仓库、生成项目级 AGENTS.md,或按技术栈补基础脚手架时,使用本技能。
不要用于:
AGENTS.md、Dockerfile 或脚本README.md 这类扫描型项目文档;需要生成或刷新 README 时使用 project-scanassets/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/assets/ 选择references/template-selection.mdtools/sync-config.sh,必须明确说明项目级 .codex 骨架仍需在目标项目根目录内由 project-init 或 new-feature 实际落盘,不要把用户级 ~/.codex/project-template/.codex/ 当成已完成的项目初始化まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。
日本語の概要は準備中です。原文の説明を表示しています。
当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。
日本語の概要は準備中です。原文の説明を表示しています。
网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)
日本語の概要は準備中です。原文の説明を表示しています。
当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。
日本語の概要は準備中です。原文の説明を表示しています。
当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。
日本語の概要は準備中です。原文の説明を表示しています。
Bash 编写规范。当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件, 或在 Markdown 中编写 bash/shell 代码块时触发。 包含注释规范、文件写入方式、Heredoc 引号规则、权限路径、脚本规范等。
日本語の概要は準備中です。原文の説明を表示しています。