@agile-team/wl-skills-kit

适合什么项目

面向已接入 Kit 的 PC Vue 3 / Web 管理端，支持新页面开发、存量整改和领域模板复用。移动 H5、UniApp、小程序、App / PDA 不套用 PC 规则；父工作区安装不会自动启用子项目。

AI Skill 模板包 v2.33.1：14 条编码规范、13 个 AI Skill、34 个 MCP Tool，配套 CLI、编辑器入口与项目内文档。

快速开始

在实际业务项目根目录操作，沿用项目包管理器。以下以 pnpm 为例。

1. 安装本地工具并初始化

pnpm add -D -E @agile-team/wl-skills-kit@latest
pnpm exec wl-skills init

生成 .wl-skills/ 规范与 Skill、.agents/skills/wl-skills-kit/SKILL.md 发现入口、编辑器与 MCP 配置。已有项目内容按受管归属保护；冲突先审阅，不用 --force 覆盖未知内容。

2. 检查接入并完成首扫

pnpm exec wl-skills check
pnpm exec wl-skills validate --typecheck

check 看安装、工具链、MCP 与 Hook 配置；validate 看实际页面问题。类型检查需要项目已安装并配置 vue-tsc 或 tsc。

3. 让编辑器按任务使用

刷新编辑器的 Skill / MCP 配置后，给出任务与目标，例如：

审计 src/views/produce/order，先列出问题和修复范围；
确认后修复，再做页面与类型校验，反馈剩余问题。

看到实际任务回执中的包版本、选定规则、目标、runId，以及最终真实检查结果，才算本次能力被使用。安装或 AI 口头说明不能证明执行。

团队质量接入： 已用 Gate 管理的项目，直接走 Gate 统一接入，避免重复组装 Hook。Kit 独立初始化只在已有 Git 与 .husky 时追加提交 / 推送检查；还需验证 Hook 已激活。本地缺包会跳过该独立 Hook，服务端强制门禁由 Gate / CI 接线落实。

一次任务怎么完成

以 wl-ui-produce 订单列表增加查询条件为例：

编辑器可调用 CLI 或 MCP 完成这条流程。排查集成时可直接核对：

pnpm exec wl-skills task "修改订单列表页面查询条件" \
  --target src/views/produce/order --json
# 按返回的 Skill / 规则完成修改，复用本次返回的 runId
pnpm exec wl-skills validate src/views/produce/order \
  --typecheck --run-id <runId>
pnpm exec wl-skills status --run-id <runId> --json

task 只生成计划；validate 才实际检查，status 汇总证据和过期状态。没有运行、范围未覆盖、宿主读取未验证的内容会明确保留，不当作检查通过。

常用操作

上表省略 pnpm exec。机械修复只覆盖已实现的明确规则，不替代业务判断；适用表格技术以项目声明为准。部分生成模板使用 UI runtime 或项目 renderer，生成前核对其宿主依赖。

按需深入

后端写入与外部报告推送须核对具体计划并确认；生产写入默认阻断。项目连接凭据放在被忽略的 .wl-skills/skills/sync/env.local.json，不提交仓库。

WL 系列

WL = World Leading。 Kit 可独立使用，按项目需要组合其他包。

UNLICENSED，使用须经授权。问题反馈请附包版本、Node 版本、目标编辑器、执行命令和最小复现，提交至 Issues。