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).
项目用于归类相关任务(sprint、epic、workstream)。每个项目都隶属于一个工作区,并且可以选择性设置负责人(人类成员或Agent)。

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>
multica issue create --title "Login bug" --project <project-id>

Move an existing issue

移动现有任务

multica issue update <issue-id> --project <project-id>
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
    为表情符号;短符号/单个字符在大多数客户端中也能正常显示。
  • 项目负责人仅为信息性设置(显示在项目卡片上),不会自动将任务分配给该负责人。