返回市场
麦克风人工智能代理指南

麦克风人工智能代理指南

作者:Anselmoo4 星标更新:2025-11-24

项目介绍

技术文档摘要

<!-- HEADER:START -->

Header

<!-- HEADER:END -->

MCP AI Agent 指南服务器

[!CAUTION] > 免责声明 -- 实验性 / 初期阶段:研究演示器 项目引用了第三方模型、工具、定价和文档,这些内容更新迅速。请将输出视为建议,并在生产使用前验证官方文档和您自己的基准。

CI/CD 管道 自动重新生成示例 链接检查器 覆盖率状态 Node.js 版本 Docker 许可证: MIT

GitHub Stars GitHub Forks GitHub Issues GitHub 最后一次提交

一个提供高级工具和模板的 Model Context Protocol (MCP) 服务器,用于分层提示、代码卫生、可视化、内存优化和敏捷规划。

📚 目录

安装

# NPX(推荐)
npx mcp-ai-agent-guidelines

# NPM 全局
npm install -g mcp-ai-agent-guidelines

# 从源码
git clone https://github.com/Anselmoo/mcp-ai-agent-guidelines.git
cd mcp-ai-agent-guidelines
npm ci && npm run build && npm start

脚本

npm run build      # TypeScript 构建
npm run start      # 构建并启动服务器
npm run test:all   # 单元 + 集成 + 示例 + MCP 烟雾测试
npm run test:coverage:unit # 单元测试覆盖率 (c8) -> 覆盖率/总结
npm run quality    # 类型检查 + Biome 检查
npm run links:check # 检查主要 Markdown 文件中的链接
npm run links:check:all # 检查所有 Markdown 文件中的链接(慢)

本地链接检查

该项目通过 GitHub Actions 自动进行链接检查。要在提交之前检查链接:

# 快速检查(README,CONTRIBUTING,免责声明)
npm run links:check

# 综合检查(所有 Markdown 文件)
npm run links:check:all

# 或直接使用 npx
npx markdown-link-check --config .mlc_config.json README.md

配置在 .mlc_config.json 中。忽略模式和重试次数在此处配置。

文档

📖 完整文档索引 - 所有工具和功能的完整指南

入门指南

高级功能

集成与参考

参见 docs/README.md 获取完整的文档索引。

快速链接

用户

开发者

维护者

参见 完整文档 获取按主题组织的完整指南列表。

示例

探索展示工具实际应用的真实世界示例。所有示例都是自动生成的,并与代码库保持同步。

📖 完整示例索引 - 所有示例及其描述的完整列表

特色示例

代码分析与质量:

提示工程:

可视化与规划:

高级功能:

本地运行示例

npm run build
node demos/demo-tools.js  # 生成样本工具输出

当工具代码更改时,示例会通过 GitHub Actions 自动重新生成。

功能与工具

27 个专业工具 用于 AI 驱动的开发工作流。每个工具都根据复杂度进行评级:

⭐ 复杂度评级:

  • 简单 - 单输入,即时输出(5-10 分钟掌握)
  • ⭐⭐ 中等 - 多参数,使用简单(15-30 分钟)
  • ⭐⭐⭐ 高级 - 复杂输入,需要理解领域(1-2 小时)
  • ⭐⭐⭐⭐ 专家 - 多阶段工作流,深度领域知识(半天)
  • ⭐⭐⭐⭐⭐ 大师 - 企业规模,全面编排(1-2 天)

📖 完整工具参考 - 带有示例的详细文档


🎨 提示构建器(9 个工具)

构建适用于各种用例的结构化有效提示。

工具目的复杂度更多信息
hierarchical-prompt-builder多层级特异性提示(上下文 → 目标 → 要求)⭐⭐指南
code-analysis-prompt-builder代码审查提示(安全性、性能、可维护性)⭐⭐指南
architecture-design-prompt-builder规模适当的指导架构设计⭐⭐⭐指南
digital-enterprise-architect-prompt-builder企业架构,带有导师视角和研究⭐⭐⭐⭐指南
debugging-assistant-prompt-builder结构化调试提示,带有系统分析⭐⭐指南
l9-distinguished-engineer-prompt-builderL9(杰出工程师)高层次技术设计⭐⭐⭐⭐⭐指南
documentation-generator-prompt-builder针对受众的技术文档(API、用户指南、规范)⭐⭐指南
domain-neutral-prompt-builder带有目标和工作流的通用模板⭐⭐⭐指南
security-hardening-prompt-builderOWASP/合规性重点的安全分析⭐⭐⭐指南

🔍 代码分析与质量(7 个工具)

通过自动化洞察分析和提高代码质量。

工具目的复杂度更多信息
clean-code-scorer包含指标分解的综合 0-100 质量评分⭐⭐⭐指南
code-hygiene-analyzer检测过时模式、未使用的依赖项、代码异味⭐⭐指南
dependency-auditor审计 package.json 的安全性、弃用、ESM 兼容性指南
iterative-coverage-enhancer分析覆盖率缺口,生成测试建议,调整阈值⭐⭐⭐指南
semantic-code-analyzer识别符号、结构、依赖项、模式(基于 LSP)⭐⭐指南
guidelines-validator验证实践是否符合 AI 代理开发指南指南
mermaid-diagram-generator生成视觉图表(流程图、序列图、ER 图、类图等)⭐⭐指南

📊 战略与规划(5 个工具)

业务战略分析和敏捷项目规划。

工具目的复杂度更多信息
strategy-frameworks-builderSWOT、BSC、VRIO、波特五力、市场分析⭐⭐⭐指南
gap-frameworks-analyzers能力、技术、成熟度、技能差距分析⭐⭐⭐指南
sprint-timeline-calculator带有 bin-packing 优化的依赖感知冲刺规划⭐⭐指南
model-compatibility-checker根据任务需求和预算推荐最佳 AI 模型指南
project-onboarding综合项目结构分析和文档生成⭐⭐指南

🎨 设计工作流(1 个工具)

多阶段设计编排,带有约束执行。

工具目的复杂度更多信息
design-assistant带有工件生成(ADR、规格、路线图)的约束驱动设计会话⭐⭐⭐⭐指南

🛠️ 实用工具(5 个工具)

支持工具,用于工作流优化。

工具目的复杂度更多信息
memory-context-optimizer优化提示缓存和上下文窗口使用⭐⭐指南
mode-switcher在代理操作模式之间切换(规划、调试、重构)指南
prompting-hierarchy-evaluator使用数值评分(清晰度、特异性、完整性)评估提示⭐⭐[指南](./docs/tools/prompting-hierarchy