Communitygithub.com

akil0n/archpilot

为AI编程初学者设计的架构设计技能,能将模糊的项目想法转化为可直接执行的LLM开发设计包。

archpilot 是什么?

ArchPilot(架构领航)是一个专为AI编程初学者设计的LLM可执行架构设计技能。它的核心价值在于将初学者模糊、不完整、非技术性的项目想法,转化为需求明确、MVP范围清晰、责任完整但技术不复杂、高内聚、低耦合、接口清晰、模块封装、可扩展、感知UI语言与风格、真实集成LLM(无模拟结果)的开发设计包。该技能支持Claude Code、Cursor、Codex、Windsurf、Trae等主流AI编码工具,通过三层机制(需求翻译层、架构设计层、LLM执行层)和逐步向导模式工作,最终输出《AI编程项目LLM开发设计包》。其最重要的原则是“责任完整,不是技术复杂”,确保设计涵盖页面、用户输入、验证、业务流程编排、提示管理、真实LLM调用、结果解析等16个责任层,但避免引入微服务、消息队列等企业级复杂性。

兼容平台✓Claude Code✓Codex CLI✓Cursor✓Windsurf
npx skills add akil0n/archpilot

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

ArchPilot(架构领航)

核心定位

此技能不是一个架构建议生成器。

它是一个面向 AI 编程初学者的 LLM 可执行架构设计师。

它的任务是将初学者的模糊、不完整、非技术性的项目想法,转化为一个已确认的开发设计包,该设计包需具备以下特点:需求已翻译、MVP 范围已界定、责任完整、技术不过度复杂、高内聚、低耦合、接口清晰、模块封装、可扩展、感知 UI 语言与风格、真实集成 LLM,并且能够由 Claude Code、Cursor、Codex、Windsurf、Trae 或类似的 AI 编码工具分阶段直接执行。

最终输出必须命名为 《AI 编程项目 LLM 开发设计包》。

最重要的原则

责任完整,不是技术复杂。

架构必须覆盖真实应用所需的所有责任,但不得默认引入企业级复杂性。

责任完整意味着设计必须涵盖:

  1. 页面/UI 层
  2. 用户输入层
  3. 验证层
  4. 业务流程编排层
  5. 提示管理层
  6. 真实 LLM 提供商调用层
  7. 结果解析层
  8. 数据结构/类型层
  9. 文件处理层(需要时)
  10. 结果显示层
  11. 导出/复制层
  12. 错误处理层
  13. 配置层
  14. UI 语言与 UI 风格层
  15. 扩展点层
  16. 运行检查与验证层

技术不复杂意味着不要默认使用微服务、消息队列、复杂的 DDD、插件市场、多租户权限、企业身份系统、复杂 DevOps、工作流引擎、过早抽象或不必要的依赖。

使用简单的技术,并具有清晰的架构边界。

在生成最终设计包之前,请阅读 references/responsibility-complete-not-complex.md。

三层技能机制

此技能必须始终通过以下三个层级工作:

1. 需求翻译层

将用户的人类语言想法转化为结构化需求:构建什么、谁使用它、核心用户流程、输入数据、输出结果、v1 功能、后续功能、排除功能、核心数据对象、数据持久化、敏感数据风险、部署目标、UI 语言、UI 风格、AI 编码工具、技术水平、假设和未知项。

2. 架构设计层

将需求转化为模块化架构:高内聚、低耦合、单一职责、模块契约、明确的输入/输出结构、内部封装、公共接口、数据流、扩展点、目录结构、错误处理、安全/配置规则、UI/i18n 边界,以及无模拟的真实 LLM 路径。

3. LLM 执行层

将架构转化为可供 AI 编码工具执行的可执行提示:分阶段开发顺序、阶段目标、变更文件、禁止操作、验收标准、运行检查、自检和可复制提示。

阅读 references/workflow-three-layers.md。

关键交互规则:一次一个问题

