人工智能辅助的代码质量管控系统
这个仓库实现了AIUOKEEP参考架构：一种确定性的（架构）， 一个基于策略的护栏平台，用于协调通过（某种机制或系统）生成的AI代码变更 MCP工装、SafePatch验证及审计管理。
目录
概述
该系统使自主代理和开发者能够安全地协作 结合：
- 模型上下文协议（MCP）服务器 暴露语言特有质量（或：体现语言特有品质）
模具工具和共享服务。
- SafePatch验证流程 这个（工具）负责格式化、代码检查、类型检查，
测试、静态应用安全测试（SAST）、策略和密钥门禁。
- 政策和架构护栏（或：政策和架构规范） 那些强制执行确定性变更计划的
阻止不允许的操作。
- 审计与可观测性 具有为每个（事件/数据）捕获不可篡改记录的功能
验证运行。
建筑学
详细的组件分解、数据流以及操作方面的考虑因素包括： 提供/有售于 docs/ARCHITECTURE.md.
关键要素：
- MCP 工具平面： 通过（某种方式）配置
/.mcp/脚本和/mcp-servers/运行时
实现（方案/版本）。
- 护栏： 在以下定义的JSON模式、OPA策略和Semgrep规则包
/policy/ 和 /.semgrep/。
- SafePatch 管道： 验证协调脚本位于
scripts/validation/Invoke-SafePatchValidation.ps1 通过CI（持续集成）实现对称性/平衡性 /.github/workflows/.
- 审计层： 账本模式在
/schemas/ledger.schema.json以及 PowerShell
以下公用设施 /scripts/audit/。
入门指南/开始使用
- 安装依赖项
- PowerShell 7.4及以上版本 - Python 3.12+ - Node.js（用于TypeScript工具）
- 克隆仓库 并审查配置文件中的内容
/.mcp/。 - 初始化MCP环境 通过
./.mcp/Initialize-McpEnvironment.ps1并且
使用（某种方法/工具）进行验证 ./.mcp/Test-McpEnvironment.ps1.
- 进行本地验证 和；与；带着
./tools/Verify.ps1在提交更改之前。 - 审查护栏（或：检查界限/限制） 在
docs/GUARDRAILS.md以理解强制执行的政策。
操作工作流程
- 开发者/代理商 作者：更改计划，应用确定性补丁，并运行
在创建拉取请求（PRs）之前，先在本地进行SafePatch处理。
- CI/CD（持续集成/持续交付） 在（某个环境中）执行工作流
/.github/workflows/以反映当地检查情况，并且
发布账目条目。
- 治理团队 显示器
/scripts/audit/Export-WeeklyReport.ps1输出至
检测漂移或重复发生的故障。
仓库布局
.mcp/— MCP服务器的期望状态配置和自动化脚本。mcp-servers/— MCP服务器实现（PowerShell、Python、SAST、密钥管理、，
（政策）。
policy/— JSON模式、OPA策略和Semgrep配置。tools/— 本地开发工具，包括编辑引擎实用程序和
验证协调器。
scripts/— 验证、审计、沙盒和挂钩脚本。docs/— 建筑、护栏、MCP（可能是指某种系统或模块的缩写，具体需根据上下文确定，此处保留原样）集成、验证流水线、代理
指南和故障排除参考资料。
tests/— 支持SafePatch强制执行的测试用例和测试套件。
文档
更多指导信息可在以下途径获取：
docs/MCP_INTEGRATION.md配置并操作MCP（多控制器平台/系统，具体含义根据上下文确定）
服务器。
SafePatch阶段。
docs/AGENT_GUIDELINES.md行为准则/行为规范对于
（特指）代理商。
docs/TROUBLESHOOTING.md常见问题及解决方案。docs/GUARDRAILS.md护栏分类及其扩展。
贡献
看见 CONTRIBUTING.md 对于分支策略和代码审查 要求，以及验证期望。所有贡献必须通过SafePatch的验证 进行验证，并包含相关的文档更新。