mcpField
P
project-architect

project-architect

github.com/ersinkoc开发260257 次安装4 周前更新
代码仓库

关于 project-architect

以文档为先的项目规划技能，可将需求整理为规格说明、实施方案、有序任务和可选品牌文档，并生成适用于 WrongStack、Claude Code 和 Cursor 等编码 Agent 的自包含提示词。

主要功能

  1. 01结构化项目需求梳理
  2. 02生成规格与实施文档
  3. 03按依赖排序任务
  4. 04可选品牌文档
  5. 05生成可移植的 PROMPT.md

适用场景

  1. 01规划新的软件项目
  2. 02准备可直接实施的项目文档
  3. 03将架构工作拆分为 Agent 任务
  4. 04创建独立的编码 Agent 提示词

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ersinkoc/project-architect --skill project-architect

安装后在 Claude Code 中输入/project-architect确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
plugin.json
.gitignore
README.md
references/
specification-guide.md
agent-prompt.md
branding-guide.md
implementation-guide.md
elicitation-guide.md
design-patterns.md
tech-stacks.md
tasks-guide.md

详细介绍

项目架构师

一个以文档为先的项目规划系统，可生成可直接实施的蓝图 和适用于 Agent 的提示词。其理念是：深入思考、详尽记录，然后 毫无歧义地执行。最终的 PROMPT.md 自包含且可移植——可交给 WrongStack、Claude Code，或任何能读写文件的 Agent。

输出流程

[Discovery]  →  SPECIFICATION.md  →  IMPLEMENTATION.md  →  TASKS.md  →  BRANDING.md
                  (The What)           (The How)           (The Work)    (Identity)
                       ↓                    ↓                   ↓
                       └────────────────────┴───────────────────┘
                                          ↓
                                     PROMPT.md
                             (Single-Shot Agent Prompt)

每份文档都会为下一份提供依据。最终的 PROMPT.md 将所有文档整合为一个 提示词，针对任何编码 Agent（WrongStack、Claude Code、 Cursor 等）的一次性执行进行了优化。

参考文件

生成每份文档前，请先阅读相应的参考文件：

阶段参考文件阅读时机
项目探索${CLAUDE_PLUGIN_ROOT}/references/elicitation-guide.md提出任何问题之前
技术栈${CLAUDE_PLUGIN_ROOT}/references/tech-stacks.md用户需要技术栈选择方面的帮助时
模式${CLAUDE_PLUGIN_ROOT}/references/design-patterns.md做出架构决策时
规格说明${CLAUDE_PLUGIN_ROOT}/references/specification-guide.md生成 SPECIFICATION.md 之前
实施方案${CLAUDE_PLUGIN_ROOT}/references/implementation-guide.md生成 IMPLEMENTATION.md 之前
任务${CLAUDE_PLUGIN_ROOT}/references/tasks-guide.md生成 TASKS.md 之前
品牌${CLAUDE_PLUGIN_ROOT}/references/branding-guide.md生成 BRANDING.md 之前
提示词${CLAUDE_PLUGIN_ROOT}/references/agent-prompt.md生成 PROMPT.md 之前

工作流

阶段 0：项目探索与信息收集

阅读 ${CLAUDE_PLUGIN_ROOT}/references/elicitation-guide.md，了解完整的问题框架。

开始撰写任何内容之前，通过结构化对话了解项目。 对于需要做出选择的内容，请积极使用 AskUserQuestion 工具——尽可能让用户点击选项，而非输入文字。

生成任何文档前，至少需要了解：

  1. 这个项目是做什么的？（简短介绍）
  2. 面向谁？（目标受众）
  3. 项目类型是什么？（Web 应用、CLI、库、API、移动应用、桌面应用、基础设施工具）
  4. 项目范围是什么？（MVP 还是完整产品）
  5. 技术栈方向（或“帮我选择”）

如果用户说“帮我选择技术栈”： 阅读 ${CLAUDE_PLUGIN_ROOT}/references/tech-stacks.md 并运行交互式技术栈选择流程。 使用 AskUserQuestion 展示选项及其利弊。

阶段 1：SPECIFICATION.md

生成前阅读 ${CLAUDE_PLUGIN_ROOT}/references/specification-guide.md。

定义项目是什么。需考虑技术因素，但不深入实施细节。 生成后，暂停并等待用户审阅。

阶段 2：IMPLEMENTATION.md

生成前阅读 ${CLAUDE_PLUGIN_ROOT}/references/implementation-guide.md 和 ${CLAUDE_PLUGIN_ROOT}/references/design-patterns.md。

