Skip to content

Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/dingtalk-skills/dws

【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/智能合同/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/HTML文件/AI听记/邮箱/在线电子表格(axls)/知识库/白板/开放平台文档/个人IM与OA事件订阅。用户要求操作上述钉钉产品时使用。

FileKindSize
LICENSEother9.9 KB
NOTICEother666 B
SKILL.mdskill md38.4 KB
references/best_practices/01-messaging.mdmarkdown3.2 KB
references/best_practices/02-task.mdmarkdown2.8 KB
references/best_practices/03-meeting.mdmarkdown11.6 KB
references/best_practices/04-document.mdmarkdown11.0 KB
references/best_practices/05-reporting.mdmarkdown6.2 KB
references/best_practices/06-data-analytics.mdmarkdown5.4 KB
references/best_practices/07-minutes.mdmarkdown8.3 KB
references/best_practices/08-directory.mdmarkdown8.0 KB
references/best_practices/09-mail.mdmarkdown5.2 KB
references/best_practices/10-minutes-speaker-match.mdmarkdown9.0 KB
references/best_practices/11-minutes-speaker-correct.mdmarkdown4.4 KB
references/best_practices/_common/conventions.mdmarkdown3.4 KB
references/best_practices/_common/recipe-conventions.mdmarkdown1.8 KB
references/best_practices/lite-recipes.mdmarkdown15.7 KB
references/capability-limits.mdmarkdown2.9 KB
references/error-codes.mdmarkdown4.0 KB
references/field-rules.mdmarkdown5.4 KB
references/global-reference.mdmarkdown5.1 KB
references/intent-guide.mdmarkdown47.8 KB
references/products/agoal.mdmarkdown12.1 KB
references/products/aisearch.mdmarkdown14.1 KB
references/products/aitable-record-ops.mdmarkdown4.8 KB
references/products/aitable.mdmarkdown30.1 KB
references/products/aitable/aitable-advperm.mdmarkdown10.2 KB
references/products/aitable/aitable-api-key.mdmarkdown1.7 KB
references/products/aitable/aitable-attachment.mdmarkdown3.5 KB
references/products/aitable/aitable-best-practices.mdmarkdown3.5 KB
references/products/aitable/aitable-cell-value.mdmarkdown9.1 KB
references/products/aitable/aitable-comment.mdmarkdown2.8 KB
references/products/aitable/aitable-dashboard-chart.mdmarkdown4.5 KB
references/products/aitable/aitable-data-analysis-sop.mdmarkdown5.6 KB
references/products/aitable/aitable-error-recovery.mdmarkdown6.9 KB
references/products/aitable/aitable-export-import.mdmarkdown9.8 KB
references/products/aitable/aitable-field-properties.mdmarkdown8.5 KB
references/products/aitable/aitable-field.mdmarkdown6.6 KB
references/products/aitable/aitable-filter-sort.mdmarkdown12.4 KB
references/products/aitable/aitable-form.mdmarkdown15.1 KB
references/products/aitable/aitable-formula-guide.mdmarkdown8.2 KB
references/products/aitable/aitable-primary-doc.mdmarkdown2.3 KB
references/products/aitable/aitable-psql.mdmarkdown14.7 KB
references/products/aitable/aitable-record-create.mdmarkdown2.2 KB
references/products/aitable/aitable-record-delete.mdmarkdown582 B
references/products/aitable/aitable-record-history.mdmarkdown4.0 KB
references/products/aitable/aitable-record-name-key.mdmarkdown2.4 KB
references/products/aitable/aitable-record-query.mdmarkdown15.0 KB
references/products/aitable/aitable-record-share.mdmarkdown1.6 KB
references/products/aitable/aitable-record-stats.mdmarkdown3.8 KB
references/products/aitable/aitable-record-update.mdmarkdown3.2 KB
references/products/aitable/aitable-record-upsert.mdmarkdown3.3 KB
references/products/aitable/aitable-view-config.mdmarkdown11.8 KB
references/products/aitable/aitable-view-extras.mdmarkdown8.0 KB
references/products/aitable/aitable-workflow.mdmarkdown14.4 KB
references/products/attendance-report.mdmarkdown29.9 KB
references/products/attendance-schedule.mdmarkdown27.5 KB
references/products/attendance-vacation.mdmarkdown9.4 KB
references/products/attendance.mdmarkdown102.0 KB
references/products/calendar.mdmarkdown50.3 KB
references/products/chat-emoji-list.mdmarkdown8.4 KB
references/products/chat.mdmarkdown158.3 KB
references/products/chat/a2ui.mdmarkdown4.2 KB
references/products/contact.mdmarkdown30.5 KB
references/products/contract.mdmarkdown15.2 KB
references/products/dev.mdmarkdown14.7 KB
references/products/devdoc.mdmarkdown1.8 KB
references/products/ding.mdmarkdown9.9 KB
references/products/dingtalk-tag/capability.mdmarkdown5.7 KB
references/products/dingtalk-tag/dingtalk-tag-index.mdmarkdown3.9 KB
references/products/dingtalk-tag/manage-and-connect.mdmarkdown8.2 KB
references/products/dingtalk-tag/manage.mdmarkdown9.7 KB
references/products/dingtalk-tag/run.mdmarkdown5.4 KB
references/products/doc.mdmarkdown65.2 KB
references/products/doc/doc-block.mdmarkdown14.6 KB
references/products/doc/doc-comment.mdmarkdown9.9 KB
references/products/doc/doc-create.mdmarkdown6.6 KB
references/products/doc/doc-export.mdmarkdown3.5 KB
references/products/doc/doc-file-ops.mdmarkdown9.4 KB
references/products/doc/doc-import.mdmarkdown2.8 KB
references/products/doc/doc-info.mdmarkdown9.9 KB
references/products/doc/doc-list.mdmarkdown1.3 KB
references/products/doc/doc-media.mdmarkdown4.7 KB
references/products/doc/doc-permission.mdmarkdown4.9 KB
references/products/doc/doc-read.mdmarkdown8.5 KB
references/products/doc/doc-search.mdmarkdown1.4 KB
references/products/doc/doc-update.mdmarkdown15.5 KB
references/products/doc/doc-whiteboard.mdmarkdown3.9 KB
references/products/doc/format/doc-jsonml-cookbook.mdmarkdown25.0 KB
references/products/doc/format/doc-jsonml-schema.jsonconfig16.5 KB
references/products/doc/format/doc-jsonml-schema.mdmarkdown29.1 KB
references/products/doc/style/doc-create-workflow.mdmarkdown23.1 KB
references/products/doc/style/doc-style-guideline.mdmarkdown21.1 KB
references/products/doc/style/doc-update-workflow.mdmarkdown16.4 KB
references/products/drive.mdmarkdown65.4 KB
references/products/drive/drive-export.mdmarkdown2.6 KB
references/products/drive/drive-storage.mdmarkdown2.1 KB
references/products/drive/drive-task.mdmarkdown2.4 KB
references/products/event.mdmarkdown29.7 KB
references/products/hrbrain.mdmarkdown7.5 KB
references/products/html.mdmarkdown6.4 KB
references/products/mail.mdmarkdown88.1 KB
references/products/markdown.mdmarkdown11.4 KB
references/products/minutes.mdmarkdown173.8 KB
references/products/oa-template-write.mdmarkdown8.1 KB
references/products/oa.mdmarkdown61.7 KB
references/products/oa/oa-form-components.mdmarkdown33.7 KB
references/products/oa/oa-goout.mdmarkdown7.5 KB
references/products/oa/oa-leave.mdmarkdown7.2 KB
references/products/oa/oa-overtime.mdmarkdown10.1 KB
references/products/oa/oa-process-nodes.mdmarkdown11.6 KB
references/products/oa/oa-supply.mdmarkdown6.2 KB
references/products/oa/template/components/AddressField.mdmarkdown718 B
references/products/oa/template/components/CalculateField.mdmarkdown2.0 KB
references/products/oa/template/components/CascadeField.mdmarkdown1.1 KB
references/products/oa/template/components/ColumnLayout.mdmarkdown746 B
references/products/oa/template/components/DDAttachment.mdmarkdown586 B
references/products/oa/template/components/DDDateField.mdmarkdown857 B
references/products/oa/template/components/DDDateRangeField.mdmarkdown1.6 KB
references/products/oa/template/components/DDMultiSelectField.mdmarkdown1.3 KB
references/products/oa/template/components/DDPhotoField.mdmarkdown699 B
references/products/oa/template/components/DDSelectField.mdmarkdown1.2 KB
references/products/oa/template/components/DepartmentField.mdmarkdown789 B
references/products/oa/template/components/ExternalContactField.mdmarkdown751 B
references/products/oa/template/components/FormRelateField.mdmarkdown2.1 KB
references/products/oa/template/components/IdCardField.mdmarkdown709 B
references/products/oa/template/components/InnerContactField.mdmarkdown819 B
references/products/oa/template/components/InvoiceField.mdmarkdown1.1 KB
references/products/oa/template/components/MoneyField.mdmarkdown811 B
references/products/oa/template/components/NumberField.mdmarkdown807 B
references/products/oa/template/components/OcrIdCardField.mdmarkdown1.7 KB
references/products/oa/template/components/OcrTextField.mdmarkdown900 B
references/products/oa/template/components/PhoneField.mdmarkdown760 B
references/products/oa/template/components/RecipientAccountField.mdmarkdown746 B
references/products/oa/template/components/RelateField.mdmarkdown804 B
references/products/oa/template/components/SeqNumberField.mdmarkdown1.1 KB
references/products/oa/template/components/SignatureField.mdmarkdown722 B
references/products/oa/template/components/StarRatingField.mdmarkdown774 B
references/products/oa/template/components/TableField.mdmarkdown1.2 KB
references/products/oa/template/components/TextField.mdmarkdown775 B
references/products/oa/template/components/TextNote.mdmarkdown675 B
references/products/oa/template/components/TextareaField.mdmarkdown754 B
references/products/oa/template/components/TimeAndLocationField.mdmarkdown719 B
references/products/oa/template/example/form_components.jsonconfig7.3 KB
references/products/oa/template/example/process_config.jsonconfig22.7 KB
references/products/oa/template/form-components.mdmarkdown11.5 KB
references/products/oa/template/nodes/approver.mdmarkdown3.7 KB
references/products/oa/template/nodes/cc.mdmarkdown2.6 KB
references/products/oa/template/nodes/condition.mdmarkdown10.8 KB
references/products/oa/template/nodes/handler.mdmarkdown2.4 KB
references/products/oa/template/nodes/originator.mdmarkdown941 B
references/products/oa/template/nodes/parallel.mdmarkdown2.7 KB
references/products/oa/template/nodes/payer.mdmarkdown1.6 KB
references/products/oa/template/process-nodes.mdmarkdown8.8 KB
references/products/oa/template/rules/target_approval.mdmarkdown3.3 KB
references/products/oa/template/rules/target_connect_approval.mdmarkdown3.2 KB
references/products/oa/template/rules/target_formcomponent_approval.mdmarkdown1.2 KB
references/products/oa/template/rules/target_formula_managerOfDept.mdmarkdown1.5 KB
references/products/oa/template/rules/target_formula_reportLineManager.mdmarkdown1.5 KB
references/products/oa/template/rules/target_label.mdmarkdown3.9 KB
references/products/oa/template/rules/target_management.mdmarkdown1.3 KB
references/products/oa/template/rules/target_managers_labels.mdmarkdown1.3 KB
references/products/oa/template/rules/target_matrix_approval.mdmarkdown2.4 KB
references/products/oa/template/rules/target_originator.mdmarkdown698 B
references/products/oa/template/rules/target_select.mdmarkdown1.6 KB
references/products/openapi-explorer.mdmarkdown3.9 KB
references/products/pat.mdmarkdown1.8 KB
references/products/report.mdmarkdown29.9 KB
references/products/sheet.mdmarkdown16.2 KB
references/products/sheet/sheet-batch-operations.mdmarkdown7.7 KB
references/products/sheet/sheet-chart.mdmarkdown3.9 KB
references/products/sheet/sheet-comment.mdmarkdown7.9 KB
references/products/sheet/sheet-conditional-format.mdmarkdown4.5 KB
references/products/sheet/sheet-dimension-operations.mdmarkdown3.7 KB
references/products/sheet/sheet-dropdown.mdmarkdown6.7 KB
references/products/sheet/sheet-export.mdmarkdown8.6 KB
references/products/sheet/sheet-filter-view.mdmarkdown3.7 KB
references/products/sheet/sheet-filter.mdmarkdown10.0 KB
references/products/sheet/sheet-formula.mdmarkdown10.0 KB
references/products/sheet/sheet-import.mdmarkdown2.6 KB
references/products/sheet/sheet-media-image.mdmarkdown13.9 KB
references/products/sheet/sheet-pivot-table.mdmarkdown12.6 KB
references/products/sheet/sheet-range-operations.mdmarkdown8.7 KB
references/products/sheet/sheet-read-data.mdmarkdown4.0 KB
references/products/sheet/sheet-revision-changeset.mdmarkdown3.2 KB
references/products/sheet/sheet-search-replace.mdmarkdown6.3 KB
references/products/sheet/sheet-style-format.mdmarkdown4.5 KB
references/products/sheet/sheet-version.mdmarkdown5.0 KB
references/products/sheet/sheet-workbook.mdmarkdown4.3 KB
references/products/sheet/sheet-write-data.mdmarkdown7.8 KB
references/products/simple.mdmarkdown2.6 KB
references/products/todo.mdmarkdown21.0 KB
references/products/whiteboard.mdmarkdown19.7 KB
references/products/whiteboard/compose.mdmarkdown5.7 KB
references/products/whiteboard/diff.mdmarkdown3.7 KB
references/products/whiteboard/open-nodes-v1.mdmarkdown4.0 KB
references/products/whiteboard/open-nodes-v1/01-overview.mdmarkdown3.3 KB
references/products/whiteboard/open-nodes-v1/02-query.mdmarkdown7.3 KB
references/products/whiteboard/open-nodes-v1/03-update.mdmarkdown8.6 KB
references/products/whiteboard/open-nodes-v1/04-text-style.mdmarkdown11.8 KB

