@alphalawyer/alpha-classic-cli 0.1.3 → 0.1.5

package/README.md

@@ -64,8 +64,38 @@ alpha-classic-cli login
 alpha-classic-cli doctor
 alpha-classic-cli matter search --keyword 合同 --limit 10
 alpha-classic-cli matter search --status 进行中+预立项 --scope 所有项目 --limit 10
+alpha-classic-cli matter types --keyword 诉讼 --limit 20
+alpha-classic-cli matter search --matter-type-ids <项目类型ID> --service-start-from 2026-01-01 --service-start-to 2026-12-31 --limit 10
 alpha-classic-cli matter detail --id <项目ID> --logs 5
-alpha-classic-cli matter task --id <项目ID> --state 未完成 --limit 20
+alpha-classic-cli task list --matter-id <项目ID> --state 未完成 --limit 20
+alpha-classic-cli task mine --keyword <关键词> --state 未完成 --limit 20
+alpha-classic-cli task mine --range-from 2026-06-01 --range-to 2026-06-30 --state all --limit 20
+alpha-classic-cli task pending --range this-week --state 未完成 --order-direction asc --limit 50
+alpha-classic-cli task worktypes --matter-id <项目ID>
+alpha-classic-cli task assignees --matter-id <项目ID>
+alpha-classic-cli task assignees --matter-id <项目ID> --work-type-id <工作类型ID>
+alpha-classic-cli task create --name <任务名称> --matter-id <项目ID> --due-time 2026-06-30
+alpha-classic-cli task detail --id <任务ID> --comments 10
+alpha-classic-cli task subtasks --id <任务ID> --state all --limit 20
+alpha-classic-cli task update-detail --id <任务ID> --detail <任务详情>
+alpha-classic-cli task complete --id <任务ID>
+alpha-classic-cli task uncomplete --id <任务ID>
+alpha-classic-cli task assignee set --id <任务ID> --user-ids <用户ID1,用户ID2>
+alpha-classic-cli task comment add --task-id <任务ID> --content <评论内容>
+alpha-classic-cli task comment delete --id <评论ID>
+alpha-classic-cli task checkitem add --task-id <任务ID> --item <检查项内容>
+alpha-classic-cli task checkitem delete --id <检查项ID> --task-id <任务ID>
+alpha-classic-cli task checkitem complete --id <检查项ID> --task-id <任务ID>
+alpha-classic-cli task checkitem uncomplete --id <检查项ID> --task-id <任务ID>
+alpha-classic-cli timing list --range this-month --approve-state all --limit 50
+alpha-classic-cli timing matters --keyword 合同 --limit 20
+alpha-classic-cli timing worktypes --matter-id <项目ID> --limit 50
+alpha-classic-cli timing tasks --matter-id <项目ID> --keyword <关键词> --limit 20
+alpha-classic-cli timing create --name <工作描述> --work-date 2026-06-12 --start-time 09:00 --end-time 10:30 --matter-id <项目ID> --work-type-id <工作类型ID>
+alpha-classic-cli user list --status 在职 --account-type A,B --phone <手机号> --keyword <姓名或用户名> --limit 20
+alpha-classic-cli user ranks --keyword <职级名> --limit 20
+alpha-classic-cli user managers --keyword <姓名或用户名> --limit 20
+alpha-classic-cli user departments --keyword <部门名> --limit 20
 alpha-classic-cli appro list --scope my --limit 10
 alpha-classic-cli appro initiators --keyword 张三
 alpha-classic-cli appro detail --id <审批ID>
@@ -118,7 +148,7 @@ alpha-classic-cli install
 默认安装 Codex Skill：
 
 ```text
-~/.codex/skills/alpha-classic-cli/SKILL.md
+~/.codex/skills/alpha-classic/SKILL.md
 ```
 
 用户也可以选择安装目标：
@@ -139,10 +169,12 @@ alpha-classic-cli uninstall --agent alphaclaw
 alpha-classic-cli uninstall --agent all
 ```
 
-Alpha-claw 安装方式会跟随 CLI 构建环境，例如 dev 构建安装到：
+Alpha-claw 安装方式会写入所有已经存在的 AlphaClaw workspace，不会主动创建未安装的环境目录：
 
 ```text
