[!CAUTION] > 免责声明 -- 实验性 / 初期阶段: 本 研究演示器 项目引用了第三方模型、工具、定价和文档,这些内容更新迅速。请将输出视为建议,并在生产使用前验证官方文档和您自己的基准。
一个提供高级工具和模板的 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 驱动的开发工作流。每个工具都根据复杂度进行评级:
⭐ 复杂度评级:
📖 完整工具参考 - 带有示例的详细文档
构建适用于各种用例的结构化有效提示。
| 工具 | 目的 | 复杂度 | 更多信息 |
|---|---|---|---|
hierarchical-prompt-builder | 多层级特异性提示(上下文 → 目标 → 要求) | ⭐⭐ | 指南 |
code-analysis-prompt-builder | 代码审查提示(安全性、性能、可维护性) | ⭐⭐ | 指南 |
architecture-design-prompt-builder | 规模适当的指导架构设计 | ⭐⭐⭐ | 指南 |
digital-enterprise-architect-prompt-builder | 企业架构,带有导师视角和研究 | ⭐⭐⭐⭐ | 指南 |
debugging-assistant-prompt-builder | 结构化调试提示,带有系统分析 | ⭐⭐ | 指南 |
l9-distinguished-engineer-prompt-builder | L9(杰出工程师)高层次技术设计 | ⭐⭐⭐⭐⭐ | 指南 |
documentation-generator-prompt-builder | 针对受众的技术文档(API、用户指南、规范) | ⭐⭐ | 指南 |
domain-neutral-prompt-builder | 带有目标和工作流的通用模板 | ⭐⭐⭐ | 指南 |
security-hardening-prompt-builder | OWASP/合规性重点的安全分析 | ⭐⭐⭐ | 指南 |
通过自动化洞察分析和提高代码质量。
| 工具 | 目的 | 复杂度 | 更多信息 |
|---|---|---|---|
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 图、类图等) | ⭐⭐ | 指南 |
业务战略分析和敏捷项目规划。
| 工具 | 目的 | 复杂度 | 更多信息 |
|---|---|---|---|
strategy-frameworks-builder | SWOT、BSC、VRIO、波特五力、市场分析 | ⭐⭐⭐ | 指南 |
gap-frameworks-analyzers | 能力、技术、成熟度、技能差距分析 | ⭐⭐⭐ | 指南 |
sprint-timeline-calculator | 带有 bin-packing 优化的依赖感知冲刺规划 | ⭐⭐ | 指南 |
model-compatibility-checker | 根据任务需求和预算推荐最佳 AI 模型 | ⭐ | 指南 |
project-onboarding | 综合项目结构分析和文档生成 | ⭐⭐ | 指南 |
多阶段设计编排,带有约束执行。
| 工具 | 目的 | 复杂度 | 更多信息 |
|---|---|---|---|
design-assistant | 带有工件生成(ADR、规格、路线图)的约束驱动设计会话 | ⭐⭐⭐⭐ | 指南 |
支持工具,用于工作流优化。
| 工具 | 目的 | 复杂度 | 更多信息 |
|---|---|---|---|
memory-context-optimizer | 优化提示缓存和上下文窗口使用 | ⭐⭐ | 指南 |
mode-switcher | 在代理操作模式之间切换(规划、调试、重构) | ⭐ | 指南 |
prompting-hierarchy-evaluator | 使用数值评分(清晰度、特异性、完整性)评估提示 | ⭐⭐ | [指南](./docs/tools/prompting-hierarchy |