# ai-proj — 任务与需求管理

## What it does

通过 ai-proj（`https://ai.pipexerp.com`）的 MCP / CLI 管理需求、任务、文档与进度：查询、创建、更新状态、关联需求与任务、挂证据文档。是所有项目状态数据的唯一权威来源。

## When to reach for it

- 要查「某个 REQ / 任务的真实状态、优先级、截止、关联任务」
- 要更新任务状态、挂文档、改优先级、改派
- 汇报进度或做对齐检查前，需要拉真实数据

## Common questions

- **数据以哪为准？** ai-proj，不靠聊天记录或记忆。主机必须是 `https://ai.pipexerp.com`（写成 `api.pipexerp.com` 会失败）。
- **可以自己改需求优先级吗？** 不行，需求优先级是业务决策；任务优先级可以对齐需求。
- **任务 completed 就是完成了吗？** 不是，REQ 未 `released` 只能算步骤完成。
- **接口报错怎么排查？** 先 GET 查证实体是否存在、凭证主机是否正确，不要猜 ID。

## It's working if

- 问「REQ-XXXX 现在什么状态」时，它给出带字段名与时间戳的真实数据，而不是复述对话
- 更新任务状态前先查一次实体，写入后回读确认
- 遇到 404/401 时给的是排查步骤与真实查询结果，不是编造的 ID