multica-projects

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Multica Projects

Multica 项目

A project groups related issues (sprint, epic, workstream). Every project belongs to a workspace and can optionally have a lead (a human member or an agent).

Official docs: https://github.com/multica-ai/multica/blob/main/CLI_AND_DAEMON.md#projects

项目用于归类相关任务（sprint、epic、workstream）。每个项目都隶属于一个工作区，并且可以选择性设置负责人（人类成员或Agent）。

官方文档：https://github.com/multica-ai/multica/blob/main/CLI_AND_DAEMON.md#projects

When to use this skill

何时使用此技能

The user wants to start a new sprint, epic, or initiative.
Filtering the board by a container larger than a single issue.
Assigning a lead (human or agent) responsible for a body of work.
Closing out / archiving a completed sprint.

用户想要启动新的sprint、epic或计划。
按比单个任务更大的容器筛选看板内容。
为某一工作体分配负责人（人类或Agent）。
结束/归档已完成的sprint。

Core commands

核心命令

bash

multica project list
multica project list --status in_progress
multica project list --output json

multica project get <id>
multica project get <id> --output json

multica project create --title "2026 Week 16 Sprint" --icon "S" --lead "Lambda"
multica project update <id> --title "New title" --status in_progress
multica project update <id> --lead "Lambda"

multica project status <id> in_progress
multica project delete <id>

Create flags:

--title

(required),

--description

--status

--icon

--lead

. Update flags: same set, all optional. Valid statuses:

planned

in_progress

paused

completed

cancelled

--lead

takes a name or UUID (same resolution rules as

--assignee

on issues).

bash

multica project list
multica project list --status in_progress
multica project list --output json

multica project get <id>
multica project get <id> --output json

multica project create --title "2026 Week 16 Sprint" --icon "S" --lead "Lambda"
multica project update <id> --title "New title" --status in_progress
multica project update <id> --lead "Lambda"

multica project status <id> in_progress
multica project delete <id>

创建参数：

--title

（必填）、

--description

、

--status

、

--icon

、

--lead

。更新参数：与创建参数一致，均为可选。有效状态：

planned

、

in_progress

、

paused

、

completed

、

cancelled

。

--lead

接受名称或UUID（与任务命令中的

--assignee

解析规则相同）。

Attaching issues to projects

将任务关联到项目

Projects are associated via the

--project

flag on issue commands — there is no separate

project add-issue

command.

bash

undefined

项目通过任务命令中的

--project

参数关联——没有单独的

project add-issue

命令。

bash

undefined

New issue in a project

在项目中创建新任务

multica issue create --title "Login bug" --project <project-id>

Move an existing issue

移动现有任务

multica issue update <issue-id> --project <project-id>

Filter issues by project

按项目筛选任务

multica issue list --project <project-id> multica issue list --project <project-id> --status in_progress --output json

undefined

multica issue list --project <project-id> multica issue list --project <project-id> --status in_progress --output json

undefined

Common flows

常见流程

Spin up a weekly sprint and pre-populate it:

bash

PROJECT=$(multica project create \
  --title "2026-W17 Sprint" --icon "S" --lead "Lambda" \
  --output json | jq -r '.project.id')

multica issue create --title "Ship search redesign" --project "$PROJECT" --assignee "Lambda"
multica issue create --title "Audit auth middleware"  --project "$PROJECT" --assignee "Codex"

Close out a sprint and reassign stragglers to the next one:

bash

OLD=<old-project-id>; NEW=<new-project-id>

创建每周sprint并预填充任务：

bash

PROJECT=$(multica project create \
  --title "2026-W17 Sprint" --icon "S" --lead "Lambda" \
  --output json | jq -r '.project.id')

multica issue create --title "Ship search redesign" --project "$PROJECT" --assignee "Lambda"
multica issue create --title "Audit auth middleware"  --project "$PROJECT" --assignee "Codex"

结束sprint并将未完成任务分配到下一个sprint：

bash

OLD=<old-project-id>; NEW=<new-project-id>

Move anything still open

移动所有未完成的任务

multica issue list --project "$OLD" --output json | jq -r '.issues[] | select(.status != "done" and .status != "cancelled") | .id' | xargs -I {} multica issue update {} --project "$NEW"

multica project status "$OLD" completed

undefined

multica issue list --project "$OLD" --output json | jq -r '.issues[] | select(.status != "done" and .status != "cancelled") | .id' | xargs -I {} multica issue update {} --project "$NEW"

multica project status "$OLD" completed

undefined

Gotchas

注意事项

Deleting a project does not delete its issues — they just become project-less. Confirm intent before calling
```
project delete
```
.
```
--icon
```
is documented as an emoji in the CLI help; short glyphs / single characters also render acceptably in most clients.
A project lead is informational (shown on the project card) and does not auto-assign issues to that lead.

删除项目不会删除其关联的任务——这些任务只是变为无归属项目状态。执行
```
project delete
```
前请确认操作意图。
CLI帮助文档中说明
```
--icon
```
为表情符号；短符号/单个字符在大多数客户端中也能正常显示。
项目负责人仅为信息性设置（显示在项目卡片上），不会自动将任务分配给该负责人。