-~/.openclaw-devalphaclaw/workspace/skills/alpha-classic-cli/SKILL.md
+~/.openclaw-devalphaclaw/workspace/skills/alpha-classic/SKILL.md
+~/.openclaw-testalphaclaw/workspace/skills/alpha-classic/SKILL.md
+~/.openclaw-alphaclaw/workspace/skills/alpha-classic/SKILL.md
 ```
 
 Claude Code 安装方式：
@@ -170,8 +202,26 @@ alpha-classic-cli doctor
 alpha-classic-cli login
 alpha-classic-cli version
 alpha-classic-cli matter search --keyword 合同 --limit 10
+alpha-classic-cli matter types --keyword 诉讼 --limit 20
 alpha-classic-cli matter detail --id <项目ID> --logs 5
-alpha-classic-cli matter task --id <项目ID> --state 未完成 --limit 20
+alpha-classic-cli task list --matter-id <项目ID> --state 未完成 --limit 20
+alpha-classic-cli task mine --keyword <关键词> --state 未完成 --limit 20
+alpha-classic-cli task mine --range-from 2026-06-01 --range-to 2026-06-30 --state all --limit 20
+alpha-classic-cli task pending --range this-week --state 未完成 --order-direction asc --limit 50
+alpha-classic-cli task detail --id <任务ID> --comments 10
+alpha-classic-cli task subtasks --id <任务ID> --state all --limit 20
+alpha-classic-cli timing list --range this-month --approve-state all --limit 50
+alpha-classic-cli timing create --name <工作描述> --work-date 2026-06-12 --start-time 09:00 --end-time 10:30
+alpha-classic-cli finance overview
+alpha-classic-cli finance departments --keyword <部门名> --limit 20
+alpha-classic-cli finance summary --matter-id <项目ID>
+alpha-classic-cli finance contract list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance invoice list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance income list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance expense list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance bill list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance reimburse list --matter-id <项目ID> --limit 20
+alpha-classic-cli user list --status 在职 --keyword <姓名或用户名> --limit 20
 ```
 
 ## 通用智能体对接
@@ -207,6 +257,13 @@ alpha-classic-cli capabilities
 - `GET /document-engine/api/v1/dir/list`
 - `GET /taskserver/api/v2/timing/timing/task/{taskId}`
 - `GET /ilaw/api/v2/comment/queryCommentsAndDynamic`
+- `GET /finance/api/integration/v1/statistics/matterOverview/{matterId}`
+- `GET /finance/api/integration/v1/matterFinance/contracts/{matterId}`
+- `GET /finance/api/integration/v1/matterFinance/invoices/Children/{matterId}`
+- `GET /finance/api/integration/v1/matterFinance/incomes/{matterId}`
+- `GET /finance/api/integration/v1/matterFinance/spends/{matterId}`
+- `GET /finance/api/integration/v1/matterFinance/bills/{matterId}`
+- `GET /finance/api/integration/v1/matterFinance/reimburse/{matterId}`
 - `POST /appro/api/v2/approval/search`
 - `GET /appro/api/v2/appros/{approId}`
 - `GET /common/api/v1/file/batch`
@@ -222,7 +279,7 @@ alpha-classic-cli capabilities
 ## 设计原则
 
 - 默认输出 JSON envelope，方便 AI 解析。
-- 只支持查询，不执行写操作。
+- 默认只支持查询；新建任务、任务详情、任务完成/取消完成、负责人、评论、检查项和新增计时写操作必须使用明确的 `task create`、`task update-detail`、`task complete`、`task uncomplete`/`task restart`、`task assignee set`/`task attendee set`、`task comment ...`、`task checkitem ...`、`timing create` 命令。
 - 不在终端输出 token。
 - 运行时只允许切换内置环境预设，不接受任意 baseUrl/apiBaseUrl 参数。
 - Skill 负责告诉 AI 什么时候用哪个命令。

package/assets/alpha-classic-skill/SKILL.md

@@ -1,20 +1,20 @@
 ---
-name: alpha-classic-cli
-description: 使用 alpha-classic-cli 查询 Alpha 律所管理系统里的项目、审批等数据。先运行 doctor，优先使用稳定 CLI 命令，不自行猜 REST API。
+name: alpha-classic
+description: 使用 alpha-classic-cli 查询 Alpha 律所管理系统里的项目、任务/日程、计时、财务、审批、人力资源成员等数据。先运行 doctor，优先使用稳定 CLI 命令，不自行猜 REST API。
 ---
 
 # Alpha Classic CLI 助手
 
-当用户询问 Alpha 律所管理系统里的项目、审批等数据时，优先使用 `alpha-classic-cli`。
+当用户询问 Alpha 律所管理系统里的项目、任务/日程、计时、财务、审批、人力资源成员等数据时，优先使用 `alpha-classic-cli`。
 
