cowde

Cowde 是一个项目代码仓库和 Vibe Coding 规范生成器。

当前命令

npx cowdevibe init usercenter
npx cowdevibe init -t java usercenter
npx cowdevibe init -t vue usercenter
npx cowdevibe update usercenter
npx cowdevibe check
npx cowdevibe skill
npx cowdevibe skill -f

代码生成器会根据项目名称生成：

• <name>-service
• <name>-web
• CODINGRULE.md
• coding/backend/RULE.md
• coding/frontend/RULE.md

Vue 模板会同时生成 .env.development 和 .env.production，默认使用 /api 请求前缀且不启用预览模式。

初始化后会在 .cowde/manifest.json 写入模板版本、服务端口（默认 8080）和前端端口（默认 5173）。需要调整端口时直接编辑 manifest，再执行 update；check 命令会校验 manifest 和端口配置。

skill 会将 templates/skills 中的 Agent Skill 安装到当前目录的 .agents/skills/。目标中存在同名 Skill 时默认报错；使用 skill -f 才会覆盖。

update 使用初始化时生成的 .cowde/manifest.json 识别代码基线：固定规范文档始终覆盖；新模板文件直接添加；用户未修改的代码和配置文件更新；用户修改且模板也变化时保留原文件，并生成同目录的 _update 候选文件。模板删除的旧文件不会自动删除。

再次执行 init 时，如果当前目录已有 .cowde/manifest.json，会先校验 manifest，再按上述更新策略合并模板，不会因为已有模块目录直接拒绝。

发布 NPM

Windows 下可以使用：

npm run release

发布脚本会依次执行测试、预览发布内容、检查 NPM 登录状态和发布。第一次使用或登录状态失效时，会进入 npm login 官方交互式登录流程；不要把 NPM 密码写入脚本、项目文件或命令行参数。

默认发布前自动执行 patch 版本升级，例如 0.1.0 升为 0.1.1。

需要发布功能版本时，可以显式指定版本升级类型：

npm run release -- -VersionBump patch

已发布过的版本不能重复覆盖。如果看到 You cannot publish over the previously published versions，使用上面的版本更新命令；当前 0.1.0 已发布，下一次应使用 patch 发布 0.1.1。

Java 包名固定以 cn.cowde.<project-name> 为基础，并由生成器负责处理项目名称转换。