本文介紹了自訂擴充指令的應用情境,例如代碼規範檢查、代碼變數命名以及API開發文檔自動產生等。旨在擴充企業個人化能力寬度,同時簡化企業開發人員在智能問答的使用複雜度。
關於如何建立並使用自訂指令,具體請參見擴充管理。
情境樣本
情境1:代碼規範檢查
應用情境
傳統上,代碼在提交後通過掃描工具檢測問題,但這種方式滯後且成本高。現在可以通過向模型提供技術和業務背景,以及自訂代碼規範細則,來提前進行代碼檢查,並輸出檢測結果。以下是一個金融業務情境下的Java代碼檢查樣本。
指令配置
|
指令名稱 |
代碼規範檢查 |
|
指令名稱(英文) |
my code scan |
|
指令表徵圖 |
任意表徵圖 |
|
指令描述 |
提前進行代碼檢查,並輸出檢測結果。 |
|
指令可見範圍 |
根據訴求選擇 |
|
提示詞 |
|
|
上下文組裝 |
請為如下的代碼 |
情境2:API開發文檔自動產生
應用情境
在分布式系統、前後端分離架構( SOA 模式)中的需求開發都是面向API的,所以在API開發完成後還要提供與之配套的API使用文檔,讓服務接入方能快速進行開發與聯調。
指令配置
|
指令名稱 |
API開發文檔自動產生 |
|
指令名稱(英文) |
generate api docs |
|
指令表徵圖 |
任意表徵圖 |
|
指令描述 |
API開發完成後提供的配套API使用文檔。 |
|
指令可見範圍 |
根據訴求選擇 |
|
提示詞 |
|
|
上下文組裝 |
請為如下的代碼 |
情境3:代碼變數命名
應用情境
在日常開發過程中,只要編寫代碼就不可避免要為代碼變數取名,一個表述準確、可讀性強且符合規範的命名是體現一個開發人員專業素養和代碼品質的重要方面,它不僅能夠提高代碼的可維護性和可讀性,還能促進團隊成員之間的高效協作。
指令配置
|
指令名稱 |
代碼變數命名 |
|
指令名稱(英文) |
variable naming assistant |
|
指令表徵圖 |
任意表徵圖 |
|
指令描述 |
結合公司和團隊的代碼規範,根據使用者的描述來產生合適的變數名。 |
|
指令可見範圍 |
根據訴求選擇 |
|
提示詞 |
|
|
上下文組裝 |
使用:通過自訂指令 |
指令執行流程
通過自訂擴充指令/+框選程式碼片段,觸發該指令後的執行流程如下:
-
擷取圈選的程式碼片段並設定到上下文中,並根據指令類型選擇合適的模板和提示詞。
-
通過提示詞來讓模型進行檢查推理,產生符合規範的代碼檢查建議、API文檔或變數命名建議等,並返回給使用者。