references/products/contract.md

View on GitHub
# 智能合同命令参考

命令前缀统一为 `dws contract`。所有调用追加 `--format json`。命令树已发布到 Agent Schema;参数、约束或确认语义不确定时,优先读取精确 compact leaf Schema,仅在 Schema 不可用或与 Cobra 实际行为发生漂移时读取同一 leaf 的 `--help`。不要使用旧的 dingtalk 二级入口,不要直接调用 MCP、HTTP API 或自行猜测工具名。

## 能力范围与边界

Use when:用户要查询或创建合同台账、批量导入合同、按听记起草合同、归档合同,或管理合同项目、相对方与收付款账款。

Avoid when:

- 查询、同意、拒绝、转交或撤销已有合同 OA 审批实例走 `dws oa`,不要与合同审批模板 `process-templates` 混淆。
- 经营合约、目标、计分卡和 OKR 跟进走 `dws agoal`。
- 合同文件的搜索、上传、下载及钉盘元数据走 `dws drive`;合同台账和归档仍走 `dws contract`。
- AI 听记内容查询走 `dws minutes`;取得真实 `taskUuid` 后再调用 `dws contract draft`。
- 花名册中的劳动合同等员工基础字段走 `dws contact`。

## 意图路由

| 用户意图 | 命令族 |
|---|---|
| 查合同列表、详情、状态数量、创建台账 | `dws contract record ...` |
| 从钉盘模板批量导入合同、查导入结果 | `dws contract import ...` |
| 查审批模板或台账分类 | `dws contract process-templates` / `dws contract file-directories` |
| 根据 AI 听记和模板起草合同 | `dws contract draft` |
| 管理合同项目、导入导出项目 | `dws contract project ...` |
| 管理相对方、工商信息、风险、导入导出 | `dws contract subject ...` |
| 管理合同收付款账款 | `dws contract account ...` |
| 将合同文件归档 | `dws contract archive` |