-如果用户同时安装了 `e-alpha-cli` 项目的 `agent-assistant` skill 和本项目的 `alpha-classic-cli` skill，必须优先使用 `agent-assistant` 及其通过 `alpha-cli skills update` 拉取的服务端动态 skills；只有在这些 skills 不适用、不可用或明确缺少所需能力时，才使用本项目 skill。
+如果用户同时安装了 `e-alpha-cli` 项目的 `alpha-oa` skill 和本项目的 `alpha-classic` skill，必须优先使用 `alpha-oa` 及其通过 `alpha-cli skills update` 拉取的服务端动态 skills；只有在这些 skills 不适用、不可用或明确缺少所需能力时，才使用本项目 skill。
 
 ## 使用顺序
 
 1. 先运行 `alpha-classic-cli doctor` 检查登录状态和环境。
 2. 如果未登录，默认让用户执行 `alpha-classic-cli login`。
 3. 不确定支持哪些能力时运行 `alpha-classic-cli capabilities`。
-4. 根据业务领域读取 `references/*.md`，项目相关读取 `references/alpha-classic-matter.md`，审批相关读取 `references/alpha-classic-appro.md`。
+4. 根据业务领域读取 `references/*.md`：项目相关读取 `references/alpha-classic-matter.md`，任务/日程/待办/安排相关读取 `references/alpha-classic-task.md`，计时相关读取 `references/alpha-classic-timing.md`，财务/合同/发票/收款/费用/账单/报销相关读取 `references/alpha-classic-finance.md`，审批相关读取 `references/alpha-classic-appro.md`，人力资源/成员/用户相关读取 `references/alpha-classic-user.md`。
 5. 优先使用明确的业务命令，不要自行拼 REST API。
 
 ## Agent 异步登录
@@ -43,8 +43,47 @@ alpha-classic-cli version
 alpha-classic-cli env current
 alpha-classic-cli matter search --keyword <关键词> --limit 10
 alpha-classic-cli matter search --status 进行中+预立项 --scope 所有项目 --limit 10
+alpha-classic-cli matter types --keyword <关键词> --limit 20
+alpha-classic-cli matter search --matter-type-ids <项目类型ID1,项目类型ID2> --service-start-from 2026-01-01 --service-start-to 2026-12-31 --service-end-from 2026-01-01 --service-end-to 2026-12-31 --limit 10
 alpha-classic-cli matter detail --id <项目ID> --logs 5
