code-kitlisted
Install: claude install-skill raystyle/project-evo
# code-kit - evo-adr 骨架与门禁工具箱
**工具型 skill**:`scripts/` 五脚本(init/check/scan/md-guard/mdrules)是交付物,本文件是它们的用法面与意图路由;骨架模板在 `assets/templates/`,骨架规范检查用例在 `verification/`。文档体系知识(合同/ADR/REQ/投影/六态)在同插件 `doc-gov`。
## 一、意图路由
| 你要做的事 | 入口 |
| --- | --- |
| 新项目初始化骨架 / 旧项目迁移到本体系 | `references/base-init.md` |
| 装骨架(命令) | 本文件「二、init」 |
| 验证某项目是否符合骨架 / PE-01 至 PE-12 判定语义 | `verification/command-test-cases.md` |
| 写测试 / 定测试分层与门禁(单元/集成/冒烟/回归/验收) | `references/flow-testing.md` |
| 定平台矩阵 / shell 行尾 / CI 三系统 / 换机接管 | `references/env-platform.md` |
| 建项目脚本工具(.tools / uv / PEP 723) | `references/tool-project.md` |
| 建 Rust 项目 / cargo 工作区 / missing_docs / doctest / aidoc | `references/tool-rust.md` |
| 建 TypeScript/Node 项目 / TSDoc / API Extractor / TypeDoc / Vitest | `references/tool-typescript.md` |
| 建 Python 项目 / docstring / MkDocs 投影 / PEP 723 脚本 | `references/tool-python.md` |
| 给 CLI 加 agent 用户面(agent-native 契约、管道逃生舱、脚本 workspace) | `references/tool-cli-agents.md` |
| 写 AGENTS 合同 / 立 ADR 或 REQ / 投影纪律 / 六态 | 同插件 skill `evo-adr:doc-gov` |
## 二、脚本用法(本节命令均实证可跑)
三脚本统一形态:PEP 723 零依赖(>=3.12),`uv run` 或系统 python 直跑;路径以本 skill 目录为根。
### init:安装文档骨架
```bash
uv run <skill>/scripts/init.py <目标项目> --name <项目名>
```
幂等:已有文件一律跳过不覆盖;装完按输出提示补 AGENTS 定位段与 GOAL 起点。骨架结构见 `references/base-init.md`。
### check:诊断骨架合规(PE-01 至 PE-12)
```bash
uv run <skill>/scripts/check.py <目标项目> # 人读逐项表
uv run <skill>/scripts/check.py <目标项目> --json # 机器读面(ok/counts/results)
```
只读;退出码 0 全过(含 SKIP)/ 1 有 FAIL / 2 出