跳到正文
cccskills
免费在 GitHub 公开

codev

Codev project management CLI — init, adopt, bootstrap-docs, update, and doctor commands. Check this skill before running any `codev` command (except `consult`, `porch`, or `afx` which have their own skills). Use when setting up new projects, adding codev to existing repos, updating framework files, or diagnosing missing dependencies.

中文简介正在准备中。当前显示原文说明。

cluesmith/codev星标 290(GitHub 290 + cccskills 0)

实测评分 未实测

查看安装方法

包含的文件(1)

  • SKILL.md4.8 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

codev - Project Management CLI

Commands

codev init [project-name]      Create a new codev project directory
codev adopt                    Add codev to the current directory
codev bootstrap-docs           Draft the governance docs from this codebase
codev update                   Update protocols, roles, skills from package
codev doctor                   Check system dependencies

codev init

Creates a new directory with the full codev structure: specs/, plans/, reviews/, protocols, CLAUDE.md, AGENTS.md, .claude/skills/, .codex/skills/, .codev/config.json, and .gitignore.

codev init my-app              # Interactive setup
codev init my-app -y           # Non-interactive with defaults

codev adopt

Adds codev to the current directory (existing project). Run from the project root. If CLAUDE.md or AGENTS.md already exists, creates .codev-new versions and spawns Claude to merge.

codev adopt                    # Interactive
codev adopt -y                 # Skip conflict prompts

On a project with code, adopt then offers to draft the governance docs (default No); with -y it only prints the command.

codev bootstrap-docs

Drafts codev/resources/{arch,lessons-learned,arch-critical,lessons-critical}.md from the codebase and git history. Rewrites only files that are still untouched starters; curated files are never edited. Always confirms before launching the agent, then reports what changed and runs a three-way review of the drafts. Nothing is committed.

codev bootstrap-docs --dry-run # Eligible files and the launch, nothing run
codev bootstrap-docs           # Draft, report, review

codev update

Updates framework files (protocols, roles, skills) from the installed @cluesmith/codev package. Never touches user data (specs, plans, reviews). Creates .codev-new versions for customized files. Missing Claude and Codex skills are added. A skill you never edited is replaced with the package's version; an edited one is kept and gets <file>.codev-new copies to merge.

codev update                   # Interactive update
codev update --dry-run         # Preview changes
codev update --force           # Overwrite all framework files
codev update --agent           # Agent mode: JSON stdout, no interactive merge

codev doctor

Checks all required dependencies: Node.js (>=18), git (>=2.5), gh (authenticated), and at least one AI CLI (Claude, Gemini, or Codex).

codev doctor

Common mistakes

  • There is NO codev tower command — use afx tower start/stop
  • codev init creates a new directory — use codev adopt for existing projects
  • Always run codev adopt and codev update from the project root
  • codev update only updates framework files — it never touches specs/plans/reviews

Local build and install (this repository)

Test changes locally before publishing. Run from the repository root:

pnpm build                  # builds core first, then codev (including dashboard)
pnpm -w run local-install   # packs both packages, installs globally, restarts Tower

local-install (scripts/local-install.sh) packs @cluesmith/codev-core and @cluesmith/codev, installs both in a single npm install -g (separate installs fail — codev-core is not on the public registry), restores the executable bit on scripts/forge/**/*.sh that pnpm pack strips, and restarts Tower last. Install runs while Tower is up; only the final restart causes downtime. Do not stop Tower first, and do not use npm link / pnpm link — it breaks global installs.

pnpm build also runs copy-skeleton, which copies codev-skeleton/ into packages/codev/skeleton. Tests read that copy, so after editing anything under codev-skeleton/ you must rebuild before the suite reflects your change.

Run codev update in this repository only with a package built from it. An older installed package treats unpublished skill edits as local edits: it writes .codev-new copies holding the older text (a merge can fold that back in), and --force overwrites the edits outright.

Where to run things

  • pnpm install — repository root (installs all workspace packages)
  • pnpm build / pnpm test — packages/codev/, or pnpm --filter @cluesmith/codev build
  • Unit tests packages/codev/tests/unit/ · E2E packages/codev/tests/e2e/
  • Never run npm commands from the repository root unless told to

Measuring code size

tokei -e "tests/lib" -e "node_modules" -e ".git" -e ".builders" -e "dist" .

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

afx

免费

Agent Farm CLI — the tool for spawning builders, managing Tower, workspaces, and cron tasks. ALWAYS consult this skill BEFORE running any `afx` command to get the exact syntax. This prevents wasting time guessing flags that don't exist. Use this whenever you need to spawn a builder, check status, send messages, clean up worktrees, manage Tower, or run cron tasks. If you're about to type `afx` followed by anything, check here first.

中文简介正在准备中。当前显示原文说明。

cluesmith/codev2902026年10月24日 更新

arch-init

免费

Adopt an architect identity and recover its state from codev/state/<name>.md. Use when an architect terminal needs to (re)establish which architect it is — after a restart, context loss, or session handoff — or when the user says "/arch-init", "you are the X architect", or "recover your architect state". Identity resolves via `afx whoami` (an explicit name argument overrides); if neither resolves, ask the human — never guess.

中文简介正在准备中。当前显示原文说明。

cluesmith/codev2902026年10月24日 更新

arch-save

免费

Save an architect's state, clear its context, and re-init automatically — the packaged save→clear→re-init refresh cycle. Use when the owner directs a context refresh, or says "/arch-save", "save and clear", "refresh your context". Runs on the owner's direction; an architect does not invoke it autonomously mid-task. Counterpart to /arch-init, which recovers the state this writes.

中文简介正在准备中。当前显示原文说明。

cluesmith/codev2902026年10月24日 更新

Refresh a builder's own context at a protocol boundary — save working state, verify it, clear, and re-orient. Use when porch emits a context-refresh task, or the builder is told to "refresh your context" / "run a self-refresh". A builder does not invoke this autonomously mid-task; porch chooses the moment. Counterpart to the architect's /arch-save.

中文简介正在准备中。当前显示原文说明。

cluesmith/codev2902026年10月24日 更新

consult

免费

AI consultation CLI — query Gemini, Codex, or Claude for reviews and analysis. ALWAYS check this skill before running any `consult` command. Use when reviewing specs, plans, implementations, or PRs with external models, running parallel 3-way reviews (cmap), or checking consultation stats. The `-m` model flag is always required except for `consult stats`.

中文简介正在准备中。当前显示原文说明。

cluesmith/codev2902026年10月24日 更新

AI image generation via Gemini with optional async providers. Use when the user wants to generate, create, or make an image, or when you need to create visual assets like logos, diagrams, or illustrations. Requires the API key for the selected provider.

中文简介正在准备中。当前显示原文说明。

cluesmith/codev2902026年10月24日 更新

查看 cluesmith 的全部技能

报告此技能的问题