<< All versions

Skill v1.0.0

currentAutomated scan96/100
devcodex-labs/devcodex/dev-init
──Details
PublishedOctober 1, 2026 at 07:48 AM
Content Hashsha256:9bd7275ed18abf9b...
Git SHA
──Files
Files (1 file, 2.9 KB)
SKILL.md2.9 KBactive
SKILL.md · 44 lines · 2.9 KB

version: "1.0.0" name: dev-init description: 项目初始化子类型规范 — 新项目/模块脚手架 + Profile 自动生成

Dev Init Skill

触发条件

用户要求初始化新项目、新模块、新仓库，典型场景：从零搭建项目脚手架、初始化 monorepo 子包、创建新服务模板。

执行流程

步骤动作
1收集项目信息：名称/技术栈/包管理器/团队规范
2CP1：确认技术栈选型和目录结构
3CP2：确认依赖清单和配置文件方案
4生成脚手架：目录结构 + 配置文件 + 基础文件
5自动生成 Profile：由 workspace layout 解析的 <active-profile-dir>
6初始化 Git + CHANGELOG + README（README 默认通过 readme-authoring 生成）

Profile 自动生成

init 完成后必须执行 ProfileGenerationContractGate，先运行 devcodex profile plan，再按确认档位运行 devcodex profile init --tier <tier>：

档位默认生成
profile-liteREADME、01~03、config.json
profile-standardlite + 04、05、06-功能清单.md
profile-closed-loopstandard + 07-用户文档与契约规范.md

公开包、CLI、SDK、多模块、文档站或 public API 项目应根据证据选择 standard/closed-loop。新生成的 06-功能清单.md 使用 FeatureInventorySchemaV2，分离生命周期与证据状态/日期/引用，并兼容读取 V1；事实不明确时保留 unverified，不得编造。已有 Profile 升级只补缺失文件；降档必须显式 --allow-downgrade 并保留高档文件，执行 ProfileTierMigrationSafetyGate。

关键规则

  • Gray Skill 不默认部署：portfolio 中 lifecycleState=gray 的 Skill 为可选/试验能力，init / 宿主分发默认不安装到部署副本；仅 active Skill 进入默认分发（见 skill-lifecycle-governance）
  • 跳过 CP3（init 无需实施计划阶段）；同时豁免 dev-plan-review（CP3 已跳过，质量门禁不适用）；必须记录 CP3: N/A（init 子类型豁免），供 hook/fallback 区分合法豁免与漏确认
  • 生成的 .gitignore 必须覆盖当前 layout 对应的 <active-root>/.memory/；legacy 单项目模式才使用 .devcodex/.memory/
  • 依赖选型遵循项目 profile 中的技术栈约束（若已有 profile）
  • 初始化 README 时默认先写给真实使用者；开发/贡献信息后置，后续专项复审走 audit-readme
  • Node.js 项目默认生成 engines.node >=18，并同步 README、Profile 与 CI matrix；低于 v18 必须在 CP2 写明业务理由、风险和验证证据
  • 包 / 库 / adapter / CLI 初始化必须同时生成或确认代码实现层与包工程层入口：public API、public types、internal 工具、shared tests、benchmark（如适用）、docs、scripts、dist/coverage 边界、package metadata 与 changelogs/unreleased.md
All versions