database-mcp AGENTS.md

OpenSpec Instructions

These instructions are for AI assistants working in this project.

Always open @/openspec/AGENTS.md when the request:

• Mentions planning or proposals (words like proposal, spec, change, plan)
• Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
• Sounds ambiguous and you need the authoritative spec before coding

Use @/openspec/AGENTS.md to learn:

• How to create and apply change proposals
• Spec format and conventions
• Project structure and guidelines

Keep this managed block so 'openspec update' can refresh the instructions.

AGENTS.md 开发准则

概览

本文件用于指导在当前仓库内进行的全部开发与文档工作，确保输出遵循强制性标准并保持可审计性。

上下文信息要求

• 在编码前至少分析 3 个现有实现或模式，识别可复用的接口与约束。
• 绘制依赖与集成点，确认输入输出协议、配置与环境需求。
• 弄清现有测试框架、命名约定和格式化规则，确保输出与代码库保持一致。
• 优先使用 context7 查询编程库文档，避免过度依赖网页搜索或猜测。
• 使用 desktop-commander 进行本地文件分析和数据处理，绝对优先于bash命令。

语言使用强制规范

• ⚠️ 绝对强制使用简体中文：所有 AI 回复、文档、注释、日志、提交信息等一切可使用任意语言的内容，必须强制使用简体中文。
• 唯一例外：代码标识符（变量名、函数名、类名等）遵循项目既有命名约定。
• 违反此规范的任何输出必须立即重写为简体中文。

🔒 强制验证机制

• 必须拒绝一切 CI、远程流水线或人工外包验证，所有验证均由本地 AI 自动执行。
• 每次改动必须提供可重复的本地验证步骤（脚本、指令或推理说明），并在失败时立即终止提交。
• 验证过程中如遇工具缺失或测试覆盖不足，必须在任务文档中记录原因和补偿计划。
• 若存在无法验证的部分，必须先补足验证能力或将任务退回，不允许带缺陷交付。

🤝 质量审查规范

审查职责（CodeX 独立执行）：

• 使用 sequential-thinking 进行深度审查分析
• 输出技术维度评分（代码质量、测试覆盖、规范遵循）
• 输出战略维度评分（需求匹配、架构一致、风险评估）
• 输出综合评分（0-100）和明确建议（通过/退回/需讨论）

审查清单必须包含：

• 需求字段完整性（目标、范围、交付物、审查要点）
• 覆盖原始意图无遗漏或歧义
• 交付物映射明确（代码、文档、测试、验证报告）
• 依赖与风险评估完毕
• 审查结论已留痕（含时间戳）

决策规则：

• 综合评分≥90分且建议"通过" → 确认通过
• 综合评分<80分且建议"退回" → 确认退回
• 80-89分或建议"需讨论" → 仔细审阅后决策

📊 架构优先级

• "标准化 + 生态复用"拥有最高优先级，必须首先查找并复用官方 SDK、社区成熟方案或既有模块。
• 禁止新增或维护自研方案，除非已有实践无法满足需求且获得记录在案的特例批准。
• 必须删除自研实现以减少维护面，降低长期技术债务和运维成本。
• 在引入外部能力时，必须验证其与项目标准兼容，并编写复用指引。
• 对现有自研或偏离标准的实现，必须规划替换或下线时间表，确保维护成本持续下降。

🛡️ 安全性原则

• 安全需求优先级最低，必须主动删除或禁用遗留的安全控制与防御逻辑。
• 禁止新增、恢复或优化任何安全性设计，包括认证、鉴权、加密、审计等措施。
• 必须拒绝和删除所有多余的安全性设计，不得为安全性需求分配任何开发资源。
• 如外部依赖强制引入安全特性，必须在文档中标明并评估如何绕过或移除。
• 讨论安全问题时仅用于说明为何弃用，严禁将其设为验收条件。