mcpField
C
contract-cli-mdm-fields

contract-cli-mdm-fields

github.com/qfeiusデータ・データベース497 回インストール27 週間前に更新
リポジトリ

contract-cli-mdm-fields について

contract-cliでMDMのフィールド設定を照会し、取引先や法人エンティティのデータを書き込む前に定義を確認するためのスキルです。業務ラインの指定が必要で、userとbotの経路や対応範囲も説明します。

主な機能

  1. 01業務ラインごとにフィールド設定を照会
  2. 02取引先と法人エンティティの項目に対応
  3. 03userとbotのエンドポイントを区別
  4. 04リスク項目の利用条件を明記
  5. 05ローカル検証や項目変換は行わない

活用シーン

  1. 01取引先データの書き込み前に項目定義を確認
  2. 02法人エンティティの書き込み前に設定を確認
  3. 03user経路で取引先リスク項目を照会

MCP 対応

contract-cliによるMDMフィールド設定の照会方法を案内します。user経路では契約MCPのエンドポイント、bot経路ではMDMのエンドポイントを使います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/qfeius/contract-cli --skill contract-cli-mdm-fields

インストール後、Claude Code で/contract-cli-mdm-fieldsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
commands.md
schema-biz-lines.md
schema-fields-guide.md

詳細

プロジェクトの README より

contract-cli MDM Fields

CRITICAL — 开始前 MUST 先读取 ../contract-cli-shared/SKILL.md。

适用命令

  • contract-cli mdm fields list --biz-line <vendor|legal_entity|vendor_risk>

快速决策

  • 需要在写入交易方前确认字段定义：--biz-line vendor
  • 需要在写入法人实体前确认字段定义：--biz-line legal_entity
  • 需要确认交易方风险字段：--biz-line vendor_risk，仅适用于 user/MCP 路径
  • 如果用户想查合同创建枚举，不要走这里，改用 contract enum list

关键规则

  • --biz-line 必填
  • mdm fields list --as user 走 /open-apis/contract/v1/mcp/config/config_list
  • mdm fields list --as bot 走 /open-apis/mdm/v1/config/config_list
  • bot 后端当前只接受 vendor / legalEntity；CLI 会把 bot 下的 legal_entity 自动映射为 legalEntity
  • vendor_risk 在 bot 身份下不支持，会在本地报错
  • --user-id-type / --user-id 仍按共享规则透传，不做本地校验
  • 当前只封装字段配置查询，不负责本地校验和字段转换
  • 推荐阅读顺序是：

实现来源

操作建议

  • 未封装写接口前，先用这条命令确认字段结构
  • 需要写交易方或法人实体时，等待对应结构化写命令开放；不要退回 api call，该入口当前暂未开放
  • 只想查合同枚举时，不要走这里

不要这样做

  • 不要把 mdm fields list 当成数据查询命令
  • 不要假设它会自动帮你校验写请求

コメント

Markdown 対応