数据库运维【免费下载链接】MySQLTuner-perlMySQLTuner is a script written in Perl that will assist you with your MySQL configuration and make recommendations for increased performance and stability.项目地址https://gitcode.com/gh_mirrors/my/MySQLTuner-perl点击查看免费下载本文以 MySQLTuner-perl 仓库中的 .agent/README.md 为核心完整解析该目录如何为 AI Agent 构建一套“宪法级”项目治理系统治理规则Rules、专项技能Skills与自动化工作流Workflows三层资产的组织方式、各自的触发机制与执行约束以及配套的合规审计、测试编排与发布流程如何落地。读完后你将掌握该项目“AI 驱动开发”的工程骨架并能在自己的仓库中参照这套 AFFAgent-Friendly Format体系设计类似的 Agent 治理资产。1..agent目录定位项目的“技术宪法”目录.agent/README.md 开篇即定义了目录定位This directory contains the projects technical constitution, specialized skills, and operational workflows used by AI agents.也就是说.agent/不是普通文档目录而是专供 AI Agent 消费的治理资产库按职责分为三层层级目录作用触发方式治理规则 Rules.agent/rules/项目宪法、目标、架构约束、硬性执行规则、最佳实践always_on每次会话必载专项技能 Skills.agent/skills/CLI 使用、版本差异映射、Perl 兼容、测试编排等专项知识explicit_call按需调用工作流 Workflows.agent/workflows/合规审计、发布管理、实验室环境等可重复操作流程explicit_call/ 斜杠命令触发每一层文件都遵循统一的AFFAgent-Friendly Format结构。从 hey-agent 工作流 给出的标准化模板可以看到每个治理文件必须包含 frontmatter 头部与三段式正文--- trigger: [always_on | explicit_call] description: [one-line summary] category: [governance | tool | skill] --- # Title ## Rationale ## ️ Implementation ## ✅ Verification仓库内所有 Rule/Skill/Workflow 文件均严格符合该格式例如 00_constitution.md 的 frontmatter 声明trigger: always_on、category: governance。这种“机器可读的头部 固定章节”约定使 Agent 能够稳定地解析优先级与调用时机。.agent/README.md文件末尾标注*Generated automatically by /doc-sync*说明这份索引本身也是工作流自动生成的产物——doc-sync 工作流 通过perl build/doc_sync.pl脚本将 README 与当前 Rules、Skills、Workflows 的实际文件清单保持同步避免人工维护索引导致漂移。2. 治理规则层Rules从宪法到硬性执行约束.agent/README.md 列出 5 个规则文件按 Tier 0004 逐级收紧。下面按层级展开每个文件的核心内容。2.1 Tier 00项目宪法唯一事实来源00_constitution.md 是整个治理体系的“绝对事实来源”unique and absolute source of truth规定 Agent 在任何技术干预之前必须先查阅该文档。其核心内容核心使命让mysqltuner.pl成为 MySQL、MariaDB 与 Percona Server 上最稳定、最可移植、最可靠的性能调优顾问。七大支柱Key PillarsProduction Stability每条建议必须对生产环境安全零容忍破坏性“hack”Single-File Architecture严格强制单文件结构禁止模块化拆分Zero-Dependency Portability脚本必须自包含仅依赖 Perl Core 模块即可运行Universal Compatibility覆盖最广泛的 MySQL 兼容版本Legacy 5.5 到 Modern 11.xRegression Limit通过穷尽式自动化测试主动识别并防止回归Actionable Insights提供清晰、经过验证且有据可查的调优建议Release Integrity通过正式发布管理协议保证产物一致性。7-Tier AFF 治理层级Tier 00宪法→ Tier 01目标→ Tier 02架构→ Tier 03约束→ Tier 04实现→ Tier 05记忆→ Dynamic动态知识项。当前仓库实际落地的是 Tier 0004 五个文件见 .agent/rules/ 目录。2.2 Tier 01运营目标与成功标准01_objective.md 标记为$$DYNAMIC_CONTEXT$$动态上下文追踪当前优先级与成功标准。当前状态为 IN PROGRESS优先级任务是“将mysqltuner.pl维护并增强为生产级调优顾问”。其 5 条成功标准架构严格单文件架构无外部非 Core Perl 依赖质量零回归100% 的新特性与修复经 TDD 与回归套件验证稳定性所有建议可追溯到官方文档并验证生产安全文档mysqltuner.pl能力与README.md/翻译之间保持自动同步效率大库场景下优化执行最小内存占用与执行时间。路线图包含CI/CD 回归套件覆盖 10 数据库版本、自动文档同步、容器/云环境增强检测、安全审计增强。2.3 Tier 02不可变的技术架构02_architecture.md 标记为$$IMMUTABLE$$不可变给出组件地图与技术栈文件/目录功能重要级别mysqltuner.pl主脚本——强制单文件架构 CRITICALMakefile命令编排器测试、构建、LintLOWDockerfile容器化执行环境 MEDIUM.agent/Agent 专用规则与工作流LOWdocumentation/技术文档与报告 HIGHtests/校验器与调优逻辑的测试套件 HIGH技术栈为Perl核心脚本 Perlprove/Test::More 测试 Makefile/Bash/Docker/Python自动化兼容 MySQL、MariaDB、Percona 及 AWS Aurora/GCP/Azure 等环境。该文件还给出两条验证基线合规哨兵必须在mysqltuner.pl被拆分或引入非 Core 依赖时失败所有构建必须通过make docker_build。2.4 Tier 03硬性执行约束与 SDD 生命周期03_execution_rules.md 是约束最密集的文件分四块4.1 形式化禁令12 条硬约束摘其关键条款SINGLE FILE严禁将mysqltuner.pl拆分为模块NON-REGRESSION删除既有代码前必须迁移或注释保留TDD MANDATORY不得假设方案正确必须创建测试用例并运行以证明SAFE COMMANDS始终使用绝对路径监控每条命令的 exit code非零立即诊断CREDENTIAL HYGIENE绝不硬编码凭据报告/日志不得泄漏敏感信息VERSION CONSISTENCY版本号必须在CURRENT_VERSION.txt、Changelog 与mysqltuner.pl头部注释、内部变量、POD 文档三处同步后才能发布CONVENTIONAL COMMITS所有提交必须遵循 Conventional Commits 规范统一经npm run commit提交由commitlint与 Git hooks 强制校验。4.2 SDDSpec-Driven Development生命周期——所有非平凡特性必须走完整链路Specify(/specify) → Plan(/plan) → Tasks(/tasks) → Implement → Verify → Roadmap Sync各阶段产物分别落在 documentation/specifications/ 目录、implementation_plan.md与task.md最后回写 ROADMAP.md 状态[x]/[/]。4.3 编码准则SOLID、DRY、KISS、Clean Code、perltidy统一格式化此外还有 9 条核心最佳实践包括“系统调用弹性”每个外部命令sysctl/ps/free/mysql都要校验二进制存在性并处理非零退出码、“零依赖 CPAN 政策”、“建议审计轨迹”每条建议需注释指向官方文档来源、“日志逐行解析”禁止整文件载入内存、容器模式下忽略内核调优建议等。4.4 开发工作流与 Git 协议所有变更必须可用make test-*或专用测试脚本证明严禁在未经用户明确指令时执行git commit/git push/git tag所有开发必须在与master隔离的专用分支上进行发布全流程文档同步、测试、changelog、打 tag、分支管理只能由/release-manager工作流统一编排不得手工执行碎片命令。Changelog 条目必须按chore → feat → fix → test → ci的类别顺序组织且新增测试必须有test:条目、改动基础设施必须有ci:条目。2.5 Tier 04核心最佳实践04_best_practices.md 在硬约束之上给出 16 条推荐模式可归纳为五类多版本验证诊断逻辑变更必须同时测试 LegacyMySQL 8.0与 ModernMariaDB 11.4两类版本自动生成的示例报告仅限“Supported”版本以 mysql_support.md、mariadb_support.md 为准通过make test-it在 Docker 实验室验证测试可追溯性每次实验室运行必须捕获 Docker 日志、数据库注入事件并生成可完整重放命令的 Reproduce 段HTML 报告须自包含横向场景选择器、内嵌日志、Reproduce 段、MySQLTuner 输出置于底部examples/目录只保留最近 10 次运行结果报告审计任何测试套件Standard/Container/Dumpdir执行后必须审计execution.log查找 Perl 警告、SQL 执行失败FAIL Execute SQL、传输错误与 Performance Schema 状态异常必须记录到项目根的POTENTIAL_ISSUES文件发布完整性版本递增只在显式请求时发生禁止自动 bump每个版本必须伴随 releases/ 下的技术发布说明当前仓库已积累 v2.8.0.md 至 v2.9.1.md 共 40 份严禁修改历史版本的发布说明单元测试分解单测必须拆分为subtest小单元而非单体每次代码变更必须附带专用单测。3. 专项技能层Skills按需加载的领域知识.agent/README.md 列出 4 个技能目录全部以SKILL.md为载体trigger: explicit_call表示仅在 Agent 需要相应知识时加载。3.1 cli-execution-masteryCLI 连接与认证大师课cli-execution-mastery/SKILL.md 是 4 个技能中信息密度最高的一份完整覆盖了连接发现、认证策略、执行上下文与调试手段连接发现与目标定位目标类型主要命令/选项本地 Socketperl mysqltuner.pl默认或--socket/path/to/mysql.sock远程主机perl mysqltuner.pl --host1.2.3.4 --port3306容器perl mysqltuner.pl --containercontainer_name_or_id云/Azureperl mysqltuner.pl --cloud --azure认证策略重点强调避免在命令行直接传--pass防止凭据出现在进程列表首选.my.cnf--defaults-file/path/to/.my.cnf指向指定配置文件未指定时脚本自动尊重常见路径环境变量--userenvMY_USER_VAR与--passenvMY_PASS_VAR复用预置凭据密码文件--passwordfile/path/to/passwords.txt用于批量安全审计。执行上下文与调试--verbose全量诊断、--silent静默采集、--json/--prettyjson机器可读输出连接失败时用--debug全量调试输出、--dbgpattern.*正则过滤调试信息、--mysqlcmd/usr/local/bin/mysql校验自定义客户端路径。该技能还内置了两张 InnoDB 变量兼容性映射表这是跨版本诊断的知识核心。MySQL 侧摘自技能文档参数移除/弃用于说明/替代innodb_locks_unsafe_for_binlog8.0 移除改用READ COMMITTED隔离级别innodb_support_xa8.0 移除XA 始终启用innodb_file_format系列8.0 移除仅Barracuda格式tx_isolation/tx_read_only8.0 移除改用transaction_isolation/transaction_read_onlyinnodb_undo_tablespaces9.0 移除现自动管理innodb_log_file_size9.0 移除由innodb_redo_log_capacity替代innodb_api_...系列8.4 移除Memcached 相关变量移除MariaDB 侧同样给出 9 项映射如have_innodb于 10.0 移除、innodb_file_format/_check/_max于 10.6.0 移除等。这些映射在 tests/ 中有对应回归保障例如 removed_innodb_vars.t 专门验证已移除变量不再触发误报。3.2 testing-orchestration测试编排知识testing-orchestration/SKILL.md 将测试执行知识收敛为单一事实来源方式命令场景Prove标准prove -r tests/最快递归运行全部单测Prove详细prove -v -r tests/调试特定失败Makefilemake unit-testsCI/CD 标准化入口Docker 实验室make test-it多版本数据库集成测试并定义三元测试标准Tripartite Testing Standard任何逻辑变更必须覆盖三种场景——Standard--verbose、Container--container、Dumpdir--dumpdirdumps验证要求为零回归100% 通过、报告干净输出文件不得含error/warning/fatal/failed关键词、基础设施日志完整捕获、运行可复现。仓库 Makefile 的help目标确实提供了unit-tests、unit-tests-debug、test、test-all、test-container、audit等对应入口与该技能声明一致。3.3 db-version-rift 与 legacy-perl-patterns.agent/README.md 对另两个技能给出定位描述db-version-rift/SKILL.md 负责 MySQL 与 MariaDB 关键版本差异映射支撑跨兼容诊断legacy-perl-patterns/SKILL.md 提供面向旧版 Perl5.8的向后兼容维护准则与代码模式。前者与 cli-execution-mastery 中的 InnoDB 变量表互为补充后者则直接服务于宪法中“仅 Perl Core 模块”的可移植性要求。4. 工作流层Workflows18 个可编排的自动化流程.agent/README.md 列出 18 个工作流文件可按职责归为五组。每个文件都带 frontmatter 声明trigger与category便于 Agent 路由调用。4.1 质量门禁组compliance-sentinel.md治理审计是整个体系最重要的守门工作流执行 7 项核心检查单文件架构检查find . -maxdepth 2 -name *.pm | wc -l结果大于 0 即判 FAIL零依赖检查grep ^use mysqltuner.pl | sort | uniq列出全部模块引用与 Perl Core 允许清单比对系统调用保护grep -nE qx/||system( mysqltuner.pl 定位潜在裸系统调用人工确认每处均已包裹校验Changelog 合规最新条目必须符合X.Y.Z YYYY-MM-DD- type: description格式动态规则合规运行perl build/audit_logs.pl --direxamples --verbose审计实验室日志异常须登记于POTENTIAL_ISSUES历史发布说明不可变通过git diff --name-only origin/master...HEAD -- releases/确认除当前版本外无历史releases/v*.md被改动执行时机任何重大提交或发布之前运行。markdown-lint.md负责检查 Markdown 内容的整洁性与项目规范AFF 格式、关键词、链接。doc-sync.md则维护文档一致性执行perl build/doc_sync.pl刷新 .agent/README.md并附带完整评审清单——README 与翻译是否同步、mysqltuner.pl --help输出是否与脚本内CLI_METADATA一致、ROADMAP.md 已完成项是否归档、以及四步版本一致性审计CURRENT_VERSION.txt 与mysqltuner.pl中$tunerversion一致、头部与 POD 反映当前版本、Changelog 含当前版本段、releases/ 对应文件存在且同步。4.2 SDD 流程组specify.md、plan.md、tasks.md 三件套实现 4.4 节所述的 SDD 生命周期/specify在 documentation/specifications/ 生成特性规格该目录当前已含 30 份规格文档如 index_checks_pfs.md、ssl_tls_security_checks.md规格文件必须包含元数据、至少 2 个用户场景、以及带 GIVEN/WHEN/THEN 测试用例的用户故事表/plan产出技术实施计划/tasks将计划分解为 ID 可追踪的原子任务。4.3 测试与实验室组run-tests.md是统一测试编排入口分三档# 1. 本地单元/回归测试 perl build/audit_tests.pl # 测试审计脚本 make unit-tests # Makefile 入口 # 2. 多版本集成测试Docker 实验室 bash build/test_envs.sh mysql84 mariadb114 # 针对 MySQL 8.4 与 MariaDB 11.4 make test-it # 3. 进阶场景 bash build/test_envs.sh --existing-container container_id # 现有容器 bash build/test_envs.sh --remote host --audit # 远程 SSH 审计产物统一落在examples/目录report.html综合看板、raw_mysqltuner.txt完整分析输出、execution.log系统执行全迹。lab-up.md/lab-down.md构成“持久实验室”make lab-up CONFIGSmysql84启动常驻数据库容器并注入数据之后可直接perl mysqltuner.pl --host 127.0.0.1 --user root --pass mysqltuner_test反复迭代调试用docker ps验证容器存活lab-down 负责停止并清理。snapshot-to-test.md解决“生产问题到回归用例”的转化把一个正在运行的生产问题转化为可复现的测试用例呼应宪法“Regression Limit”支柱。4.4 发布管理组这一组是 README 中最长的一列体现了“统一发布编排”的设计意图release-manager.md发布总编排器MUST 由 Release Manager 角色执行。完整链路为准备验证同步 .agent/README.md、校验三处版本一致性、审计未提交变更→make test-all多版本测试 → 生成 releases/v[VERSION].md 发布说明按 Conventional Commits 分类→ 分支生命周期管理 → 执行make release VERSIONX.XX.XX完成版本 bump、USAGE.md 重生成与发布说明生成 →perl build/check_compliance.pl本地合规验证 → 合并回 master、打 tag、推送。git-flow.mdgit-flow 发布自动化。约束极严格必须在vX.XX.XX命名的专用分支上执行分支校验脚本用正则^v[0-9]\.[0-9]\.[0-9]$强制/release-preflight失败则禁止继续提交消息必须严格取自 Changelog 提取的发布说明随后创建附注 tag 并推送分支与 tag。release-preflight.md触发 git-flow 之前的飞行前检查release-notes-gen.md为当前版本生成详细技术发布说明git-rollback.md发布失败回滚删 tag、回退提交。Makefile 的release目标Makefile是上述流程的命令侧实现读取 CURRENT_VERSION.txt、sed全量替换旧版本号于mysqltuner.pl、README.md、Changelog 等文件、pod2markdown重新生成 USAGE.md、运行python3 build/release_gen.py生成发布说明——这与 03_execution_rules 中“版本号三处同步”的硬约束形成闭环而 tests/version_consistency.t 则作为回归兜底。4.5 基础设施与元管理组hey-agent.md.agent资产的“核心编排器”支持 ADD/EDIT/AUDIT/MERGE 四种管理模式。任何结构性变更都必须经它发起触发 →/specify定义需求 →/plan制定策略 →/tasks拆解 → Audit 模式扫描既有文件矛盾 → 执行变更 → 同步03_execution_rules.md/04_best_practices.md→ 立即执行/doc-sync刷新索引。这正是 .agent/README.md 能保持“自动生成且永远最新”的机制来源。local-dev-sync.md同步开发者变更、运行单测、更新 Changelog 与发布说明docker-clean.md清理无用容器与镜像回收磁盘examples-cleanup.md只保留examples/中最近 10 份结果对应 04_best_practices 第 7 条。5. 与 CI/CD 的衔接治理规则如何被机器执行.agent/目录下的 GITHUB_ACTIONS.md 进一步展示了治理规则在 CI 侧的投影核心 CI 管道push/PR 触发依次执行test_help--help无语法或未初始化错误、test_with_empty_db空库输出无警告、unit_tests含perl build/check_compliance.pl合规哨兵、EOL 同步检查、make unit-teststag 触发 Docker 镜像发布与 Release 打包另有夜间实验室报告生成、CodeQL 安全扫描、CVE 漏洞库同步、LTS/EOL API 自动 bump 等工作流。可以看到.agent/中“单文件架构”“零依赖”“版本一致性”等纸面约束最终都落成了 CI 中可执行、可失败的门禁检查。6. 实践要点小结分层治理优先级清晰Tier 00 宪法是绝对事实来源Tier 01 追踪动态目标Tier 02 锁定不可变架构Tier 03 给出硬性禁令与 SDD 流程Tier 04 沉淀最佳实践——Agent 的每次干预都先对齐 00 再向下展开。AFF 格式是机器友好性的关键统一的trigger/description/categoryfrontmatter 与 Rationale/Implementation/Verification 三段式让规则、技能、工作流可被稳定解析与路由always_on常驻加载explicit_call按需加载。索引自动同步.agent/README.md 由/doc-sync生成而非手写配合/hey-agent的 AUDIT 模式保证目录索引与实际文件清单零漂移。约束必须可验证每条规则都对应具体检查手段find查.pm、grep查use与系统调用、git diff 查历史发布说明、tests/version_consistency.t查版本一致性这正是该体系区别于普通“开发规范文档”的核心特征。发布只走一个入口从/release-preflight到/release-manager再到 git-flow 打 tag配合 releases/ 下 40 份历史发布说明与 Changelog 的强制类别顺序发布完整性被制度性地锁定。对于希望在 Perl 或其他单文件脚本项目中引入 AI Agent 辅助开发的团队MySQLTuner-perl 的.agent/目录提供了一个可参照的完整模板以宪法文件锚定不变量以技能文件沉淀领域知识以工作流文件固化重复流程并以自动生成的索引与合规审计保证体系自身不腐化。赞分享数据库运维【免费下载链接】MySQLTuner-perlMySQLTuner is a script written in Perl that will assist you with your MySQL configuration and make recommendations for increased performance and stability.项目地址https://gitcode.com/gh_mirrors/my/MySQLTuner-perl点击查看免费下载相关推荐MySQLTuner-perl 的 GitHub Actions CI/CD 体系九大自动化工作流深度解析MySQLTuner perl 的 GitHub Actions CI/CD 体系九大自动化工作流深度解析 MySQLTuner perl 仓库在 .gith数据库运维Digital Brain Agent 自动化实战用 AGENTS.md 驱动智能体脚本体系与每周工作流Digital Brain Agent 自动化实战用 AGENTS.md 驱动智能体脚本体系与每周工作流 本文聚焦 Digital Brain 示例项目中 a人工智能AI 技能提示工程AI 评测Julia AGENTS.md 实战AI Agent 源码协作规范、构建测试流程与 Agent Skills 技能体系Julia AGENTS.md 实战AI Agent 源码协作规范、构建测试流程与 Agent Skills 技能体系 Julia 仓库根目录下的 AGENT编程语言编译器语言运行时标准库JIT编译上一篇Civitai 高流量图片 Feed 的性能审查方法论从 N1 查询到缓存雪崩的生产级代码审查清单下一篇Perfect框架CI缓存加速构建过程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