-alpha-classic-cli matter task --id <项目ID> --state 未完成 --limit 20
+alpha-classic-cli task list --matter-id <项目ID> --state 未完成 --limit 20
+alpha-classic-cli task mine --keyword <关键词> --state 未完成 --limit 20
+alpha-classic-cli task mine --range-from 2026-06-01 --range-to 2026-06-30 --state all --limit 20
+alpha-classic-cli task pending --range this-week --state 未完成 --order-direction asc --limit 50
+alpha-classic-cli task worktypes --matter-id <项目ID>
+alpha-classic-cli task assignees --matter-id <项目ID>
+alpha-classic-cli task assignees --matter-id <项目ID> --work-type-id <工作类型ID>
+alpha-classic-cli task create --name <任务名称> --matter-id <项目ID> --due-time 2026-06-30
+alpha-classic-cli task detail --id <任务ID> --comments 10
+alpha-classic-cli task subtasks --id <任务ID> --state all --limit 20
+alpha-classic-cli task update-detail --id <任务ID> --detail <任务详情>
+alpha-classic-cli task complete --id <任务ID>
+alpha-classic-cli task uncomplete --id <任务ID>
+alpha-classic-cli task assignee set --id <任务ID> --user-ids <用户ID1,用户ID2>
+alpha-classic-cli task comment add --task-id <任务ID> --content <评论内容>
+alpha-classic-cli task comment delete --id <评论ID>
+alpha-classic-cli task checkitem add --task-id <任务ID> --item <检查项内容>
+alpha-classic-cli task checkitem delete --id <检查项ID> --task-id <任务ID>
+alpha-classic-cli task checkitem complete --id <检查项ID> --task-id <任务ID>
+alpha-classic-cli task checkitem uncomplete --id <检查项ID> --task-id <任务ID>
+alpha-classic-cli timing list --range this-month --approve-state all --limit 50
+alpha-classic-cli timing matters --keyword <关键词> --limit 20
+alpha-classic-cli timing worktypes --matter-id <项目ID> --limit 50
+alpha-classic-cli timing tasks --matter-id <项目ID> --keyword <关键词> --limit 20
+alpha-classic-cli timing create --name <工作描述> --work-date 2026-06-12 --start-time 09:00 --end-time 10:30 --matter-id <项目ID> --work-type-id <工作类型ID>
+alpha-classic-cli finance overview
+alpha-classic-cli finance departments --keyword <部门名> --limit 20
+alpha-classic-cli finance summary --matter-id <项目ID>
+alpha-classic-cli finance contract list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance invoice list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance income list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance expense list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance bill list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance reimburse list --matter-id <项目ID> --limit 20
+alpha-classic-cli user list --status 在职 --account-type A,B --phone <手机号> --keyword <姓名或用户名> --limit 20
+alpha-classic-cli user ranks --keyword <职级名> --limit 20
+alpha-classic-cli user managers --keyword <姓名或用户名> --limit 20
+alpha-classic-cli user departments --keyword <部门名> --limit 20
 alpha-classic-cli appro list --scope my --limit 10
 alpha-classic-cli appro detail --id <审批ID>
 ```
@@ -53,7 +92,7 @@ alpha-classic-cli appro detail --id <审批ID>
 
 - 输出默认是 JSON envelope，先看 `ok` 判断是否成功。
 - 遇到 `ok: false` 时，先看 `error.hint`。
-- 只做查询，不执行写操作。
+- 默认只做查询；新建任务、任务详情、任务完成/取消完成、负责人、评论、检查项和新增计时写操作只能使用明确的 `task create`、`task update-detail`、`task complete`、`task uncomplete`/`task restart`、`task assignee set`/`task attendee set`、`task comment ...`、`task checkitem ...`、`timing create` 命令。财务模块当前只允许查询列表、详情和汇总。
 - 不要输出 token 或 refreshToken。
 - 不要猜测不存在的字段、接口或命令。
 - 业务数据优先使用 CLI 清洗后的中文字段，不要反推或暴露后端原始字段。

package/assets/alpha-classic-skill/references/alpha-classic-finance.md

@@ -0,0 +1,132 @@
+# Alpha Classic 财务命令
+
+用于 Alpha 项目-财务页和顶级财务模块中的财务数据查询。当前只开放读取能力，不执行新增、编辑、删除、结算等写操作。
+
+## 口语映射
+
+- 用户说“营收”“收入”“已收款”“已收款金额”时，按 `收款总额` / 已收款金额理解，优先看 `finance summary` 的 `收款总额`，需要明细时查 `finance income list`。
+- 用户说“应收款”“应收金额”“合同金额”时，按 `合同总额` / 合同金额理解，优先看 `finance summary` 的 `合同总额`，需要明细时查 `finance contract list`。
+- `finance summary` 里输出的 `应收总额` 是项目财务页的系统字段，和上面的口语“应收款=合同金额”不是同一表达；回答用户自然语言问题时优先按口语映射解释。
+
+## 律所财务总览
+
+```bash
+alpha-classic-cli finance overview
+alpha-classic-cli finance overview --department-id <所属团队ID> --date 2026-06
+alpha-classic-cli finance departments --keyword <部门名> --limit 20
+```
+
+`finance departments` 对齐前端 `istrationAssetsService.getDepartmentList()`，底层使用 `GET /ilaw/api/v2/permission/department/allDepartment`，用于获取 `finance overview --department-id`。
+
+`finance overview` 对齐顶级财务模块的“总览”页，也就是律所财务总览，不是某个项目下的财务汇总。默认查询“所属团队：全部”，传 `--department-id` 时按页面“所属团队”筛选。`--date` 控制收入走势图月份，支持 `YYYY-MM` 或 `YYYY-MM-DD`，CLI 会转成前端格式 `YYYY-MM-01 00:00:00`；不传时默认当前月份。
+
+底层接口：
+
+- 主数据：`GET /finance/api/integration/v1/summary/total`
+- 所属团队：`GET /ilaw/api/v2/permission/department/allDepartment`
+- 收入走势图：`GET /finance/api/integration/v1/summary/trend`
+- 提醒信息：`GET /finance/api/integration/v1/finance/overview/reminds`
+
+输出包括：
+
+- 金额指标：应收款金额、未分配金额、费用总额、今日收款、未认领金额、今日开票金额、已入账总额、未入账总额。
+- 关键节点：未认领款项、未分配完成项目数、报销待结算项、应收款合同数、未盖章合同数、未归档合同数、待开发票数量、待领取发票数。
+- 收入走势图：近 6 个月收款总额，单位万元。
+- 财务模块链接：总览、合同、发票、收款、账单、费用、报销的浏览器路由。
+- 指标说明：对齐前端总览页每个金额卡的 tooltip 口径。
+
+## 项目财务汇总
+
+```bash
+alpha-classic-cli finance summary --matter-id <项目ID>
+```
+
+`finance summary` 底层使用 `GET /finance/api/integration/v1/statistics/matterOverview/{matterId}`，输出：
+
+- 合同总额
+- 发票总额
+- 收款总额
+- 标的总额
+- 账单总额
+- 费用总额
+- 应收总额
+- 应收总额计算方式
+
+应收总额的计算方式由项目财务设置决定，前端支持三种口径：
+
+- 已开票金额 - 已收金额
+- 合同金额 - 已收金额
+- 账单总和 - 已收金额
+
+项目财务汇总会输出 `页面链接` 和 `项目链接`，可以直接进入项目-财务页或项目概览/任务页。
+
+## 项目-财务列表
+
+传 `--matter-id` 时，列表命令对齐前端项目详情页里的“财务”tab。
+
+```bash
+alpha-classic-cli finance contract list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance invoice list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance income list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance expense list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance bill list --matter-id <项目ID> --limit 20
+alpha-classic-cli finance reimburse list --matter-id <项目ID> --limit 20
+```
+
+项目-财务页接口：
+
+- 合同：`GET /finance/api/integration/v1/matterFinance/contracts/{matterId}`
+- 发票：`GET /finance/api/integration/v1/matterFinance/invoices/Children/{matterId}`
+- 收款：`GET /finance/api/integration/v1/matterFinance/incomes/{matterId}`
+- 费用：`GET /finance/api/integration/v1/matterFinance/spends/{matterId}`
+- 账单：`GET /finance/api/integration/v1/matterFinance/bills/{matterId}`
+- 报销：`GET /finance/api/integration/v1/matterFinance/reimburse/{matterId}`
+
+这些接口本身不分页，CLI 会在本地按 `--page/--limit` 截取。
+项目-财务列表会输出 `项目财务页`，可直接给用户点击进入对应项目的财务 tab。
+
+## 财务模块列表
+
+不传 `--matter-id` 时，列表命令对齐顶级“财务”模块。
+
+```bash
+alpha-classic-cli finance contract list --keyword <关键词> --limit 20
+alpha-classic-cli finance invoice list --keyword <关键词> --type my --limit 20
+alpha-classic-cli finance income list --keyword <关键词> --limit 20
+alpha-classic-cli finance expense list --keyword <关键词> --limit 20
+alpha-classic-cli finance bill list --keyword <关键词> --limit 20
+alpha-classic-cli finance reimburse list --type all --limit 20
+alpha-classic-cli finance reimburse list --type settlement --limit 20
+```
+
+支持参数：
+
+- `--keyword`：关键词。
+- `--status`：状态筛选，直接传给对应财务列表接口。
+- `--page`：页码，从 1 开始。
+- `--limit`：每页数量，默认 20，最大 100。
+- `--type`：发票列表支持 `my`（发票申请列表，默认）、`open`（财务开票）、`manage`（发票管理）；报销列表支持 `all`/`myReimburse`（报销申请列表，默认）和 `settlement`（报销结算）。
+
+## 详情
+
+```bash
+alpha-classic-cli finance contract detail --id <合同ID>
+alpha-classic-cli finance invoice detail --id <发票ID>
+alpha-classic-cli finance income detail --id <收款ID>
+alpha-classic-cli finance expense detail --id <费用ID>
+alpha-classic-cli finance bill detail --id <账单ID>
+alpha-classic-cli finance reimburse detail --id <报销ID>
+```
+
+详情命令使用对应详情接口：
+
+- 合同：`GET /finance/api/integration/v1/contracts/{id}`
+- 发票：`GET /finance/api/integration/v2/invoices/{id}`
+- 收款：`GET /finance/api/integration/v1/incomes/{id}`
+- 费用：`GET /finance/api/integration/v1/spend/{id}`
+- 账单：`GET /finance/api/integration/v1/bills/{id}`
+- 报销：`GET /finance/api/integration/v1/reimburse/{id}`
+
+## 展示规则
+
+给用户展示财务列表时，默认隐藏内部 ID；保留名称、编号、金额、状态、日期、项目名称等人能直接理解的字段。需要继续查详情时，agent 可以使用列表 JSON 中的 ID 调用详情命令。

package/assets/alpha-classic-skill/references/alpha-classic-matter.md

@@ -1,6 +1,8 @@
 # Matter
 
-用户询问项目、案件、matter、项目列表、项目状态、项目客户、项目动态、项目计时、项目任务等信息时使用本规则。
+用户询问项目、案件、matter、项目列表、项目状态、项目客户、项目动态、项目类型、服务开始时间、服务结束时间等信息时使用本规则。
+
+任务/日程相关问题读取 `references/alpha-classic-task.md`，计时相关问题读取 `references/alpha-classic-timing.md`。按项目 ID 查看项目下任务或项目日程时仍然使用顶级任务命令 `alpha-classic-cli task list --matter-id <项目ID>`。
 
 ## 查询项目列表
 
@@ -30,65 +32,51 @@ alpha-classic-cli matter search --status 进行中 --scope 我关注的 --limit
 alpha-classic-cli matter search --status 全部 --scope 已加入的 --limit 10
 ```
 