## 执行规则

1. 先定位真实对象。更新、删除、导出、归档前,先通过对应 `list` / `get` / `detail` 获取真实 ID 和当前状态;禁止根据名称猜 ID。
2. 复杂请求只通过 `--file <json>` 或 `--file -` 传递。提交前检查 JSON 是对象,字段名、必填项和枚举符合本文及当前 leaf Schema;不要把整个请求 JSON 拼成未声明的 flags。
3. 时间单位不得混用:台账、项目及账款列表的筛选日期使用 ISO-8601;账款 JSON 的 `executionDate` 与归档 JSON 的 `archiveTime` 使用 Unix 毫秒时间戳。
4. 异步操作保存创建响应中的真实 `taskId`,再调用配套结果命令。结果未完成时只报告处理中;仅在返回明确可重试状态时轮询,并遵守服务端重试间隔。
5. 删除项目、相对方、账款以及归档等不可逆或高影响操作,在执行前说明对象和影响并获得用户确认;确认后才在 Runtime gate 要求时添加 `--yes`。
6. 创建或更新后优先使用详情查询回读。没有对应详情接口时,保留原始回执并明确说明未能独立回读验证。
7. 列表存在分页参数时按返回继续翻页,直到满足用户范围或服务端表明结束;不要把第一页当成完整结果。

