AISpec：AI编码助手标准化规范体系，让团队代码质量一致可控

覆盖15个技术域、68个Skill、22个专业Agent的AI工程规范系统，支持Cursor、Codex、Claude Code、Gemini ADK多平台

Cursor、OpenAI Codex、Claude Code、Gemini等AI编码助手正在重塑软件开发流程。它们能够自动生成代码、重构项目、解释复杂逻辑，甚至协助调试和测试。然而，这种强大的能力也带来了新的问题：

风格不一致：同一个团队的不同成员使用AI助手时，可能得到风格迥异的代码输出。有人得到的是函数式编程风格，有人得到的是面向对象风格；有人遵循严格的类型约束，有人则大量使用any类型。

最佳实践遗漏：AI模型训练数据的时间截点和来源各异，导致它们推荐的技术栈和模式可能过时或不适合当前项目。例如，可能推荐已废弃的API，或者忽略团队已约定的安全规范。

架构漂移：在大型项目中，缺乏统一约束的AI生成代码可能导致架构逐渐偏离最初设计，技术债务累积。

协作摩擦：当AI生成的代码需要人工审查时，审查者需要花费大量时间指出"AI应该知道"的规范问题，而不是关注业务逻辑本身。

这些问题的本质是：AI编码助手缺乏对特定团队工程规范的理解和约束机制。

---

AISpec项目提出了一套完整的解决方案：将工程规范编码为结构化的规则体系，让AI助手在执行任务时始终遵循团队约定的标准。

AISpec采用清晰的分层架构，确保规则的单一来源和灵活的能力组合：

规则层（Rules Layer）

这是整个体系的"唯一真源"，包含15个技术域的详细规范：

• 服务端：Go、.NET、Python、Java、Node.js
• 前端：Vue3、React、uni-app（Admin/H5/小程序）
• 桌面端：.NET WPF/MAUI、Tauri（Rust）、Electron
• 移动端：Android（Kotlin/Compose）、iOS（Swift/SwiftUI）、Flutter、React Native
• 数据库：Schema初始化与迁移规范
• 横切关注点：安全基线、环境管理、可观测性（监控/日志/追踪）、API版本管理、版本发布（SemVer/Changelog）、测试（E2E+性能）、国际化、错误码体系

每个技术域的规则都详细定义了编码约定、项目结构、依赖管理、性能要求和常见陷阱规避。

能力层（Skills Layer）

Skills是AI助手的执行入口，负责加载规则并引导任务完成。AISpec定义了68个Skill，分为两类：

域特定Skill（59个）：每个技术域包含4类核心Skill

• *-coding-guide：根据场景加载规则，引导AI编写规范代码
• *-code-reviewer：对代码变更进行规范性审查
• *-project-scaffold：生成符合规范的项目初始结构
• *-rules-maintainer：校验和维护规则文件一致性

横切Skill（9个）：

• task-router：任务域路由器，识别任务涉及的技术域
• task-planner：任务拆解，将复杂任务拆分为可执行步骤
• product-prd-writer：PRD撰写引导
• spec-generator：技术规格说明书生成
• ui-ux-designer：UI/UX设计引导
• design-reviewer：设计走查与规范检查
• security-auditor：威胁建模与安全检查
• qa-test-strategist：测试规划与用例设计
• devops-engineer：CI/CD与部署策略

编排层（Agents Layer）

针对复杂的多域协作场景，AISpec提供22个专业Agent，支持多Agent协作编排：

• Coordinator：任务协调器，负责任务分配和进度跟踪
• Product：竞品分析、需求定义、PRD、路线图
• Spec：技术规格说明书（五阶段引导）
• Design：交互设计、视觉设计、设计系统
• 15个技术域Agent：各自负责特定技术域的实现
• Security：威胁建模、OWASP检查、依赖扫描
• QA：测试策略、测试用例、验收测试
• DevOps：CI/CD、基础设施、监控告警

---

AISpec的最大优势之一是对主流AI编码助手平台的原生支持：

Cursor从v2.4版本开始原生支持SKILL.md规范。AISpec针对Cursor提供：

• 单体模式：无需任何配置，Cursor自动发现skills/目录下的Skill文件
• 多Agent模式：在对话中直接触发，或创建.cursor/rules/agent-mode.md规则文件实现自动加载

使用示例：

请使用多Agent模式。参考 agents/index.md 和 agents/protocols/coordination.md。
任务：新增用户管理功能（数据库 + API + 前端页面）。

Codex使用.toml文件定义Agent。AISpec提供22个预配置的.toml文件，涵盖Coordinator和所有域Agent：

mkdir -p .codex/agents
cp aispec/agents/adapters/codex/*.toml .codex/agents/

Claude Code通过CLAUDE.md文件集成规范体系。只需在项目根目录的CLAUDE.md中引用AISpec的规则体系和多Agent调度协议即可启用。