-## 查询项目详情
-
-先通过项目列表拿到 `项目ID`，再查询详情：
+查询项目列表更多筛选里的项目类型：
 
 ```bash
-alpha-classic-cli matter detail --id <项目ID> --logs 5
+alpha-classic-cli matter types --keyword <关键词> --limit 20
 ```
 
-不需要最近动态时：
+按项目类型、服务开始时间或服务结束时间筛选项目：
 
 ```bash
-alpha-classic-cli matter detail --id <项目ID> --logs 0
+alpha-classic-cli matter search --matter-type-ids <项目类型ID1,项目类型ID2> --service-start-from 2026-01-01 --service-start-to 2026-12-31 --service-end-from 2026-01-01 --service-end-to 2026-12-31 --limit 10
 ```
 
-## 查询项目下任务列表
-
-项目详情页里的「任务」table 对应这个命令：
-
-```bash
-alpha-classic-cli matter task --id <项目ID>
-```
+## 查询项目详情
 
-默认查询未完成任务；如需全部任务或已完成任务可显式传状态：
+先通过项目列表拿到 `项目ID`，再查询详情：
 
 ```bash
-alpha-classic-cli matter task --id <项目ID> --state all
-alpha-classic-cli matter task --id <项目ID> --state 已完成
+alpha-classic-cli matter detail --id <项目ID> --logs 5
 ```
 