## 标准流程

### 查询合同

1. 用 `record list` 按时间、状态或查询维度缩小范围。
2. 零结果直接说明;多候选先列出名称、状态和合同 ID,让用户消歧。
3. 需要完整字段时,用真实 `contractId` 调用 `record get`。

### 创建台账或归档

1. 查 `file-directories`、`process-templates` 或钉盘文件信息,取得真实目录、模板和文件 ID。
2. 按本文构造 JSON 文件,向用户确认提交对象与关键字段。
3. 创建使用 `record create`;归档使用 `archive`。执行后根据返回的真实 ID 回读或报告状态。

### 批量导入

1. 从模板命令或已有钉盘文件取得真实 `fileId` / `spaceId`。
2. 创建导入任务并保存真实 `taskId`。
3. 使用同一命令族的 `*-result` 查询结果,逐项报告成功、失败和处理中状态。

## 命令目录

- [台账](#台账)
- [批量导入](#批量导入)
- [基础资料](#基础资料)
- [合同起草](#合同起草)
- [项目管理](#项目管理)
- [相对方管理](#相对方管理)
- [账款管理](#账款管理)
- [合同归档](#合同归档)

## 台账

| 命令 | 必填参数 | 用途 |
|---|---|---|
| `dws contract record list` | 无 | 按创建时间、状态和查询维度筛选合同 |
| `dws contract record get` | `--contract-id` | 查询单份合同详情;别名 `record detail` |
| `dws contract record quantity-by-type` | 无 | 按查询维度统计各状态合同数量 |
| `dws contract record create` | `--file` | 从 JSON 创建合同台账 |

### 查询与统计

`record list` 支持:

- `--start` / `--end`:ISO-8601 合同创建时间;两者同时存在时结束时间不得早于开始时间。
- `--status`:逗号分隔,可选 `approving`、`signing`、`canceled`、`withdraw`、`refused`、`not-archive`、`archive-confirming`、`archived`。
- `--type`:`self`、`participation`、`department`、`all`、`unassigned`,默认 `all`。

`record quantity-by-type` 的 `--type` 与列表相同。

```bash
dws contract record list --type participation --status approving,signing --format json
dws contract record get --contract-id <CONTRACT_ID> --format json
dws contract record quantity-by-type --type department --format json
```

### 创建台账 JSON

`record create --file` 接受 `ImportContractInfoRequest` JSON 对象,必填字段为 `contentFiles`、`name`、`effectiveStatus`、`signStatus`、`ownerDeptNo`。

关键枚举:

- `effectiveStatus`:`not-effective`、`pre-effective`、`effective`、`expired`、`ineffective`、`canceled`。
- `signStatus`:`signing`、`not-archive`、`archived`。
- `amountType`:`payment_party_other`、`payment_party_our`、`none`。
- `signType`:`entity_seal`、`electronic_seal`。
- `termType`:`accurate_end_date`、`perform_finished`。
- `sealTypes`:`contract_seal`、`common_seal`、`legal_seal`。

```bash
dws contract record create --file ./contract.json --format json
```

## 批量导入

| 命令 | 必填参数 | 用途 |
|---|---|---|
| `dws contract import batch` | `--file-id`, `--space-id` | 从钉盘模板文件创建异步合同导入任务 |
| `dws contract import batch-result` | `--task-id` | 查询合同导入结果 |

`--space-id` 可缩写为 `-s`;`--file-id` 不得缩写为 `-f`,因为 `-f` 是全局输出格式。

```bash
dws contract import batch --file-id <FILE_ID> --space-id <SPACE_ID> --format json
dws contract import batch-result --task-id <TASK_ID> --format json
```

## 基础资料

| 命令 | 用途 |
|---|---|
| `dws contract process-templates` | 查询当前用户可见的合同审批模板/流程内容 |
| `dws contract file-directories` | 查询全部合同台账目录;别名 `directories` |

两条命令都没有产品级必填参数。

## 合同起草

`dws contract draft` 根据一条或多条 AI 听记和合同模板起草合同:

- `--task-uuids`:必填,听记任务 ID,多个值用英文逗号分隔。
- `--template-url` / `--template-content`:至少提供一个。

听记 ID 必须来自 `dingtalk-minutes` 的真实返回。模板正文较长时,应从可信本地文件读取后传入,不要让 shell 对内容做意外展开。

```bash
dws contract draft --task-uuids <TASK_UUIDS> --template-url <TEMPLATE_URL> --format json
```

## 项目管理

| 命令 | 必填参数 | 用途 |
|---|---|---|
| `dws contract project add` | `--name` | 创建合同项目 |
| `dws contract project update` | `--project-id`, `--name` | 更新项目 |
| `dws contract project set-status` | `--project-id`, `--status` | 更新项目状态 |
| `dws contract project list` | `--current-page`, `--page-size`, `--scope` | 分页查询项目 |
| `dws contract project digests` | `--current-page`, `--page-size`, `--scope` | 分页查询项目摘要 |
| `dws contract project detail` | `--project-id` | 查询项目详情 |
| `dws contract project delete` | `--project-ids` | 删除一个或多个项目 |
| `dws contract project export` | `--project-ids` | 导出项目到 Excel |
| `dws contract project import-template` | 无 | 获取项目导入模板链接 |
| `dws contract project import` | `--file-id` | 从钉盘文件创建项目导入任务 |
| `dws contract project import-result` | `--task-id` | 查询项目导入结果 |

### 项目字段

- 新增/更新:`--code`、`--owners`、`--start-date`、`--end-date`、`--remark`、`--contract-ids`;新增还支持 `--source`。
- 日期使用 ISO-8601;开始和结束同时提供时,结束日期不得早于开始日期。
- 列表/摘要:`--scope` 取 `self` 或 `all`;筛选支持 `--name`、`--code`、`--owners`、`--status`、四个日期区间参数。
- 导出可选 `--process-code`。
- 导入可选 `--space-id`、`--file-name`、`--file-type`、`--file-size`。

```bash
dws contract project list --current-page 1 --page-size 20 --scope all --format json
dws contract project detail --project-id <PROJECT_ID> --format json
dws contract project add --name <PROJECT_NAME> --format json
dws contract project import --file-id <FILE_ID> --space-id <SPACE_ID> --format json
dws contract project import-result --task-id <TASK_ID> --format json
```

## 相对方管理

| 命令 | 必填参数 | 用途 |
|---|---|---|
| `dws contract subject add` | `--file` | 添加相对方 |
| `dws contract subject update` | `--file` | 更新相对方 |
| `dws contract subject list` | `--current-page`, `--page-size` | 分页查询相对方 |
| `dws contract subject detail` | `--subject-id` | 查询相对方详情 |
| `dws contract subject delete` | `--subject-id` | 删除单个相对方 |
| `dws contract subject batch-delete` | `--subject-ids` | 批量删除相对方,最多 1000 个 |
| `dws contract subject sort` | `--subject-ids` | 按传入顺序排列己方主体 |
| `dws contract subject detect-risk` | `--subject-name` | 检测相对方风险;可选 `--subject-id` |
| `dws contract subject base-info` | `--subject-name` | 查询工商基本信息;可选 `--subject-id` |
| `dws contract subject auto-fill` | `--subject-name` | 智能填充相对方信息;可选 `--subject-id` |
| `dws contract subject export` | `--subject-ids` | 导出相对方到 Excel |
| `dws contract subject import-template` | 无 | 获取相对方导入模板;可选 `--type` |
| `dws contract subject import` | `--file-id` | 从钉盘文件创建相对方导入任务 |
| `dws contract subject import-result` | `--task-id` | 查询相对方导入结果 |

### 相对方 JSON

`subject add` 接受 `AddSubjectOpenRequest`,至少包含 `partyType` 和 `name`。`partyType` 取 `other`(对方)或 `our`(己方);`source` 常用 `contract` 或 `oa`;`bankAccountType` 取 `BUSINESS_ACCOUNT` 或 `PERSONAL_ACCOUNT`。

`subject update` 接受 `UpdateSubjectOpenRequest`,至少包含真实 `subjectId`、`partyType` 和 `name`。更新前先执行 `subject detail`,在原数据基础上修改,避免覆盖未知字段。

### 查询、导入与导出

- 列表可选 `--party-type`、`--name`、`--code`、`--source`。
- 导出可选 `--process-code`。
- 导入模板 `--type` 可取 `other` 或 `our`。
- 导入可选 `--space-id`、`--file-name`、`--file-type`、`--file-size`。

```bash
dws contract subject list --current-page 1 --page-size 20 --party-type other --format json
dws contract subject detail --subject-id <SUBJECT_ID> --format json
dws contract subject add --file ./subject.json --format json
dws contract subject detect-risk --subject-name <SUBJECT_NAME> --format json
dws contract subject import --file-id <FILE_ID> --space-id <SPACE_ID> --format json
dws contract subject import-result --task-id <TASK_ID> --format json
```

删除前必须先用 `subject detail` 展示真实相对方名称与 ID;批量删除还要展示总数和全部目标 ID,获得确认后再执行。

## 账款管理

| 命令 | 必填参数 | 用途 |
|---|---|---|
| `dws contract account create` | `--file` | 创建账款信息 |
| `dws contract account update` | `--file` | 更新账款信息 |
| `dws contract account get` | `--account-id` | 查询单条账款 |
| `dws contract account list` | 无 | 按条件分页查询账款 |
| `dws contract account delete` | `--account-id` | 删除账款 |

### 账款 JSON

创建请求至少包含:

- `contractId`:真实合同 ID。
- `amount`:以元为单位的字符串金额,例如 `1234.56`。
- `transactionNo`:不可重复的单据号。
- `executionDate`:Unix 毫秒时间戳。
- `status`:`approving`、`withdraw`、`refused`、`confirming`、`canceled`、`finished` 之一。

可选字段包括 `reimbursementNo`、`currencyCode`(默认 `CNY`)、`source`、`remark`。更新请求还必须包含真实 `accountEntryId`;应先执行 `account get`,修改原数据后再提交。

### 账款列表

- `--scope`:`self`、`department`、`all`。
- `--query-status`:`all`、`pay`、`receive`。
- `--amount-type`:`payment_party_other`、`payment_party_our`、`none`。
- 其他筛选:`--status`、`--source`、`--contract-code`、`--contract-name`、`--transaction-no`。
- `--exec-start` / `--exec-end`:ISO-8601 时间字符串;CLI 转换为 MCP 所需的 Unix 毫秒时间戳。
- 分页:`--page`、`--page-size`。

```bash
dws contract account list --scope self --page 1 --page-size 20 --format json
dws contract account get --account-id <ACCOUNT_ID> --format json
dws contract account create --file ./account.json --format json
```

删除账款前必须先执行 `account get`,向用户展示账款 ID、合同 ID、金额、单据号和状态并获得确认。

## 合同归档

`dws contract archive --file` 接受 `ContractOpenArchiveRequest` JSON 对象:

- `bizId`:合同唯一标识,必填。
- `archiveTime`:Unix 毫秒时间戳,必填。
- `archiveFiles`:必填数组;每项可包含 `spaceId`、`fileId`、`fileName`、`fileType`、`fileSize`。
- `archiveCode`、`archiveComment`、`fileDirectoryId`:可选。

归档前通过 `record get` 核对合同,通过钉盘能力核对每个文件 ID,并在确认信息中列出合同、文件数量、目录和归档时间。

```bash
dws contract archive --file ./archive_request.json --format json
```

## 命令与 MCP 能力映射

仅用于诊断和维护,不应绕过 CLI 直接调用:

| CLI 命令 | MCP 工具 |
|---|---|
| `record list` / `get` / `quantity-by-type` / `create` | `queryContracts` / `queryContractDetails` / `queryContractQuantityByType` / `createContract` |
| `import batch` / `batch-result` | `batchImportContractAsync` / `getBatchImportContractResult` |
| `process-templates` / `file-directories` / `draft` | `queryContractProcessContent` / `getAllFileDirectory` / `draft_contract_by_minutes` |
| `project ...` | `addProject`, `deleteProject`, `updateProject`, `setProjectStatus`, `queryProjects`, `queryProjectDigests`, `queryProjectDetail`, `exportProject`, `getImportProjectTemplate`, `importProject`, `getImportProjectResult` |
| `subject ...` | `addSubject`, `querySubjects`, `querySubjectDetail`, `updateSubject`, `deleteSubject`, `batchDeleteSubject`, `sortSubjects`, `detectSubjectRisk`, `querySubjectBaseInfo`, `autoFillSubjectInfo`, `exportSubject`, `getImportSubjectTemplate`, `importSubject`, `getImportSubjectResult` |
| `account ...` / `archive` | `createAccountInfo`, `updateAccountInfo`, `getAccountEntryInfo`, `listAccountInfo`, `deleteAccountEntryInfo`, `contractOpenArchive` |
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall