# ai-standardization-kit **Repository Path**: Zherphy/ai-standardization-kit ## Basic Information - **Project Name**: ai-standardization-kit - **Description**: 用于为仓库设置agent工作流程限制、配置自动化加载 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-02-26 - **Last Updated**: 2026-03-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # AI Standardization Kit 一套可复制的 AI Agent 开发规范化基础设施，帮助任何项目在 30 分钟内获得完整的 AI 辅助开发能力。 ## 🎯 这个 Kit 能做什么 - ✅ 为 AI Agent 建立强制性开发规范（11 阶段标准化工作流） - ✅ 自动安装 Git Hooks 门禁（pre-commit / commit-msg / pre-push / post-merge） - ✅ 提供现成的通用技能库（project-init / task-prompt-generator / workflow-enforcer 等） - ✅ 支持双 Agent 对抗验证，防止测试造假和架构违规 - ✅ 可追溯链完整：需求提示词 → 审查报告 → 变更记录 - ⭐ **可选增强**：集成 [obra/superpowers](https://github.com/obra/superpowers) 后解锁全量 11 阶段增强模式 --- ## 🚀 快速开始（3 步） ### 第 1 步：分析项目 将 `AUTO_SETUP_PROMPT.md` 中的提示词完整复制给 AI Agent，Agent 会自动扫描项目识别技术栈、构建命令、第三方服务等信息。 ### 第 2 步：执行初始化 Agent 自动部署以下内容（无需手动操作）： | 部署内容 | 目标位置 | |---------|---------| | 行为宪法 | `CLAUDE.md`（项目根目录）| | 技能文档 | `AGENTS.md`（项目根目录）| | AI 工作目录 | `.ai/`（含技能库、工作流、Agent 角色定义）| | 审查报告目录 | `.ai/reviews/`（双 Agent 验证报告）| | Git Hooks 脚本 | `.githooks/`（门禁脚本）| ### 第 3 步：安装 Git Hooks ```bash bash ai-standardization-kit/git-hooks-infrastructure/install-hooks.sh ``` 验证：运行 `git commit --allow-empty -m "test(init): verify hooks"` 确认门禁生效。 --- ## 📁 目录结构 ``` ai-standardization-kit/ │ ├── README.md ← 你在这里（入口） ├── AUTO_SETUP_PROMPT.md ← 复制给 Agent 的一键初始化提示词 ├── GUIDE.md ← 架构设计原理和深度接入指南 ├── CHECKLIST.md ← 接入前 AI 就绪度自检清单 ├── CORE_TEMPLATES.md ← 完整模板（CLAUDE.md / AGENTS.md / changelog） ├── SKILLS_INFRASTRUCTURE.md ← 技能索引规范说明 ├── UNIVERSAL_WORKFLOW.md ← 跨项目通用工作流规范（11 阶段） ├── index.json ← Kit 资产目录索引 │ ├── ai-templates/ ← 部署到目标项目 .ai/ 目录的完整模板集 │ ├── agents/ │ │ └── roles/ │ │ ├── test-writer.md ← 角色A：测试编写者 │ │ ├── code-implementer.md ← 角色B：代码实现者 │ │ ├── debugger.md ← 角色C：Debug 验证者 │ │ └── code-reviewer.md ← 角色R：独立审查者（双Agent对抗验证） │ ├── architect/ │ │ └── project-architecture-overview.md │ ├── prompts/ │ │ ├── WORKFLOW_ENFORCEMENT_GUIDE.md ← Agent 自动化触发点（核心规范） │ │ └── AI_AGENT_AUTOMATION_CHECKLIST.md │ ├── reviews/ │ │ └── README.md ← 审查报告目录说明 │ ├── skills/ │ │ └── index.json ← 项目技能索引模板 │ └── workflow/ │ ├── checklists/ │ │ ├── pre-commit.md │ │ ├── pre-development.md │ │ └── tdd-process.md │ ├── examples/ │ │ └── quick-reference-guide.md ← 11 阶段工作流速查手册 │ └── templates/ │ ├── changelog-template.md │ └── prompt-template.md │ ├── skills-library/ ← 通用技能库（可直接部署到任何项目） │ ├── project-init/ ← 项目初始化加载器（auto_load: true） │ ├── task-prompt-generator/ ← 需求提示词标准化生成器 │ ├── workflow-enforcer/ ← 工作流门禁强制器（TDD + 日志校验） │ ├── unit-test-generation-java/ ← Java / Spring Boot TDD 专项技能 │ ├── code-style-constraints/ ← 通用代码风格约束（部署时按项目定制命名） │ ├── code-review-validation/ ← 双 Agent 对抗验证技能（触发 Reviewer Agent） │ └── domain-examples/ │ └── integration-template/ ← 领域技能模板（第三方服务集成参考） │ ├── git-hooks-infrastructure/ ← Git Hooks 自动安装基础设施 │ ├── install-hooks.sh ← 安装脚本（配置 core.hooksPath + 复制脚本） │ └── hooks/ ← 可直接部署的 Hook 脚本 │ ├── pre-commit ← 提交前：工作流程检查（调用 workflow-enforcer） │ ├── pre-push ← 推送前：测试 + 构建验证（自动检测构建工具） │ ├── commit-msg ← 提交信息：Conventional Commits 格式校验 │ └── post-merge ← 合并后：技能索引自动同步 │ └── github-workflows/ ← GitHub Actions 模板 └── workflow-validation.yml ← CI 技术门禁（测试/风格/构建，不含过程检查） ``` --- ## 🏗️ 核心设计原理 ### 职责边界：CI vs Agent vs Git Hooks ``` ┌─────────────────────────────────────────────────────────────┐ │ GitHub Actions CI 技术门禁（客观事实） │ │ · mvn test / npm test │ │ · checkstyle / eslint │ │ · mvn package / npm build │ └──────────────────────────┬──────────────────────────────────┘ │ 只验证通过/失败 ┌──────────────────────────▼──────────────────────────────────┐ │ AI Agent（WORKFLOW_ENFORCEMENT_GUIDE） 过程约束 │ │ · 强制 TDD 流程（Red→Green→Refactor） │ │ · 提示词归档（.ai/prompts/） │ │ · 双 Agent 对抗审查（Reviewer Agent） │ │ · 更新修改记录（.ai/changelog/） │ └──────────────────────────┬──────────────────────────────────┘ │ 本地快速反馈 ┌──────────────────────────▼──────────────────────────────────┐ │ Git Hooks 本地门禁 │ │ · pre-commit：工作流程检查 + 代码风格 │ │ · commit-msg：Conventional Commits 格式 │ │ · pre-push：测试 + 构建验证 │ │ · post-merge：技能索引同步 │ └─────────────────────────────────────────────────────────────┘ ``` ### 双 Agent 对抗验证（核心反欺骗机制） ``` [Agent A - 测试编写] ────→ 测试文件 [Agent B - 代码实现] ────→ 功能代码 ──→ [Agent R - 独立审查] [Agent C - Debug验证] ────→ 验证报告 │ 四维度审查 ┌────────────────────┐ │ 1. 语义对齐 │ │ 2. 测试真实性 │ │ 3. 边界覆盖 │ │ 4. 架构合规 │ └────────────────────┘ │ Pass ─────┤───── Needs Revision │ │ 继续提交 返回修复 ``` ### 可追溯链 ``` .ai/prompts/prompt-{type}-{YYYYMMDD}.md ← 需求输入（开发前归档） .ai/reviews/review-{type}-{YYYYMMDD}.md ← 审查报告（Reviewer Agent 输出） .ai/changelog/ai-modifications.md ← 变更记录（审查通过后更新） ``` --- ## 📊 适用范围 | 维度 | 支持情况 | |------|---------| | 语言 / 框架 | Java（Maven/Gradle）、Node.js（npm/yarn）、Python（pytest/poetry）、Go（go test）等 | | AI Agent 工具 | Claude Code、Cursor、GitHub Copilot（通过占位符适配）| | CI 平台 | GitHub Actions（内置模板），GitLab CI / Jenkins 可参考模板自行适配 | | 仓库规模 | 单模块到多模块均适用 | --- ## 📌 关键文件说明 | 文件 | 用途 | 优先级 | |------|------|--------| | `AUTO_SETUP_PROMPT.md` | 复制给 Agent 的一键初始化提示词 | ⭐⭐⭐ 必读 | | `CORE_TEMPLATES.md` | CLAUDE.md / AGENTS.md 完整模板 | ⭐⭐⭐ 必读 | | `ai-templates/prompts/WORKFLOW_ENFORCEMENT_GUIDE.md` | Agent 行为触发点规范 | ⭐⭐⭐ 核心 | | `git-hooks-infrastructure/install-hooks.sh` | Git Hooks 安装脚本 | ⭐⭐ 重要 | | `skills-library/` | 通用技能库（即插即用）| ⭐⭐ 重要 | | `GUIDE.md` | 架构原理深度解析 | ⭐ 参考 | | `CHECKLIST.md` | 接入前自检 | ⭐ 参考 | --- *Kit Version: 4.0.0 | 参考实现：OM-Webserver | 最后更新：2026-03-16*