-## 查询任务详情
-
-先通过项目任务列表拿到 `任务ID`，再查询任务详情：
+不需要最近动态时：
 
 ```bash
-alpha-classic-cli matter task-detail --id <任务ID> --comments 10
+alpha-classic-cli matter detail --id <项目ID> --logs 0
 ```
 
-任务详情会读取任务概览、检查项、附件、计时和任务动态。附件会根据 `repoId`、`filePath` 联动 `/document-engine/api/v1/dir/list` 获取文件详情，但对外只展示 `文件名` 和 `大小`。`--comments` 默认 10，传 0 可跳过任务动态。
+项目列表和项目详情会输出 `项目链接`，包含可直接在浏览器打开的 `项目概览`、`项目财务`、`项目任务`。前端路由形如 `/#/app/matter/find/{matterId}/U/statusV2`、`/#/app/matter/find/{matterId}/U/financeV2`、`/#/app/matter/find/{matterId}/U/task`；如果接口返回了其他 permission，CLI 会使用返回值，否则默认 `U`。
 
 ## 参数规则
 
-- `--keyword` 可选；用户没有提供项目名或关键词时可以省略。
+- `matter search --keyword` 可选；用户没有提供项目名或关键词时可以省略。
 - `matter search --status` 可选，默认 `进行中+预立项`；支持 `预立项`、`进行中`、`进行中+预立项`、`已完结`、`已搁置`、`已归档`、`全部`。
 - `matter search --scope` 可选，默认 `所有项目`；支持 `所有项目`、`我关注的`、`已加入的`。
+- `matter types` 查询项目列表更多筛选里的项目类型树，底层使用 `GET /matterserver/api/v2/matters/matterType/listTree`，对齐前端 `MatterService.getMatterTypeList({})`。
+- `matter search --matter-type-ids` 可选，传 `matter types` 返回的 `项目类型ID`，多个用英文逗号分隔；对应请求体 `subMatterTypes`。
+- 项目类型有大类和子类型层级；`matter search --matter-type-ids` 传的是 `matter types` 返回的类型 ID。用户说项目类型简称时先做口语归一，例如“常法”指“常年顾问”这个项目类型；应先用 `alpha-classic-cli matter types --keyword 常年顾问` 查到对应 ID，再传给 `matter search --matter-type-ids`。
+- `matter search --service-start-from/--service-start-to` 可选，筛选服务开始时间；对应请求体 `serviceStartRangeTime.startTime/endTime`。
+- `matter search --service-end-from/--service-end-to` 可选，筛选服务结束时间；对应请求体 `serviceEndRangeTime.startTime/endTime`。
+- 项目类型和服务时间这些更多筛选只用于 `--scope 所有项目` 或 `--scope 已加入的`；`--scope 我关注的` 为了对齐前端，只传 `isView=true`、`matchedName`、`queryOrderPage`。
 - `--limit` 可选，默认 10，最大 50。
 - `--page` 可选，从 1 开始。
 - `matter detail --id` 必填，通常来自 `matter search` 返回的 `项目ID`。
 - `matter detail --logs` 可选，默认 5，最大 20；传 0 跳过最近动态。
