管理项目工作与材料

Projects 页面把一个已注册项目里的工作项、产物、Skills、工作约定和项目会话集中到同一处。项目必须有真实根目录；工作项数据由 NextClaw 独立保存，不要求在项目目录中添加追踪文件或专用 Skill。

查看项目主页

先在聊天侧边栏创建项目或添加已有目录，再点击项目名称打开项目主页。页面保留原有的产物、Skills、工作约定和项目会话能力，同时提供工作项概览、列表与看板。

概览页把“当前工作”和“最近产物”作为两个同等重要的区域：宽布局左右并列，窄布局上下排列。最近产物来自工作项已经显式关联的项目文件；概览不会为了显示统计或最近产物而扫描项目目录、读取消息或重放会话历史。完整产物页使用相同的显式关联记录，Skills 固定来自 .agents/skills，工作约定固定来自项目根目录 AGENTS.md。

从项目列表移除

不再需要某个项目时，将会话列表切换为按项目查看，打开项目行最右侧的 更多操作 菜单，再选择 从项目列表移除。确认框会先说明影响，再执行移除。

这个操作只会把项目从 NextClaw 的项目列表中移除，不会删除本地目录、历史会话或 Project Work。已有会话仍可在会话列表中使用；以后重新添加或重新绑定同一目录时，会恢复原项目和工作记录。

CLI 使用同一套安全合同，并要求确认值与项目 ID 完全一致：

nextclaw projects remove <project-id> --confirm <project-id> --json

创建和推进工作项

在 工作项 页面创建工作项。每个项目首次使用时会获得一组通用状态：待整理、已计划、进行中、评审中、等待验收、已完成和已取消。这些内置状态会跟随界面语言显示；重命名后则始终显示你设置的名称。

状态名称和顺序可以按项目调整，也可以增加自定义状态。每个状态同时归属于一个稳定的生命周期类别：backlog、unstarted、started、completed 或 canceled。这样既能自定义流程，又能让概览统计保持一致。删除仍在使用的状态时，需要先选择迁移目标。

工作项的状态变化不会覆盖历史。比如从 In Progress 进入 In Review、评审未通过后回到 In Progress、再次进入 In Review，每次变化都会保留在活动时间线里。

列表默认按项目的自定义状态分组，每个状态显示完整数量，可以折叠并独立加载下一批。看板复用相同的状态分组、排序和分页结果，不会先把全部工作项下载到前端再切分。

列表、看板和概览中的工作项都可以点击。它们统一在右侧详情抽屉中打开，不会把详情平铺追加到当前页面。抽屉中可以：

• 修改标题、说明、状态和关注标记；
• 查看完整活动时间线；
• 软删除或恢复工作项；
• 关联或移除项目内的产物文件，并直接打开关联文件。

AI 如何使用工作项

只有归属于某个项目的会话才会获得 Project Work 工具。AI 可以列出、查看、创建和更新工作项，也可以关联或移除产物；不在项目中的会话不会看到这些工具。

工作项表示需要长期追踪的用户意图和交付目标。AI 在一次运行中临时使用的步骤或计划不属于本功能，本功能也不会替换运行计划。

工作项变更通过实时事件通知页面刷新当前数据。事件只承担“发生了变化”的通知，不作为数据库，也不要求读取事件历史。

数据与项目目录边界

工作项、状态、活动历史和产物关联存放在 NextClaw 自己的数据目录。项目根路径仍是项目身份和文件边界的一部分，但 NextClaw 不会为了工作项追踪向该目录写入专用文件。

产物关联只接受项目根目录内真实存在的文件。数据库保存相对于项目根目录的路径，因此移动 NextClaw 数据目录时不会把本机绝对路径写进工作项记录。

从 CLI 管理

CLI 无法像项目会话一样从上下文得知当前项目，因此所有工作项命令都必须显式传入项目 ID：

nextclaw projects work list --project <project-id>
nextclaw projects work list --project <project-id> --state <state-id> --limit 20
nextclaw projects work create "完善项目页" --project <project-id>
nextclaw projects work update <work-item-id> --project <project-id> --state <state-id>
nextclaw projects work activity <work-item-id> --project <project-id>

work list 默认返回 20 条，最多 100 条；还有结果时会返回 opaque cursor，可通过 --cursor 继续读取。CLI 通过正在运行的本地 NextClaw 服务复用同一套 Kernel 合同；服务未运行时会直接报错，不会另起第二个写入进程。完整命令见命令行参考。

项目材料来源

• 产物只展示通过 Project Work 工作项显式关联的文件；同一路径会去重，支持搜索和分页。删除文件不会删除关联历史，页面会将它标记为不可用。
• Skills只读取项目根目录下的 .agents/skills，不支持项目级自定义扫描路径。需要在 CLI 查看时，使用 nextclaw skills installed --workdir /absolute/path/to/project --scope project。
• 工作约定只读取项目根目录 AGENTS.md。文件不存在时显示空态，不会生成配置诊断。

Projects 不读取 .nextclaw/project.yaml，也不会扫描全部项目文件或历史会话来推断这些材料。