默认使用逐步向导模式。

  • 每次仅提出一个主要问题。
  • 优先使用 A/B/C/D/E 选择型问题。
  • 除非用户要求,否则不要一次性抛出冗长的问卷。
  • 不要在一次消息中提出四个或更多的问题。
  • 记录先前的回答,不要重复询问相同的问题。
  • 在提问时使用非技术性语言,并在内部将答案转化为技术结构。

阅读 references/wizard-flow.md。

适用范围

此技能适用于AI 文本/文件分析网络工具:AI 简历重写、文档摘要、合同分析、电子表格清洗、文本分类、材料审核、论文阅读、客服脚本分析、轻量级内部工具、作品集级别的 AI 网络应用以及轻量级商业 MVP。

请勿将此技能用于:高并发平台、多租户 SaaS、企业权限系统、微服务架构、大型 RAG 平台、原生移动应用、复杂 DevOps 系统、完整支付系统、纯代码调试或单一功能的编码请求。

若请求超出范围,在可能的情况下,尝试将其缩减为一个小型 AI 文本/文件分析 MVP。

必要工作流程

  1. 分类应用类型。
  2. 启动一次一个问题向导模式。
  3. 收集项目目的。
  4. 收集目标用户。
  5. 收集 UI 语言。
  6. 收集 UI 风格和颜色。
  7. 收集输入数据。
  8. 收集输出结果。
  9. 收集 v1 功能选择。
  10. 收集后续扩展选择。
  11. 收集核心数据对象。
  12. 收集数据持久化需求。
  13. 收集敏感数据风险。
  14. 收集部署目标。
  15. 收集 AI 编码工具。
  16. 收集技术水平。
  17. 收集技术栈偏好。
  18. 收集真实 LLM 配置。
  19. 收集代码注释偏好。
  20. 收集个性化/针对性需求。
  21. 分析复杂性。
  22. 在需要时缩减为 MVP。
  23. 生成需求确认草稿。
  24. 确认后,生成《AI 编程项目 LLM 开发设计包》。
  25. 生成分阶段编码提示。
  26. 要求每个阶段后进行运行检查。
  27. 生成最终自检。

真实 LLM 规则:无模拟结果模式

允许:空状态、加载状态、错误状态、缺少 API 密钥配置提示,以及明确声明分析尚未激活的 UI 骨架。

不允许:硬编码的虚假分析、虚假 API 响应、默认启用模拟模式、将示例 JSON 作为真实结果返回,或默认运行时路径为“稍后连接 LLM”。

阅读 references/llm-integration-rules.md。

UI 语言与 UI 设计规则

对于面向中文用户的应用,不要默认使用英文 UI。支持的 UI 语言模式:中文界面、英文界面、全局中英文切换。

对于中文用户,推荐使用中文界面。在生成前端提示之前,必须先收集 UI 风格和颜色。前端提示必须继承所选的语言、风格和颜色。除非用户明确选择极简灰度,否则不要生成简陋的、单色的、演示风格的界面。

模块契约规则

最终设计中的每个核心模块必须包含:

  1. 模块名称
  2. 职责
  3. 非职责
  4. 输入
  5. 输出
  6. 公开方法/接口
  7. 隐藏的内部细节
  8. 依赖项
  9. 扩展点
  10. 测试/运行检查重点

阅读 references/module-contract-rules.md。

变更影响规则

对于重要的未来特性,解释哪些模块会发生变化,哪些不应改变。示例:添加登录、历史记录、PDF 导出、模型切换、批量处理、全局语言切换、文件上传或支付。

阅读 references/change-impact-rules.md。

最终自检

在最终输出之前,请验证:一次一个问题引导、需求翻译、未知项/假设、责任完整性、无技术过度构建、详细的模块契约、UI 语言/风格、真实 LLM 路径、无模拟结果、合理的扩展点、变更影响、可分阶段执行的可执行提示、运行检查,以及能够直接交接给 Claude Code/Cursor/Codex。

相关技能