AI-SDLC Prompts

AI-SDLC Prompts — MCP 服务

通过 Model Context Protocol 的 stdio 传输方式，将 AI-SDLC Pro 提示词库（112 个提示词，西班牙语/英语）提供给 AI Agent（Claude Code、Claude Desktop、Cursor 等）。

只读：没有任何工具会写入代码仓库、GitHub 或任何外部系统。所有内容均从 data/prompts-full.json 提供，该文件由代码仓库根目录中的 python build.py 生成——此服务不会自行解析 Markdown。

从这里获取的每个提示词都会附带其操作契约：自主性上限、允许使用的工具、停止标准和最低证据要求。这与从网站复制时附带的内容相同，resolve_prompt 默认会附加该契约——参见操作契约。

安装

已发布到 npm：ai-sdlc-prompts-mcp。

许可证：此服务的代码采用 MIT 许可证；提供的提示词采用 CC BY 4.0 许可证（允许商业使用，但须注明出处）。参见 LICENSE。

无需克隆代码仓库：

npx ai-sdlc-prompts-mcp

从本地克隆的代码仓库安装：

cd mcp-server
npm install

运行

npm start
# equivalente a: node index.js

进程通过 stdin/stdout 监听（MCP 协议）——不提供 HTTP 服务，也不需要网络。按 Ctrl+C 或客户端关闭连接时，进程会退出。

在 Claude Code / Claude Desktop 中配置

将以下内容添加到客户端的 MCP 服务配置中（claude_desktop_config.json 或 Claude Code 的等效配置文件），并将路径调整为本地检出目录的绝对路径：

{
  "mcpServers": {
    "ai-sdlc-prompts": {
      "command": "node",
      "args": ["/ruta/absoluta/a/ai-sdlc-prompts/mcp-server/index.js"]
    }
  }
}

使用 npm 包，无需绝对路径或克隆代码仓库：

{
  "mcpServers": {
    "ai-sdlc-prompts": {
      "command": "npx",
      "args": ["-y", "ai-sdlc-prompts-mcp"]
    }
  }
}

操作契约

112 个提示词中的每一个，都在其编辑契约中声明了 Agent 可以做到什么程度。resolve_prompt 会将该契约附加到返回的文本中：

## Contrato de operación

Estas restricciones vienen del contrato editorial de este prompt.
Si la tarea las contradice, decláralo en vez de excederlas.

- **Autonomía máxima:** A1 — Proponer
- **Herramientas permitidas:** lectura opcional de la estructura actual…
- **Detente y pregunta cuando:** si el tipo de proyecto o el stack son ambiguos…
- **Evidencia mínima de tu salida:** el árbol de directorios y la tabla…

这比在浏览器中更需要 MCP：从网站复制的人会粘贴并阅读；通过 MCP 请求提示词的 Agent 通常会执行。不附带自主性上限，是丢失该上限的两种方式中更糟糕的一种。

不会要求 Agent 不惜一切代价服从：如果任务与契约相矛盾，Agent 必须明确说明，而不是默默自行决定。测试会阻止有人把它写成那样（tests/test_mcp_contract_parity.py）。

可通过 append_contract: false 禁用——这适用于检查原始文本，而非日常使用。

提供的工具

工具	描述
list_prompts	列出提示词，可选按章节（00-17）、风险（low/medium/high/variable）、自主性（A0-A3）和自由文本筛选。
get_prompt	按 id 获取提示词的完整详情：标题、描述、原始文本（未解析占位符）、使用公式、编辑契约和推荐的后续提示词。
resolve_prompt	使用提供的变量替换提示词中的占位符（以及可选的框架前言）——与网站进行的替换相同。返回解析后的文本，以及仍未解析的必填/可选占位符。
get_framework	框架的必需前言（网站会将此部分置于每个复制的提示词之前）。
recommend_next	根据编辑契约，推荐在指定提示词之后继续使用的提示词。

resolve_prompt 的变量

variables 的键是网站变量系统中的规范字段，而不是提示词文本中出现的 [EN MAYÚSCULAS] 别名：

repositorio、referencia、rama_actual、rama_destino、ambiente、componentes、modulo、stack、tipo_proyecto、metodologia、agentes、autonomia、entrada、objetivo、responsable、workspace、compliance、documentos、profundidad、adicionales（适用于前述字段未涵盖的占位符的 TOKEN=valor 行）。

示例：

{
  "id": "07-06-pruebas-performance-carga",
  "lang": "es",
  "variables": {
    "repositorio": "org/mi-repo",
    "ambiente": "staging",
    "adicionales": "PATRON DE CARGA=1000 req/s durante 10 min"
  }
}

开发

npm test    # node --test test/ -- 29 tests: dataStore, resolvePrompt, integración MCP real (InMemoryTransport)

数据（data/prompts-full.json）通过在仓库根目录运行 python build.py 重新生成 — 不要手动编辑该文件。对提示词内容的任何更改都应在 ai_sdlc_pro_prompts/*.md 中进行。

第一版的范围

• 在使用者的机器上运行（npx -y ai-sdlc-prompts-mcp，或在克隆的仓库中运行 node index.js）。
• 仅支持 stdio 传输 — 不提供 HTTP 服务。