dev-init

Solid

项目初始化子类型规范 — 新项目/模块脚手架 + Profile 自动生成

AI & Automation 263 stars 34 forks Updated 2 days ago AGPL-3.0

Install

View on GitHub

Quality Score: 81/100

Stars 20%
81
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
87
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Dev Init Skill ## 触发条件 用户要求初始化新项目、新模块、新仓库,典型场景:从零搭建项目脚手架、初始化 monorepo 子包、创建新服务模板。 ## 执行流程 | 步骤 | 动作 | |------|------| | 1 | 收集项目信息:名称/技术栈/包管理器/团队规范 | | 2 | CP1:确认技术栈选型和目录结构 | | 3 | CP2:确认依赖清单和配置文件方案 | | 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-lite` | README、01~03、`config.json` | | `profile-standard` | lite + 04、05、`06-功能清单.md` | | `profile-closed-loop` | standard + `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...

Details

Author
devcodex-labs
Repository
devcodex-labs/devcodex
Created
5 months ago
Last Updated
2 days ago
Language
JavaScript
License
AGPL-3.0

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

skill-devkit

Empty-folder initializer for an Agent Skill repo, or one-time adopt of an existing ungoverned skill. Versioning, frozen baselines, changelog/CR, change gates, trigger phrases, pack and release audit. Use once, then this kit exits. 空文件夹一次初始化 Skill 开发仓,或收编已有但无规范的技能。覆盖:版本控制、 冻结基线、升级记录、变更门禁、触发词、一键打包、发布审计。问完即落盘,本包退场。 触发:初始化skill、初始化技能、初始化技能仓库、开发一个skill、开发一个技能、 新建skill、新建技能、创建skill、创建技能、收编skill、收编这个skill、 init skill、scaffold skill、adopt skill、/skill-devkit、/skill-devkit init、 /init-skill、/new-skill、/skill-devkit adopt。 空仓走初始化;已有 SKILL.md 但无规范走收编。不要用于普通非空目录、已规范仓的升级发版、 项目日报待办周报。同义开口见 references/04-triggers.md。

2 Updated 3 days ago
qiusuo0226
AI & Automation Listed

cm-init

用户说“第一次接管这个项目”“分析仓库并生成项目规则”时使用。分析已有代码并生成 Codex AGENTS.md 与 CM/Claude 兼容规则;仅适用于非空存量项目,不创建脚手架、不承接普通代码修改。

2 Updated yesterday
kingxiaozhe
AI & Automation Listed

docs-driven-workflow

Use when starting or finishing any coding/editing task in a project that follows a documentation-first AI collaboration workflow — declare scope before editing, log every change afterward with a changelog entry, scaffold a brand-new project with this discipline (AGENTS.md/README/docs skeleton), or audit and reorganize a project's folder structure against its own documented conventions.(中文触发词:初始化新项目/搭 AGENTS.md 骨架、存量项目接入文档驱动规范、整理文件夹/文件归档、改动前声明范围、改动后写 CHANGELOG/留痕)

4 Updated 3 weeks ago
MNICKZ