将规格说明转化为项目的构建方式。在此阶段：

  • 根据项目需求推荐设计模式（参考模式指南）
  • 定义具体的目录结构，并说明每个文件的用途
  • 说明依赖项及选择理由
  • 定义模块接口和数据流
  • 为关键模式提供代码片段（签名、类型、结构示例）

模式建议： 查阅 ${CLAUDE_PLUGIN_ROOT}/references/design-patterns.md，并说明推荐特定模式的理由。不要只列出模式名称——请通过简短的代码示例，展示每种模式如何应用于这个项目。

阶段 3：TASKS.md

生成前阅读 ${CLAUDE_PLUGIN_ROOT}/references/tasks-guide.md。

将实施方案转化为有序的工作项。每项任务必须：

  • 可由编码 Agent 在单次会话中完成
  • 包含完整上下文，且自成一体
  • 按严格的依赖顺序排列
  • 指明需要创建或修改的确切文件
阶段 4：BRANDING.md（可选）

生成前，请阅读 ${CLAUDE_PLUGIN_ROOT}/references/branding-guide.md。

只有用户提出要求或项目面向用户时才生成。

阶段 5：PROMPT.md（始终生成）

生成前，请阅读 ${CLAUDE_PLUGIN_ROOT}/references/agent-prompt.md。

这是最关键的输出。 综合所有文档，编写一份单次执行提示词，让任意编码 Agent（WrongStack、Claude Code、Cursor，……）都能据此从零构建整个项目。提示词必须完全自包含，针对复杂模式提供内联代码，并按顺序列出所有要创建的文件。

操作规则

  1. 文档按顺序生成。 SPEC → IMPL → TASKS → BRANDING → PROMPT。绝不跳过。

  2. 在文档之间暂停。 展示每份文档，并在继续下一份之前征求用户批准。

  3. 使用 AskUserQuestion 处理决策。 技术栈、数据库、身份验证、部署等任何有 2 到 4 个明确选项的决策，都应使用交互式选项，而不是开放式提问。

  4. 给出建议，不要强行规定。 提供 2 到 3 个选项及其权衡，让用户选择。如果用户说“你来选”，就做出选择并说明原因。

  5. 根据项目规模调整。 周末项目使用简洁文档和 15 到 30 项任务；企业级平台使用详尽文档和 100 项以上任务。深度应与项目的雄心相匹配。

  6. 始终保存为文件。 每份文档都应作为 Markdown 文件保存到当前工作目录下的 ./[project-name]/docs/。使用 Write 工具保存。

  7. 在文档之间交叉引用。 IMPL 引用 SPEC 章节。TASKS 引用 IMPL 模块。PROMPT 内联所有必需内容。

  8. 不写填充内容。 每一行都必须针对当前项目。删除通用模板内容。

  9. 设计模式是建议。 为 IMPLEMENTATION.md 选择模式时，请查阅 ${CLAUDE_PLUGIN_ROOT}/references/design-patterns.md，并根据项目的具体需求选择合适的模式。每项建议都要简要说明“为何采用此模式”。

插件感知集成

检查用户是否安装了其他 Claude Code 插件或技能。如果有：

  • 前端框架规划器（react-app-planner、nextjs-app-planner 等）→ 建议在架构文档完成后使用它，深入讨论框架决策
  • 前端设计 → 在 IMPLEMENTATION.md 中将其作为 UI 组件指导的参考
  • 品牌／设计技能 → 将其整合到 BRANDING.md 的生成中
  • MCP 构建器 → 如果项目包含 MCP 服务，请在实现阶段提及该技能
  • 特定语言技能（typescript-mastery 等）→ 将该技能中的编码标准纳入 IMPLEMENTATION.md

自然地提及相关技能：“你有 react-app-planner 技能——高层规划完成后，要不要用它深入讨论 React 架构决策？”

处理不完整的输入

场景操作
含糊的一句话描述使用 AskUserQuestion 进行完整的信息收集
详细的简报提取已有答案，只询问缺失信息
上传了现有规格说明验证并提出改进建议，然后从阶段 2 继续
“只要规格说明”仅生成 SPECIFICATION.md，并提出稍后继续
“跳到任务”收集背景信息，生成精简的规格说明和实现方案，然后生成任务
“只给我提示词”精简收集需求 → 直接生成 PROMPT.md
“帮我选技术栈”使用 ${CLAUDE_PLUGIN_ROOT}/references/tech-stacks.md 中的技术栈顾问
“我应该使用哪些模式？”查阅 ${CLAUDE_PLUGIN_ROOT}/references/design-patterns.md，并询问项目情况

评论

支持 Markdown