-- `matter task --id` 必填，通常来自 `matter detail` 或 `matter search` 返回的 `项目ID`。
-- `matter task --state` 可选，默认 `未完成`；支持 `all`、`未完成`、`已完成`。
-- `matter task --limit` 可选，默认 20，最大 50。
-- `matter task --type` 可选，默认 `task`；支持 `task`、`group`。
-- `matter task --attention` 可选，默认 `all`；支持 `all`、`我关注的`。
-- `matter task-detail --id` 必填，通常来自 `matter task` 返回的 `任务ID`。
-- `matter task-detail --comments` 可选，默认 10，最大 50；传 0 跳过任务动态。
 - `project` 是 `matter` 的别名，但回答和示例优先使用 `matter`。
 
-## 输出字段
-
 ## 项目列表筛选映射
 
 项目状态通过请求体里的 `matterStatusSet` 传给后端：
@@ -119,149 +107,22 @@ alpha-classic-cli matter search --status 进行中+预立项 --scope 所有项
 
 注意：`--scope 我关注的` 对应前端“我关注的”tab。前端会过滤掉状态和高级筛选，所以 CLI 也不传 `matterStatusSet`；即使用户同时传了 `--status`，请求时也会按前端行为忽略状态筛选。
 
-成功响应读取 `data`：
-
-```json
-{
-  "ok": true,
-  "data": {
-    "项目状态": "进行中+预立项",
-    "项目范围": "所有项目",
-    "总数": 7,
-    "页码": 1,
-    "每页数量": 10,
-    "展示字段": ["项目名称", "项目状态", "项目客户", "项目类型", "立项时间", "项目编号"],
-    "项目状态统计": [
-      {
-        "状态": "进行中",
-        "状态码": 2,
-        "数量": 6
-      }
-    ],
-    "项目列表": [
-      {
-        "项目ID": "...",
-        "项目名称": "...",
-        "项目状态": "进行中",
-        "项目客户": ["..."],
-        "项目类型": "...",
-        "立项时间": "...",
-        "项目编号": "..."
-      }
-    ]
-  }
-}
-```
+## 输出字段
 
-`项目列表` 的固定字段是 `项目名称`、`项目状态`、`项目客户`、`项目类型`，其余展示字段来自 `/matterserver/api/v1/customFields/dashboard/MATTER_LIST` 的 `selectedFields` 顺序。`项目ID` 即使不属于展示字段，也会保留在响应里供后续 `matter detail`、`matter task` 使用。
-
-项目任务列表成功响应读取 `data.任务列表`：
-
-```json
-{
-  "ok": true,
-  "data": {
-    "项目ID": "...",
-    "项目名称": "...",
-    "项目类型": "...",
-    "状态": "未完成",
-    "关注": "全部",
-    "类型": "任务",
-    "总数": 12,
-    "页码": 1,
-    "每页数量": 20,
-    "任务列表": [
-      {
-        "任务ID": "...",
-        "任务名称": "...",
-        "任务组": "...",
-        "状态": "未完成",
-        "负责人": ["..."],
-        "参与人": ["..."],
-        "到期时间": "...",
-        "检查项": {
-          "总数": 0,
-          "已完成": 0
-        },
-        "评论数": 0,
-        "附件数": 0,
-        "是否关注": false,
-        "时间类型": "到期时间",
-        "全天类型": "全天任务",
-        "工作类型": {
-          "工作类型ID": "...",
-          "工作类型名称": "..."
-        },
-        "重复规则": {
-          "规则ID": "...",
-          "重复规则": "...",
-          "自定义规则": "...",
-          "日期索引": [],
-          "结束类型": "...",
-          "结束日期": "...",
-          "结束次数": 0
-        }
-      }
-    ]
-  }
-}
-```
+成功响应读取 `data`。`项目列表` 的固定字段是 `项目名称`、`项目状态`、`项目客户`、`项目类型`、`项目链接`，其余展示字段来自 `/matterserver/api/v1/customFields/dashboard/MATTER_LIST` 的 `selectedFields` 顺序。`项目ID` 即使不属于展示字段，也会保留在响应里供后续 `matter detail`、`task list` 使用。
 
