contract-cli-mdm-vendor について
contract-cliでMDMの取引先を名前やIDから検索するためのスキルです。userとbotの照会経路を区別し、取引先の作成・更新は未対応であることも示します。
主な機能
- 01名前やページ指定で取引先を一覧
- 02取引先IDで詳細を取得
- 03userとbotの経路を区別
- 04未対応の書き込みコマンドを明記
活用シーン
- 01名前から取引先候補を探す
- 02契約作成前に取引先IDを確認
MCP 対応
contract-cliによるMDM取引先の照会方法を案内します。user経路では契約MCPのエンドポイント、bot経路ではMDMのエンドポイントを使います。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ qfeius/ contract-cli --skill contract-cli-mdm-vendorインストール後、Claude Code で/contract-cli-mdm-vendorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/commands.mdvendor-query-guide.mdvendor-query-parameters.md詳細
プロジェクトの README よりcontract-cli MDM Vendor
CRITICAL — 开始前 MUST 先读取 ../contract-cli-shared/SKILL.md。
适用命令
contract-cli mdm vendor listcontract-cli mdm vendor get <vendor-id>
快速决策
- 已知交易方 ID:直接用
mdm vendor get - 只知道名称或想拿候选列表:用
mdm vendor list - 如果用户想在创建前确认字段定义:切到 ../contract-cli-mdm-fields/SKILL.md
- 如果用户想创建或更新交易方:当前结构化命令未实现,明确说明暂未覆盖;不要退回
api call
关键规则
mdm vendor list支持--name、--page-size、--page-tokenmdm vendor list --as user走/open-apis/contract/v1/mcp/vendorsmdm vendor list --as bot走/open-apis/mdm/v1/vendorsmdm vendor get --as user走/open-apis/contract/v1/mcp/vendors/{vendor_id}mdm vendor get --as bot走/open-apis/mdm/v1/vendors/{vendor_id}- 不暴露
--operator --user-id-type/--user-id仍按共享规则透传,不做本地校验- 推荐阅读顺序是:
- 先读 references/vendor-query-guide.md 选查询场景
- 再读 references/vendor-query-parameters.md 查请求参数映射
- 最后读 references/commands.md 抄命令示例
实现来源
- internal/cli/vendor_command.go
- internal/openplatform/mdmvendor/service.go
- references/vendor-query-guide.md
- references/vendor-query-parameters.md
- references/commands.md
操作建议
- 只知道名称时,先
mdm vendor list拿候选,再mdm vendor get查详情 - 创建合同前如果只是要选对方主体,优先记住交易方 id
- 想确认写接口字段定义时,切到
mdm fields list
不要这样做
- 不要把
mdm vendor list/get当成字段配置查询 - 不要把未实现的
mdm vendor create/update当成已有结构化命令
コメント
Markdown 対応