用途:管理 Multica 项目的持久化上下文。项目是持久上下文容器,挂载到项目上的资源会影响后续 agent 任务;资源不只用于展示,还会注入任务简报并写入 .multica/project/resources.json。项目描述同样是持久上下文,会注入 agent 简报的 ## Project Context 并作为 project_description 写入该文件,用于项目级规则。
主要能力:CLI 提供项目列表、获取、创建、更新、状态修改,以及资源的列出、添加、更新、删除。命令示例:multica project list --output json;multica project get <project-id> --output json;multica project create --title "<title>" --repo <github-url> --output json;multica project resource add <project-id> --type github_repo --url <github-url> --output json;multica project resource remove <project-id> <resource-id> --output json。
资源类型:github_repo 具有 resource_ref.url、可选 checkout ref 及 prompt-only 的 default_branch_hint;local_directory 具有 resource_ref.local_path、daemon_id、可选 label 与 execution_mode(in_place 默认或 worktree)。
使用方式:--start-date / --due-date 为可选日期(YYYY-MM-DD),传空字符串可清除。在评论中引用项目用 标题,这是纯链接,无副作用;优于粘贴项目 URL,因移动端不会展开。
限制与副作用:项目创建/更新/删除/状态及资源增删改都会改变持久工作区状态并影响未来任务;更改 local_directory 前应先询问用户,除非用户明确指定了该路径。Issue 评论不会创建持久项目资源。worktree 要求路径为至少有一次提交的 git 仓库,否则任务显式报错;daemon 未声明 local-worktree-v1 能力时保存会被拒(HTTP 422,daemon_version_unsupported)。缺失信息:具体价格、平台覆盖等资料未提供。