AI时代后台管理系统Harness工程实践
来源：互联网 2026-07-19 08:20:31针对AI代码生成不够理解项目的问题，V3AdminVite开源项目在已有Rules基础上新增项目级约定（AGENTS.md与CLAUDE.md）及按需加载的Skills，涵盖命令、架构、约定三大模块及高频场景如增删改查。通过软链接机制支持多工具，有效提升AI输出的可靠性与准确性。
铺垫了一个季度，终于可以深入探讨 AI 时代 Harness 工程在后台管理系统中的具体实践。本次主题聚焦于如何让 AI Agent 更懂项目，输出更可靠的代码。
先交代背景：当前 AI Coding 的覆盖率已接近 100%，但问题随之而来——AI 在面向特定项目编码时，输出结果往往不够理想，根源在于它不够“懂”项目。为解决这一问题，V3 Admin Vite 开源项目在已有 Rules 基础上，新增了项目级约定与 Skills，目标明确：让 AI 输出更稳定、更可靠。
长期稳定更新的攒劲资源： >>>点此立即查看<<<
背景
程序员群体的 AI Coding 覆盖率已接近 100%。尽管 AI 能力持续增强，但在针对特定项目编码时，仍容易出现输出代码不理想的情况。
为减少此类问题，V3 Admin Vite 在已有 Rules 基础上，新增了项目级约定和 Skills，以确保更可靠的 AI 输出。
目标
完成项目级约定与 Skills 的内置，让 AI Agent 更深入理解项目，输出符合预期的代码。
前置知识
动工之前，有必要先厘清三个概念：CLAUDE.md、Rules 和 Skills。它们的作用范围、加载方式及适用场景差异明显，下表可直观对比：
| 方面 | CLAUDE.md | Rules | Skill |
|---|---|---|---|
| 加载 | 每次会话 | 每次会话，或打开匹配文件时 | 按需，被调用或相关时 |
| 范围 | 整个项目 | 可限定在文件路径范围内 | 特定任务 |
| 最适合 | 核心约定和构建命令 | 特定语言或目录的指南 | 参考材料、可重复的工作流 |
| 何时使用 | 项目约定、“始终执行 X” 规则 | / | 可重用内容、参考文档、可重复的任务 |
| 示例 | 使用 pnpm 而非 npm；提交前运行测试。 | / | /deploy 运行部署检查清单；熟悉 API 文档和端点模式 |
总结
- 对于每个会话需要的说明，使用 CLAUDE.md： 构建命令、测试约定、项目架构
- 使用 Rules 保持 CLAUDE.md 专注： 带有 paths frontmatter 的 Rules 仅在 Claude 处理匹配文件时加载，节省上下文
- 对于 Claude 有时只需的内容，使用 Skills： 如 API 文档或通过
/触发的部署清单 - CLAUDE.md + Skills 组合： CLAUDE.md 保存始终开启的规则，Skills 保存按需加载的参考材料。例如 CLAUDE.md 中写“遵循我们的 API 约定”，Skill 则包含完整的 API 风格指南
通俗理解
- CLAUDE.md： 每次都生效的通用约定
- Rules： 每次但局部生效的规则
- Skills： 按需且局部场景固定的执行步骤
本期实现
新增项目级约定
为让 AI 真正理解项目架构并遵守约定，我们在根目录新增了 AGENTS.md 和 CLAUDE.md 两个配置文件。内容涵盖三大模块：命令、架构、约定，总行数控制在 200 行以内。实践表明，在开源项目 andrej-karpathy-skills 基础上完善这三个模块效果显著——该项目通过简单的四条原则，即可有效约束 AI 输出，避免常见陷阱。
需要特别说明：CLAUDE.md 主要作用于 Claude Code 工具，而 AGENTS.md 面向 Cursor、Antigra vity、Trae、CodeX 等更广泛的工具。因此，我们优先输出更通用的 AGENTS.md 文件，再通过关联机制让 CLAUDE.md 共享同一内容，避免重复劳动。
新增项目 Skills
编写 Skill 时，使用官方提供的 skill-creator 工具可大幅提升效率，远优于从零开始。若想深入学习如何写好 Skill，可查阅相关文档。
实践中，我们将编写好的 Skill 存放于通用目录 .agents/skills/，再通过软链接命令 ln -s 与 .claude/skills/ 关联，同样避免了重复维护两份文件。
针对 V3 Admin Vite，首期新增了以下项目 Skill（每个 Skill 内容严格控制在 500 行以内）：
v3-create-crud：创建增删改查页面v3-upsert-store：创建或更新全局状态v3-upsert-route：创建或更新路由表v3-use-utils：内置工具使用教程v3-use-composables：内置组合式函数使用教程
将这些后台管理系统中高频出现的需求抽象为 Skill 后，AI Agent 能更准确地理解需求并产出代码，效果立竿见影。
安装社区 Skills
除项目自建 Skill 外，我们还引入了社区中对 Vue 项目友好的第三方 Skill，包括但不限于：
piniapnpmunocssvitevitestvuevue-best-practicesvue-router-best-practicesvue-testing-best-practices
这些 Skill 主要来自 antfu/skills 仓库，以 skills-lock.json 文件形式记录，默认不包含在项目中。如有需要，可运行 npx skills experimental_install 命令安装到本地，安装后会在 .agents/skills/ 目录下出现。
实践总结
至此，阶段性实现了标题所述的 AI 时代 Harness 工程在后台管理系统中的实践。
基于这套方案并配合软链接方式，目前已支持 Claude Code、CodeX、Cursor、Trae、Antigra vity 等主流 AI Coding 工具。当然，AI Agent 发展迅速，未来必将涌现更多不同的实践方案，值得持续关注。
侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述
同类更新
更多
热游推荐
更多-
- DreamStudio
- Android/ | AI绘图
- 2026-06-30
-
-
- Playground AI
- Android/ | AI绘图
- 2026-06-30
-
- Adobe Firefly
- Android/ | AI绘图
- 2026-06-30
-
-
-
- Leonardo AI
- Android/ | AI绘图
- 2026-06-30
-
- Stable Diffusion
- Android/ | AI绘图
- 2026-06-30