-项目详情成功响应读取 `data.项目概览` 和 `data.最近动态`：
-
-```json
-{
-  "ok": true,
-  "data": {
-    "项目概览": {
-      "项目ID": "...",
-      "项目名称": "...",
-      "项目编号": "...",
-      "项目状态": "进行中",
-      "项目类型": "...",
-      "项目等级": "中",
-      "客户": ["..."],
-      "其他当事人": ["..."],
-      "所属": "...",
-      "案源律师": ["..."],
-      "承办律师": ["..."],
-      "主办律师": ["..."],
-      "协办律师": ["..."],
-      "项目成员": ["..."],
-      "案由": "...",
-      "代理审级": "...",
-      "服务内容": "...",
-      "开始日期": "...",
-      "结束日期": "...",
-      "立项时间": "...",
-      "结项时间": "...",
-      "归档日期": "...",
-      "归档编号": "...",
-      "项目详情": "..."
-    },
-    "最近动态": [
-      {
-        "动态ID": "...",
-        "类型": "...",
-        "时间": "...",
-        "内容": "..."
-      }
-    ]
-  }
-}
-```
+项目详情成功响应读取 `data.项目概览` 和 `data.最近动态`。常用字段包括 `项目名称`、`项目编号`、`项目状态`、`项目类型`、`客户`、`其他当事人`、`所属`、`案源律师`、`承办律师`、`主办律师`、`协办律师`、`项目成员`、`案由`、`服务内容`、`开始日期`、`结束日期`、`立项时间`、`结项时间`、`归档日期`、`归档编号`、`项目详情`。
 
 ## 处理规则
 
 - 用户问“有哪些项目”“查项目列表”时，如果没有关键词，可以直接查询默认列表。
 - 用户给出项目名、客户名、编号片段等自然语言线索时，作为 `--keyword`。
+- 用户用项目类型筛选时，先通过 `matter types` 解析项目类型 ID；如果用户说“常法项目”“常法类型”，按“常年顾问”项目类型理解。
 - 用户问“项目详情”“项目概览”“这个项目的基本信息”时，优先使用 `matter detail`；如果没有项目ID，先用 `matter search` 找候选项目。
-- 用户问“项目下任务”“这个项目的任务表”“任务 table”时，使用 `alpha-classic-cli matter task --id <项目ID>`。
-- 用户没有特别说明状态时，默认看 `未完成` 任务。
-- 给最终用户展示项目列表、项目详情或项目任务时，默认隐藏 `项目ID`、`任务ID`、`工作类型ID`、`规则ID` 等内部 ID；这些字段只留给 agent 后续调用 `matter detail`、`matter task` 等命令使用。只有用户明确要求查看 ID、编号或需要定位详情时才展示。
+- 用户问“项目下任务”“项目日程”“这个项目的任务表”“任务 table”时，读取 `references/alpha-classic-task.md` 后使用 `alpha-classic-cli task list --matter-id <项目ID>`。
+- 给最终用户展示项目列表或项目详情时，默认隐藏 `项目ID`、`任务ID`、`工作类型ID`、`规则ID` 等内部 ID；这些字段只留给 agent 后续调用。只有用户明确要求查看 ID、编号或需要定位详情时才展示。
 - `项目编号` 是业务编号，可以正常展示；不要把它和内部 `项目ID` 混为一谈。
 - 回答项目列表时优先摘要 `项目名称`、`项目编号`、`项目客户`、`项目状态统计`、`最新动态`。
 - 回答项目详情时优先摘要 `项目名称`、`项目编号`、`项目状态`、`客户`、`承办律师`、`项目成员`、`立项时间`、`最近动态`。
-- 回答项目任务时优先摘要 `任务名称`、`任务组`、`状态`、`负责人`、`参与人`、`到期时间`、`检查项`、`评论数`、`附件数`。
 - 如果结果为空，说明没有查到，不要编造项目。
-- 不要调用项目写操作。当前只支持查询。
+- 除 capabilities 明确声明的写操作外，不要调用项目写接口。

package/assets/alpha-classic-skill/references/alpha-classic-shared.md

@@ -2,8 +2,8 @@
 
 ## Skill 优先级
 
-- 如果用户同时安装了 `e-alpha-cli` 项目的 `agent-assistant` skill 和本项目的 `alpha-classic-cli` skill，优先使用 `agent-assistant` 及其通过 `alpha-cli skills update` 拉取的服务端动态 skills。
-- 只有在 `agent-assistant` 及服务端动态 skills 不适用、不可用或明确缺少所需能力时，才使用本项目 skill。
+- 如果用户同时安装了 `e-alpha-cli` 项目的 `alpha-oa` skill 和本项目的 `alpha-classic` skill，优先使用 `alpha-oa` 及其通过 `alpha-cli skills update` 拉取的服务端动态 skills。
+- 只有在 `alpha-oa` 及服务端动态 skills 不适用、不可用或明确缺少所需能力时，才使用本项目 skill。
 
 ## 登录与环境