项目
除非有人记得上下文，否则每个 AI 代理会话都会从零开始。项目就是那个“有人”。它们包含你的技术栈、仓库、文档和决策，让代理不会在每次会话开始时都问“我们用什么框架？”。没有项目，你会一遍又一遍地重复相同的上下文。有了项目，代理启动时就具备所需的一切。
项目是 Almirant 中的主要容器。它将看板、工作项、冲刺、文档、仓库和配置归入同一实体。团队的所有工作都在项目内组织。
创建项目
Almirant 提供创建项目的引导式向导。可从侧边菜单或路径 /projects/new 访问。
向导步骤
- 名称和描述 -- 定义唯一的项目名称和可选描述。
- 视觉外观 -- 选择具有代表性的颜色和图标，以便在导航中快速识别项目。
- 技术栈 -- 指明项目技术（语言、框架、数据库）。AI 会使用此信息为任务提供上下文。
- 环境 URL -- 登记生产环境和预发布环境的 URL，以便快速访问并让 AI 能够引用它们。
- 组织和客户 -- 将项目关联到组织，并可选择关联客户。
- 确认 -- 检查信息并创建项目。
配置字段
| 字段 | 描述 | 必填 |
|---|---|---|
name | 项目名称 | 是 |
description | 项目概述 | 否 |
color | 用于侧边栏视觉识别的颜色 | 否 |
icon | 项目的代表性图标 | 否 |
techStack | 所用技术的数组（例如 ["Next.js", "PostgreSQL"]） | 否 |
productionUrl | 生产环境 URL | 否 |
stagingUrl | 预发布环境 URL | 否 |
client | 关联客户的名称 | 否 |
organizationId | 项目的所属组织 | 是 |
项目仪表板
访问项目（/projects/[id]）时，会显示一个仪表板，其中包含：
- 工作项摘要 -- 按类型和当前状态统计。
- 活跃看板 -- 项目的看板列表，可直接访问。
- 活跃冲刺 -- 当前冲刺的信息（如有）。
- 仓库 -- 已连接到项目的 GitHub 仓库。
- 最近活动 -- 项目变更和事件的历史记录。
文档链接
每个项目都可以包含外部文档链接。文档链接允许将相关 URL（Confluence、Notion、Google Docs、内部 wiki）关联到项目，以便团队和 AI 都能快速访问上下文。
要添加文档链接：
- 访问项目。
- 前往 Doc Links 部分。
- 输入 URL 和描述性标题。
- 保存链接。
项目备注
项目包含一个备注系统，用于记录决策、技术上下文或任何不适合放入工作项的相关信息。备注会关联到项目，且对整个团队可见。
仓库
将 GitHub 仓库连接到项目，以便 AI 可以引用代码、创建拉取请求，并将提交关联到工作项。请参阅集成部分，了解 GitHub 配置的更多详情。
项目截图
你可以将截图附加到项目，以便直观记录应用的当前状态、模型图或任何图形参考资料。
转移项目
项目可以在组织之间转移。转移是原子的，并包括：
- 项目及其所有配置。
- 所有关联的工作项（包括创意和里程碑）。
- 看板和列映射。
要转移项目：
- 访问项目设置。
- 选择 转移项目。
- 选择目标组织。
- 确认转移。
注意
转移会移动整个项目。继续之前，请确保目标组织具有适当的权限和配置。
删除项目
删除项目是永久操作，会删除所有关联数据（看板、工作项、冲刺、文档、备注、仓库）。此操作无法撤销。
- 访问项目设置。
- 选择 删除项目。
- 输入项目名称以确认。
危险
删除项目会不可逆地清除所有看板、工作项、冲刺和关联数据。
开发者指南
开发者指南
应用路由
| 路由 | 描述 |
|---|---|
/projects | 所有项目的列表 |
/projects/new | 项目创建向导 |
/projects/[id] | 项目仪表板 |
MCP 工具
以下工具可通过 MCP 以编程方式管理项目：
| 工具 | 描述 | 主要参数 |
|---|---|---|
list_projects | 列出组织的所有项目 | organizationId（会话中有 projectId 时可选） |
create_project | 创建新项目 | name, description, techStack, productionUrl, stagingUrl |
update_project | 更新现有项目的字段 | projectId、要更新的字段 |
get_project | 获取项目的完整详情 | projectId |
get_project_roadmap | 获取包含史诗和功能的项目路线图 | projectId |
示例：通过 MCP 创建项目
Tool: create_project
Parametros:
name: "Mi Aplicacion Web"
description: "Plataforma SaaS para gestion de inventario"
techStack: ["Next.js", "PostgreSQL", "Tailwind CSS"]
productionUrl: "https://app.ejemplo.com"
stagingUrl: "https://staging.ejemplo.com"
示例：查询路线图
Tool: get_project_roadmap
Parametros:
projectId: "uuid-del-proyecto"
返回项目的层级结构，包括史诗、功能及其当前进度。