smart_test 面向企业级后端项目：根据实际语言、运行时、架构、业务风险和已有设施选择测试方案，评估测试缺口、补测试、执行诊断并生成 CI 候选。
当前专项实现覆盖 Java 8+、Spring Boot 2/3、Maven/Gradle。其他语言支持按实际项目逐步扩展。数据库、中间件测试使用隔离环境，结果列明未执行范围。
采用 Agent Skills 目录格式，兼容该格式的 Agent 可安装同一份 skills/smart-test。Codex 和 Claude Code 是已提供的安装示例，核心流程不依赖它们的专属能力。
许可证：Apache License 2.0，随独立 skill 包分发。
通过宿主安装，无需克隆仓库或运行 Python 脚本。
在 Codex 对话中发送：
$skill-installer 请安装 https://github.com/eryihan/smart_test/tree/main/skills/smart-test
Codex 内置的 skill-installer 会从 GitHub 下载并安装 skills/smart-test。安装完成后，开启新会话，或等待当前会话刷新技能列表。
在 Claude Code 会话中执行：
/plugin marketplace add eryihan/smart_test
/plugin install smart-test@smart-test
也可以在终端执行：
claude plugin marketplace add eryihan/smart_test
claude plugin install smart-test@smart-test默认安装范围是当前用户。只在当前项目启用时，在项目目录执行：
claude plugin install smart-test@smart-test --scope project安装完成后重启会话，或执行 /reload-plugins。Claude Code 中的调用名带插件命名空间：
/smart-test:smart-test init
插件提供 /smart-test:help|init|scan|changes|check|pipeline|update，也兼容 /smart-test:smart-test <模式>。
本仓库提供第三方 Claude Code 插件市场。
按宿主的 skill 安装功能，从 https://github.com/eryihan/smart_test/tree/main/skills/smart-test 安装完整目录，或将离线包中的 smart-test/ 放入宿主指定的 skills 目录。不自行猜测安装路径；其他 Agent 不需要 Claude 插件清单或 Codex 界面配置。
维护源码或离线安装时，可显式指定目录，不必指定宿主品牌：
python3 tools/install_skill.py --dest <Agent的skills目录>按宿主方式调用和刷新，确认已加载的 SKILL.md 路径与版本。实施和验证需具备相应文件、命令与环境权限。
在 Codex 中发送：
列出当前可用的 smart-test skill，并确认它来自 eryihan/smart_test。
如果 skill 已加载，Codex 可以识别 $smart-test 并执行后续工作模式。
在终端执行：
claude plugin list
claude plugin details smart-test确认插件状态为 enabled，组件列表中包含一个名为 smart-test 的 skill。
在目标后端仓库中启动宿主，直接描述任务。补当前改动或运行已有测试不要求先 init；当前完整专项指导为 Java。调用示例：
Codex: $smart-test changes
Claude Code: /smart-test:changes
也可直接指定范围与规则，例如“只补 order 模块的金额边界测试；拒绝后不能写订单或扣额度”。skill 会先检查已有测试，选择能验证该行为的边界，再补强或新增测试并运行。
只分析时明确说“不修改、不执行”，或使用 changes --dry-run。搭建测试设施用 init，找存量缺口用 scan，运行已有测试用 check，生成 CI 候选用 pipeline。
完整调用方式、控制项、覆盖率、结果解释和典型请求统一见 使用指南。安装后可直接请求帮助：
Codex: $smart-test help
Claude Code: /smart-test:help
保存实际运行证据；计划、长期约定和账本按复用、恢复或审计需要保存。Unit 与数据库集成分别报告结果。
快捷更新可直接对 Agent 说“更新 smart-test”，或使用：
Codex: $smart-test update
Claude 插件: /smart-test:update
其他 Agent: 按宿主方式调用 smart-test update
更新沿用原安装来源和范围，检查本地定制，保留备份并核对新版本；不修改目标项目的业务代码、测试配置或 .smart-test/。完整规则与离线/失败处理集中在 更新说明。旧版尚无 update 入口时，先用原安装渠道升级一次。
claude plugin marketplace update smart-test
claude plugin update smart-test@smart-test更新后重新加载插件或开启新会话。卸载：
claude plugin uninstall smart-test@smart-test项目级操作增加 --scope project。
在 Codex 中发送：
$smart-test update
独立安装的卸载按宿主规则移除 smart-test 目录。卸载不会删除目标业务仓库中的测试代码和 .smart-test/。
Claude 的第三方市场默认不自动更新；需要时可在 /plugin 的 Marketplaces 页开启该市场的自动更新。自动更新后的当前会话仍需按提示重新加载。Claude 更新机制
在当前对话中请求导出脱敏反馈，并指定目标项目外的新目录；导出不自动上传。用户操作见 使用指南，维护者收集、定位和回归见 反馈处理。
开发架构 说明 Agent、辅助工具和目标项目的职责及扩展边界；开发与分发 说明验证、离线安装和打包。二者随代码维护，不进入独立 skill 安装包。历史验证结果仅对应其记录的版本。
安装机制参考 Claude Code 插件安装、Claude Code 插件市场 和 OpenAI 官方 skill-installer。