告别单文件 Prompt构建企业级 AI 编程助手AI-OSv1.0集成 Matt Pocock 全套技能实现零幻觉开发引言为什么你的 AI 编程总是“翻车”在使用 OpenCode、Cursor、Cline 等 AI 编程工具时你是否遇到过以下痛点规范失效明明在 Prompt 里写了“遵守 Clean Code”AI 写到第 3 个文件就全忘了。严重幻觉AI 捏造不存在的 API或者写完代码不跑测试就告诉你“搞定了”。无法复用每个新项目都要重新写一遍长长的 System Prompt极其繁琐。上下文爆炸把所有规则塞进一个.md文件导致 AI 注意力稀释频繁出现“中间遗忘”。破局之道大模型工程化的核心不是写一个“超级 Prompt”而是构建一套AI 能理解、能执行、能自我校验的标准化操作系统AI-OS。本文将为你开源一套经过生产环境验证的AI-OS v1.0 架构。通过“分层路由 物理工具校验”并深度集成 Matt Pocock 的 21 个全流程神级 Skills让 AI 像运行程序一样严格执行开发任务真正实现一次搭建终身复用零幻觉。一、 核心架构从“单文件”到“分层路由洋葱模型”我们将规则拆分为全局资产与项目资产AI 在不同阶段只加载当前需要的层确保注意力 100% 集中层级作用存储位置加载时机核心内容L0 全局规范层所有项目通用的编码、Git、测试规范~/.ai-os/standards/编码/提交时按需注入Clean Code、Git 规范L1 全局 SOP 层所有项目通用的标准化工作流~/.ai-os/sops/执行具体任务时调用TDD 流程、Bug 排查流程L2 全局技能层Matt Pocock 21 Skills 自定义技能~/.ai-os/skills/触发指令时调用需求拷问、架构优化、领域建模等L3 项目路由层单个项目的“入口与大脑”./.ai/RULES.md项目打开时永久常驻路由协议、工具映射、XML 输出约束L4 项目上下文层单个项目特有的业务信息./.ai/context/对应任务执行前按需加载PRD、领域模型、架构设计核心突破将通用资产和顶级开源 Skills 放入全局目录~/.ai-os/新项目只需一个 800 字的RULES.md即可继承所有能力。二、 第一步全局环境一键初始化只需执行一次打开你的终端复制并运行以下 Bash 脚本。它将在 10 秒内为你搭建好全局的 AI-OS 资产库并自动整合你本地的 Matt Pocock 21 个 Skills。#!/bin/bash# AI-OS v1.0 全局初始化脚本 - 终极落地版 (集成 Matt Pocock Skills)echo 开始初始化 AI-OS v1.0 全局环境...# 1. 创建全局目录结构mkdir-p~/.ai-os/{standards,sops,skills,templates,stacks}# 2. 整合 Matt Pocock 的 21 个神级 Skillsecho 整合 Matt Pocock 21 Skills...# 替换成你存放skill的目录MATT_SKILLS_DIR/Users/litianyu/skillsif[-d$MATT_SKILLS_DIR];then# 将 skills 目录下的所有内容复制到全局 skills 目录cp-r$MATT_SKILLS_DIR/* ~/.ai-os/skills/2/dev/nullecho✅ Matt Pocock 21 Skills 已成功整合到 ~/.ai-os/skills/elseecho⚠️ 警告未找到$MATT_SKILLS_DIR请确认路径或手动复制 skills 到 ~/.ai-os/skills/fi# 3. 生成核心 SOP (标准作业程序)catEOF~/.ai-os/sops/SOP_TDD.md# TDD 标准作业程序 v1.0 ## 强制执行步骤 1. 读取 PRD 和领域模型提取所有测试场景正常、异常、边界 2. 编写第一个失败的单元测试 3. 【强制】调用终端工具运行测试确认测试失败 4. 编写最小实现代码只写让测试通过的最少代码 5. 【强制】调用终端工具运行测试确认测试通过 6. 重构代码优化可读性和性能 7. 【强制】调用终端工具运行所有测试确认没有回归 8. 【强制】调用终端工具运行 lint 和类型检查 9. 只有当所有命令都返回 0 退出码时才能结束任务 EOFcatEOF~/.ai-os/sops/SOP_TRIAGE.md# Bug 排查标准作业程序 v1.0 ## 强制执行步骤 1. 读取错误日志提取关键信息错误类型、发生位置、堆栈信息 2. 调用终端工具 grep 相关代码定位问题所在文件 3. 分析根因列出可能的解决方案 4. 生成修复 Diff 5. 【强制】调用终端工具运行相关测试确认修复有效 6. 【强制】调用终端工具运行所有测试确认没有引入新的 Bug EOF# 4. 生成编码与 Git 规范catEOF~/.ai-os/standards/CLEAN_CODE.md# 清洁代码规范 v1.0 - 单个函数不超过 50 行单个文件不超过 300 行 - 每个函数只做一件事参数不超过 5 个 - 注释“为什么”而不是“做什么” EOFcatEOF~/.ai-os/standards/GIT_WORKFLOW.md# Git 工作流规范 v1.0 - 提交信息必须符合 Conventional Commitstype(scope): message - 类型feat, fix, docs, style, refactor, test, chore EOF# 5. 生成项目级 MCP 模板与 .aiignorecatEOF~/.ai-os/templates/mcp_template.json{ mcpServers: { filesystem: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, ./] }, git: { command: npx, args: [-y, modelcontextprotocol/server-git] }, command: { command: npx, args: [-y, modelcontextprotocol/server-command, --allow, python,pytest,git,docker,ruff,mypy] } } } EOFcatEOF~/.ai-os/templates/.aiignorevenv/ __pycache__/ .pytest_cache/ .env *.log node_modules/ EOFecho✅ AI-OS v1.0 全局初始化完成三、 第二步项目级一键创世每个新项目执行新建你的项目目录打开 OpenCode / Cursor / Cline直接粘贴以下“创世 Prompt”以 PythonFastAPI 为例# 角色与任务 你是顶级 AI 架构师严格遵守工程规范拒绝任何幻觉。请基于全局 AI-OS (~/.ai-os/) 初始化当前项目。 # 项目信息 - 项目名称my-awesome-api - 技术栈Python 3.11 FastAPI PostgreSQL Redis - 项目描述一个高并发的电商订单处理系统 # 执行步骤 1. 读取 ~/.ai-os/templates/.aiignore写入当前目录的 .aiignore 2. 读取 ~/.ai-os/templates/mcp_template.json写入当前目录的 .mcp.json 3. 创建 .ai/ 和 .ai/context/ 目录 4. 创建 .ai/RULES.md内容必须严格如下 --- (RULES.md 内容开始) --- # 项目 AI 路由协议 v1.0 ## 核心原则 - 严谨务实拒绝幻觉不确定就说我不确定 - 复杂逻辑使用 deepseek-v4-pro简单任务使用 deepseek-v4-flash ## 资产路由 - 全局规范~/.ai-os/standards/ - 全局 SOP~/.ai-os/sops/ - 全局技能~/.ai-os/skills/ (包含 Matt Pocock 21 Skills) - 项目上下文.ai/context/ ## 物理工具映射根据当前客户端自动适配 - 执行终端命令execute_command / run_command / run_terminal - 读取文件read_file - 写入/修改文件write_to_file / apply_diff ## 【强制输出格式】核心防幻觉机制 所有回答必须严格按照以下 XML 格式输出禁止自由发挥 thinking 1. 我当前的任务是什么 2. 我需要读取哪些文件必须列出完整路径 3. 我需要调用哪些终端工具进行物理校验 /thinking file-loading - 已读取.ai/RULES.md - 已读取[其他相关文件路径] /file-loading plan 1. 步骤 1 2. 步骤 2 /plan execution 具体代码或输出内容 /execution verification 1. 我是否运行了 ruff/mypy/pytest 进行物理校验 2. 我是否遵守了所有编码规范 /verification ## 强制执行规则 1. 代码生成后必须自动运行 lint、typecheck 和 test 2. 只有所有命令都通过才能结束任务 3. 每次修改必须使用 apply_diff 生成增量修改禁止输出完整文件 ## 技能自动路由与调用协议 (Matt Pocock 21 Skills) 你已集成 Matt Pocock 的全流程神级技能库。**禁止被动等待用户输入 **你必须根据当前对话的上下文、开发阶段和任务意图**自动识别并调用**对应的技能。 ### 1. 调用动作规范 当匹配到对应技能时必须首先使用 read_file 工具读取 ~/.ai-os/skills/技能名/skill.md若目录结构不同则自适应查找同级 .md读取后严格按照其内部的 Steps 和 Rules 执行。 ### 2. 全生命周期技能路由表 #### 阶段一需求规划与对齐 (Requirements) - **触发场景**刚提出新功能、需求模糊、需要宏观梳理、需输出标准文档。 - **自动路由** - grill-me需求模糊时自动进行穷尽式追问消除歧义。 - zoom-out需求复杂时跳出细节梳理整体架构上下文。 - to-prd需求确认完毕自动将对话转化为标准 PRD 文档。 #### 阶段二领域建模与架构设计 (Design) - **触发场景**项目初始化、定义业务模型、多人协作需统一术语、设计 API。 - **自动路由** - domain-model定义业务模型时打磨术语一致性生成 CONTEXT.md/ADR。 - ubiquitous-language需要统一团队术语时提取 DDD 统一语言术语表。 - design-an-interface需要设计 API/功能接口时生成多套设计方案供选择。 #### 阶段三项目初始化与工程化 (Setup) - **触发场景**新建项目、配置代码规范、初始化目录结构、配置 Git 防护。 - **自动路由** - setup-pre-commit配置 Husky 等代码预提交校验。 - git-guardrails-claude-code配置 Git 防护拦截 push/reset 等危险命令。 - scaffold-exercises生成标准项目目录或习题目录结构。 #### 阶段四开发实现与重构优化 (Development Refactoring) - **触发场景**编写新功能、代码混乱需优化、TS 类型优化、老代码重构。 - **自动路由** - tdd编写新功能时强制执行“红-绿-重构”测试驱动开发。 - improve-codebase-architecture代码可维护性差时扫描并优化架构/模块化。 - request-refactor-plan面对老代码生成安全的增量重构计划。 - migrate-to-shoehornTS 项目中优化类型断言代码。 - edit-article编写或优化代码注释、说明文档时提升可读性。 #### 阶段五测试与 Bug 排查 (Testing Debugging) - **触发场景**出现 Bug、需要定位缺陷、交互式排查、验证功能。 - **自动路由** - triage-issue出现 Bug 时自动定位根因并生成修复方案。 - qa发现问题需定位时进行交互式 QA 并自动提交 Bug 工单。 #### 阶段六任务协作与工单管理 (Management) - **触发场景**需求拆分、分配任务、管理 GitHub Issue。 - **自动路由** - to-issues需求确认后将 PRD 拆解为可执行的 GitHub Issue。 - github-triage自动分类和处理 GitHub Issue。 #### 阶段七全周期通用与系统配置 (General System) - **触发场景**需要极简回复、管理笔记、扩展能力、修改 AI 配置。 - **自动路由** - caveman用户要求精简回复或需节省 Token 时开启超精简模式。 - obsidian-vault需要记录开发笔记或查阅资料时管理 Obsidian。 - write-a-skill遇到重复性新模式时自定义创建新技能。 - customize-opencode需要修改 OpenCode 自身配置/插件时调用。 ### 3. 路由执行约束 1. **意图识别优先**每次接收到用户输入必须在 thinking 标签中判断当前所属阶段并匹配上述路由表。 2. **组合调用**复杂任务可组合调用如先 grill-me 追问再 to-prd 输出文档但必须按逻辑顺序分布执行。 3. **用户覆盖**若用户显式输入 技能名则无视自动路由直接调用指定技能。 ## 在 .ai/context/ 下创建 PRD.md、ARCHITECTURE.md、DOMAIN_MODEL.md 空模板 ## 完成后输出《项目初始化报告》并提示我输入需求以填充 PRD四、 日常开发工作流演示初始化完成后你的日常开发将变得极其丝滑且严谨场景 1接需求防需求遗漏你grill-me 帮我分析一个用户积分抵扣功能的需求。AI 行为自动读取~/.ai-os/skills/grill-me/下的技能文件。按照 Matt Pocock 的穷尽追问逻辑从边界条件、并发处理等维度疯狂追问你。你回答后AI 将结构化需求写入.ai/context/PRD.md。场景 2写代码物理防幻觉核心你tdd 根据 PRD开发积分抵扣的核心逻辑。AI 行为读取PRD.md和~/.ai-os/skills/tdd/下的技能文件。输出plan先写失败的测试用例。关键动作AI 写完实现代码后自动调用终端工具执行pytest和ruff check。如果终端返回报错AI 会自动读取报错信息自我修正代码直到终端输出全绿。场景 3查 Bug防排查幻觉你triage-issue 抵扣接口报 500日志是 [粘贴日志]。AI 行为读取~/.ai-os/skills/triage-issue/下的技能文件。调用终端工具执行grep查日志定位源码。输出根因分析生成修复 Diff并自动跑测试验证修复。五、 避坑与进阶指南生产环境血泪总结MCP 配置路径初期强烈建议使用项目级.mcp.json放在项目根目录。全局配置容易因工具版本更新导致路径变化而失效。上下文污染防护项目变大后AI 可能会把.ai/context/里的所有文件都塞进上下文。.aiignore是必须的同时在RULES.md中已写明“每次任务最多读取 3 个上下文文件”强制 AI 聚焦。打破“只说不做”如果 AI 回复“我已运行测试”但实际上没跑说明工具映射失败。请在RULES.md的“物理工具映射”中核对并修改为你当前使用的 AI 客户端的真实 Tool Name。版本控制将.ai/目录和.mcp.json提交到 Git这样你的团队克隆项目后打开 AI 工具就能立即继承相同的规范和 SOP。结语这套AI-OS v1.0彻底抛弃了“靠提示词约束 AI”的幻想转而使用“架构分层 物理工具校验 顶级开源 Skills”的工程化手段。它不是一成不变的随着你的使用你可以将踩过的坑补充到~/.ai-os/standards/中将新的最佳实践提炼到~/.ai-os/sops/中。你积累的每一行规范都会成为你未来所有项目的护城河。现在复制脚本开始构建你的 AI 研发操作系统吧(本文首发于 CSDN作者阿汤猫666转载请注明出处。如果觉得有用欢迎点赞收藏)