[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6F76NPRKBP9VGZCP7T5JN06":3,"skill-same:01M6F76NPRKBP9VGZCP7T5JN06":83},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":28,"publishedAt":51,"linkOnly":52,"markdownContent":53,"markdownBody":54,"frontMatter":55,"refName":60,"commitSha":61,"skillDirectory":62,"forksCount":63,"repositoryHtmlUrl":64,"repositoryHomepageUrl":6,"ownerHtmlUrl":65,"ownerBlogUrl":66,"ownerDescription":67,"updatedAt":68,"install":69,"resources":82},"01M6F76NPRKBP9VGZCP7T5JN06","guidewire-sdk-patterns",null,"Master Guidewire SDK patterns including Digital SDK, REST API Client, and Gosu best practices.\nUse when implementing integrations, building frontends with Jutro, or writing server-side Gosu code.\nTrigger with phrases like \"guidewire sdk\", \"digital sdk\", \"jutro sdk\",\n\"guidewire patterns\", \"gosu best practices\", \"rest api client\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1992,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fguidewire-pack\u002Fskills\u002Fguidewire-sdk-patterns\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50],"sdk","guidewire sdk patterns","patterns","when","writing","implementing","trigger","io","server-side","gradle","master","use","edit","write","read","integrations","Bash","api client","api","server","best practices","code","2026-11-10 10:12:30",false,"---\nname: guidewire-sdk-patterns\ndescription: |\n  Master Guidewire SDK patterns including Digital SDK, REST API Client, and Gosu best practices.\n  Use when implementing integrations, building frontends with Jutro, or writing server-side Gosu code.\n  Trigger with phrases like \"guidewire sdk\", \"digital sdk\", \"jutro sdk\",\n  \"guidewire patterns\", \"gosu best practices\", \"rest api client\".\nallowed-tools: Read, Write, Edit, Bash(npm:*), Bash(gradle:*), Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# Guidewire SDK Patterns\n\n## Overview\n\nMaster the key SDK patterns for Guidewire development: Digital SDK for frontends, REST API Client for integrations, and Gosu patterns for server-side development.\n\n## Prerequisites\n\n- Completed `guidewire-install-auth` and `guidewire-hello-world`\n- Understanding of TypeScript\u002FJavaScript (for Digital SDK)\n- Familiarity with Gosu basics (for server-side patterns)\n\n## Digital SDK (Frontend)\n\n### Installation and Setup\n\n```bash\n# Initialize Jutro project with Digital SDK\nnpx @guidewire\u002Fjutro-cli@latest create my-portal --template agent-portal\n\ncd my-portal\n\n# Generate Digital SDK from your Cloud API\nnpx jutro-cli generate-sdk \\\n  --api-url https:\u002F\u002Fyour-tenant.cloud.guidewire.com\u002Fpc \\\n  --output src\u002Fsdk\n```\n\n### SDK Configuration\n\n```typescript\n\u002F\u002F src\u002Fsdk\u002Fconfig.ts\nimport { createSdkConfig } from '@guidewire\u002Fdigital-sdk';\n\nexport const sdkConfig = createSdkConfig({\n  baseUrl: process.env.REACT_APP_API_URL,\n  auth: {\n    type: 'oauth2',\n    clientId: process.env.REACT_APP_CLIENT_ID,\n    redirectUri: `${window.location.origin}\u002Fcallback`,\n    scope: 'pc.policies'\n  },\n  headers: {\n    'Accept-Language': 'en-US'\n  },\n  timeout: 30000\n});\n```\n\n### Entity Operations\n\n```typescript\n\u002F\u002F Using Digital SDK for CRUD operations\nimport { useAccount, useAccounts, createAccount } from '..\u002Fsdk\u002Faccount';\n\n\u002F\u002F Read single entity\nfunction AccountDetail({ accountId }: { accountId: string }) {\n  const { data: account, loading, error } = useAccount(accountId, {\n    include: ['accountHolder', 'primaryLocation']\n  });\n\n  if (loading) return \u003CLoadingSpinner \u002F>;\n  if (error) return \u003CErrorBanner error={error} \u002F>;\n\n  return (\n    \u003Cdiv>\n      \u003Ch1>{account.accountHolder.displayName}\u003C\u002Fh1>\n      \u003Cp>Account #: {account.accountNumber}\u003C\u002Fp>\n      \u003Cp>Status: {account.accountStatus.name}\u003C\u002Fp>\n    \u003C\u002Fdiv>\n  );\n}\n\n\u002F\u002F List entities with filtering\nfunction AccountList() {\n  const { data: accounts, loading, pagination } = useAccounts({\n    filter: { accountStatus: 'Active' },\n    pageSize: 25,\n    sort: '-createdDate'\n  });\n\n  return (\n    \u003CDataTable\n      data={accounts}\n      loading={loading}\n      pagination={pagination}\n      columns={[\n        { field: 'accountNumber', header: 'Account #' },\n        { field: 'accountHolder.displayName', header: 'Name' },\n        { field: 'accountStatus.name', header: 'Status' }\n      ]}\n    \u002F>\n  );\n}\n\n\u002F\u002F Create entity\nasync function handleCreateAccount(formData: AccountFormData) {\n  try {\n    const newAccount = await createAccount({\n      accountHolder: {\n        firstName: formData.firstName,\n        lastName: formData.lastName,\n        dateOfBirth: formData.dob\n      },\n      primaryLocation: {\n        addressLine1: formData.address,\n        city: formData.city,\n        state: { code: formData.state },\n        postalCode: formData.zip\n      }\n    });\n\n    console.log('Created account:', newAccount.accountNumber);\n    return newAccount;\n  } catch (error) {\n    handleApiError(error);\n  }\n}\n```\n\n### Schema Validation\n\n```typescript\n\u002F\u002F Using SDK-generated schema validation\nimport { accountSchema, validateAccount } from '..\u002Fsdk\u002Faccount';\nimport { useForm } from 'react-hook-form';\nimport { zodResolver } from '@hookform\u002Fresolvers\u002Fzod';\n\nfunction AccountForm() {\n  const {\n    register,\n    handleSubmit,\n    formState: { errors }\n  } = useForm({\n    resolver: zodResolver(accountSchema)\n  });\n\n  return (\n    \u003Cform onSubmit={handleSubmit(onSubmit)}>\n      \u003CInput\n        {...register('accountHolder.firstName')}\n        label=\"First Name\"\n        error={errors.accountHolder?.firstName?.message}\n        required\n      \u002F>\n      \u003CInput\n        {...register('accountHolder.lastName')}\n        label=\"Last Name\"\n        error={errors.accountHolder?.lastName?.message}\n        required\n      \u002F>\n      {\u002F* Additional fields *\u002F}\n    \u003C\u002Fform>\n  );\n}\n```\n\n## REST API Client (Integration)\n\n### Client Plugin Setup\n\n```groovy\n\u002F\u002F build.gradle - REST API Client plugin\nplugins {\n    id 'com.guidewire.rest-api-client' version '3.0.0'\n}\n\nrestApiClient {\n    clients {\n        externalRating {\n            specFile = file('specs\u002Frating-service.yaml')\n            packageName = 'gw.integration.rating'\n            generateSync = true\n            faultTolerance {\n                retryAttempts = 3\n                retryDelay = 1000\n                circuitBreakerThreshold = 5\n            }\n        }\n    }\n}\n```\n\n### Generated Client Usage\n\n```gosu\n\u002F\u002F Using generated REST API client\npackage gw.integration.rating\n\nuses gw.integration.rating.api.RatingApi\nuses gw.integration.rating.model.RatingRequest\nuses gw.integration.rating.model.RatingResponse\nuses gw.api.util.Logger\n\nclass RatingService {\n  private static final var LOG = Logger.forCategory(\"RatingService\")\n  private static final var _api = new RatingApi()\n\n  static function getRating(policy : Policy) : RatingResponse {\n    var request = new RatingRequest()\n    request.PolicyNumber = policy.PolicyNumber\n    request.EffectiveDate = policy.EffectiveDate\n    request.CoverageType = policy.Product.Code\n    request.State = policy.PrimaryLocation.State.Code\n\n    try {\n      var response = _api.calculateRating(request)\n      LOG.info(\"Rating calculated: ${response.PremiumAmount}\")\n      return response\n    } catch (e : FaultToleranceException) {\n      LOG.error(\"Rating service unavailable\", e)\n      throw new RatingServiceException(\"Unable to calculate rating\", e)\n    }\n  }\n}\n```\n\n### Custom REST Client\n\n```gosu\n\u002F\u002F Custom REST client implementation\npackage gw.integration.external\n\nuses gw.api.rest.RestClient\nuses gw.api.rest.RestClientBuilder\nuses gw.api.rest.Response\nuses gw.api.util.Logger\n\nclass ExternalServiceClient {\n  private static final var LOG = Logger.forCategory(\"ExternalServiceClient\")\n\n  private var _client : RestClient\n\n  construct() {\n    _client = RestClientBuilder.create()\n      .withBaseUrl(ScriptParameters.ExternalServiceUrl)\n      .withTimeout(30000)\n      .withHeader(\"Authorization\", \"Bearer ${getToken()}\")\n      .withHeader(\"Content-Type\", \"application\u002Fjson\")\n      .build()\n  }\n\n  function getResource(resourceId : String) : ExternalResource {\n    var response = _client.get(\"\u002Fresources\u002F${resourceId}\")\n    validateResponse(response)\n    return parseResponse(response, ExternalResource)\n  }\n\n  function createResource(resource : ExternalResource) : ExternalResource {\n    var response = _client.post(\"\u002Fresources\", toJson(resource))\n    validateResponse(response)\n    return parseResponse(response, ExternalResource)\n  }\n\n  private function validateResponse(response : Response) {\n    if (response.StatusCode >= 400) {\n      LOG.error(\"API error: ${response.StatusCode} - ${response.Body}\")\n      throw new ExternalServiceException(\n        \"External service error: ${response.StatusCode}\"\n      )\n    }\n  }\n\n  private function getToken() : String {\n    \u002F\u002F Token retrieval logic\n    return ScriptParameters.ExternalServiceToken\n  }\n}\n```\n\n## Gosu Patterns (Server-Side)\n\n### Entity Query Patterns\n\n```gosu\n\u002F\u002F Efficient querying with Query API\npackage gw.custom.query\n\nuses gw.api.database.Query\nuses gw.api.database.Relop\nuses gw.api.path.Paths\n\nclass PolicyQueryService {\n\n  \u002F\u002F Simple query\n  static function findByPolicyNumber(policyNumber : String) : Policy {\n    return Query.make(Policy)\n      .compare(Policy#PolicyNumber, Equals, policyNumber)\n      .select()\n      .AtMostOneRow\n  }\n\n  \u002F\u002F Query with joins\n  static function findPoliciesByProducerCode(producerCode : String) : List\u003CPolicy> {\n    return Query.make(Policy)\n      .join(Policy#ProducerCodeOfRecord)\n      .compare(ProducerCode#Code, Equals, producerCode)\n      .select()\n      .toList()\n  }\n\n  \u002F\u002F Complex query with subqueries\n  static function findActiveHighValuePolicies(minPremium : java.math.BigDecimal) : List\u003CPolicy> {\n    var query = Query.make(Policy)\n    query.compare(Policy#Status, Equals, PolicyStatus.TC_INFORCE)\n    query.compare(Policy#TotalPremiumRPT, GreaterThanOrEquals, minPremium)\n    query.compare(Policy#ExpirationDate, GreaterThan, Date.Today)\n\n    \u002F\u002F Add subquery for specific coverage\n    var subquery = query.subselect(Policy#ID, CompareIn, PolicyPeriod#Policy)\n    subquery.join(PolicyPeriod#PersonalAutoLine)\n      .compare(PersonalAutoLine#PAVehicles, IsNotNull, null)\n\n    return query.select()\n      .orderBy(\\p -> p.TotalPremiumRPT)\n      .toList()\n  }\n\n  \u002F\u002F Batch processing pattern\n  static function processInBatches\u003CT>(\n    query : Query\u003CT>,\n    batchSize : int,\n    processor(batch : List\u003CT>)\n  ) {\n    var iterator = query.select().iterator()\n    var batch = new ArrayList\u003CT>()\n\n    while (iterator.hasNext()) {\n      batch.add(iterator.next())\n      if (batch.size() >= batchSize) {\n        processor(batch)\n        batch.clear()\n      }\n    }\n\n    if (!batch.Empty) {\n      processor(batch)\n    }\n  }\n}\n```\n\n### Transaction Patterns\n\n```gosu\n\u002F\u002F Transaction management patterns\npackage gw.custom.transaction\n\nuses gw.api.database.Transaction\nuses gw.transaction.Transaction as GWTransaction\n\nclass TransactionService {\n\n  \u002F\u002F Basic transaction\n  static function createAccountWithPolicy(accountData : AccountData) : Policy {\n    return GWTransaction.runWithNewBundle(\\bundle -> {\n      var account = new Account(bundle)\n      account.AccountNumber = accountData.AccountNumber\n\n      var contact = new Person(bundle)\n      contact.FirstName = accountData.FirstName\n      contact.LastName = accountData.LastName\n      account.AccountHolderContact = contact\n\n      \u002F\u002F Create submission\n      var submission = new Submission(bundle)\n      submission.Account = account\n      submission.Product = accountData.Product\n\n      return submission.Policy\n    })\n  }\n\n  \u002F\u002F Transaction with savepoint\n  static function complexOperation(policy : Policy) {\n    GWTransaction.runWithNewBundle(\\bundle -> {\n      policy = bundle.add(policy)\n\n      try {\n        \u002F\u002F Risky operation 1\n        updateCoverages(policy)\n\n        \u002F\u002F Risky operation 2\n        applyEndorsement(policy)\n\n      } catch (e : Exception) {\n        \u002F\u002F Bundle will rollback automatically on exception\n        throw e\n      }\n    })\n  }\n\n  \u002F\u002F Async transaction\n  static function queueAsyncWork(policyId : Key) {\n    gw.api.async.AsyncProcess.schedule(\n      \"ProcessPolicy\",\n      \\-> processPolicy(policyId),\n      Date.Now\n    )\n  }\n}\n```\n\n### Plugin Patterns\n\n```gosu\n\u002F\u002F Plugin implementation pattern\npackage gw.plugin.rating\n\nuses gw.plugin.rating.IRatingPlugin\nuses gw.api.util.Logger\n\nclass CustomRatingPlugin implements IRatingPlugin {\n  private static final var LOG = Logger.forCategory(\"CustomRatingPlugin\")\n\n  override function calculatePremium(period : PolicyPeriod) : Money {\n    LOG.info(\"Calculating premium for policy: ${period.PolicyNumber}\")\n\n    var basePremium = calculateBasePremium(period)\n    var discounts = applyDiscounts(period, basePremium)\n    var taxes = calculateTaxes(period, basePremium - discounts)\n\n    return basePremium - discounts + taxes\n  }\n\n  private function calculateBasePremium(period : PolicyPeriod) : Money {\n    \u002F\u002F Base premium calculation logic\n    return period.Lines\n      .map(\\line -> line.calculatePremium())\n      .sum()\n  }\n\n  private function applyDiscounts(period : PolicyPeriod, base : Money) : Money {\n    var totalDiscount = Money.ZERO\n\n    \u002F\u002F Multi-policy discount\n    if (period.Account.Policies.Count > 1) {\n      totalDiscount += base * 0.10\n    }\n\n    \u002F\u002F Good driver discount\n    if (hasGoodDriverDiscount(period)) {\n      totalDiscount += base * 0.15\n    }\n\n    return totalDiscount\n  }\n}\n```\n\n## Output\n\n- Configured Digital SDK with type-safe API calls\n- REST API Client with fault tolerance\n- Gosu patterns following Guidewire best practices\n\n## Error Handling\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| SDK generation failed | Invalid API spec | Verify OpenAPI spec URL and access |\n| Type mismatch | Schema changed | Regenerate SDK |\n| Transaction timeout | Long-running operation | Optimize or use async |\n| Client timeout | Network issues | Increase timeout, add retry |\n\n## Resources\n\n- [Digital SDK Documentation](https:\u002F\u002Fdocs.guidewire.com\u002Fjutro\u002Fdocumentation\u002F10.12\u002Fworking-with-cloud-apis\u002F)\n- [REST API Client Guide](https:\u002F\u002Fdeveloper.guidewire.com\u002Frest-api-client\u002F)\n- [Gosu Language Reference](https:\u002F\u002Fgosu-lang.github.io\u002F)\n- [Query API Documentation](https:\u002F\u002Fdocs.guidewire.com\u002Fcloud\u002Fpc\u002F202503\u002Fcloudapica\u002F)\n\n## Next Steps\n\nFor core insurance workflows, see `guidewire-core-workflow-a` and `guidewire-core-workflow-b`.\n","# Guidewire SDK Patterns\n\n## Overview\n\nMaster the key SDK patterns for Guidewire development: Digital SDK for frontends, REST API Client for integrations, and Gosu patterns for server-side development.\n\n## Prerequisites\n\n- Completed `guidewire-install-auth` and `guidewire-hello-world`\n- Understanding of TypeScript\u002FJavaScript (for Digital SDK)\n- Familiarity with Gosu basics (for server-side patterns)\n\n## Digital SDK (Frontend)\n\n### Installation and Setup\n\n```bash\n# Initialize Jutro project with Digital SDK\nnpx @guidewire\u002Fjutro-cli@latest create my-portal --template agent-portal\n\ncd my-portal\n\n# Generate Digital SDK from your Cloud API\nnpx jutro-cli generate-sdk \\\n  --api-url https:\u002F\u002Fyour-tenant.cloud.guidewire.com\u002Fpc \\\n  --output src\u002Fsdk\n```\n\n### SDK Configuration\n\n```typescript\n\u002F\u002F src\u002Fsdk\u002Fconfig.ts\nimport { createSdkConfig } from '@guidewire\u002Fdigital-sdk';\n\nexport const sdkConfig = createSdkConfig({\n  baseUrl: process.env.REACT_APP_API_URL,\n  auth: {\n    type: 'oauth2',\n    clientId: process.env.REACT_APP_CLIENT_ID,\n    redirectUri: `${window.location.origin}\u002Fcallback`,\n    scope: 'pc.policies'\n  },\n  headers: {\n    'Accept-Language': 'en-US'\n  },\n  timeout: 30000\n});\n```\n\n### Entity Operations\n\n```typescript\n\u002F\u002F Using Digital SDK for CRUD operations\nimport { useAccount, useAccounts, createAccount } from '..\u002Fsdk\u002Faccount';\n\n\u002F\u002F Read single entity\nfunction AccountDetail({ accountId }: { accountId: string }) {\n  const { data: account, loading, error } = useAccount(accountId, {\n    include: ['accountHolder', 'primaryLocation']\n  });\n\n  if (loading) return \u003CLoadingSpinner \u002F>;\n  if (error) return \u003CErrorBanner error={error} \u002F>;\n\n  return (\n    \u003Cdiv>\n      \u003Ch1>{account.accountHolder.displayName}\u003C\u002Fh1>\n      \u003Cp>Account #: {account.accountNumber}\u003C\u002Fp>\n      \u003Cp>Status: {account.accountStatus.name}\u003C\u002Fp>\n    \u003C\u002Fdiv>\n  );\n}\n\n\u002F\u002F List entities with filtering\nfunction AccountList() {\n  const { data: accounts, loading, pagination } = useAccounts({\n    filter: { accountStatus: 'Active' },\n    pageSize: 25,\n    sort: '-createdDate'\n  });\n\n  return (\n    \u003CDataTable\n      data={accounts}\n      loading={loading}\n      pagination={pagination}\n      columns={[\n        { field: 'accountNumber', header: 'Account #' },\n        { field: 'accountHolder.displayName', header: 'Name' },\n        { field: 'accountStatus.name', header: 'Status' }\n      ]}\n    \u002F>\n  );\n}\n\n\u002F\u002F Create entity\nasync function handleCreateAccount(formData: AccountFormData) {\n  try {\n    const newAccount = await createAccount({\n      accountHolder: {\n        firstName: formData.firstName,\n        lastName: formData.lastName,\n        dateOfBirth: formData.dob\n      },\n      primaryLocation: {\n        addressLine1: formData.address,\n        city: formData.city,\n        state: { code: formData.state },\n        postalCode: formData.zip\n      }\n    });\n\n    console.log('Created account:', newAccount.accountNumber);\n    return newAccount;\n  } catch (error) {\n    handleApiError(error);\n  }\n}\n```\n\n### Schema Validation\n\n```typescript\n\u002F\u002F Using SDK-generated schema validation\nimport { accountSchema, validateAccount } from '..\u002Fsdk\u002Faccount';\nimport { useForm } from 'react-hook-form';\nimport { zodResolver } from '@hookform\u002Fresolvers\u002Fzod';\n\nfunction AccountForm() {\n  const {\n    register,\n    handleSubmit,\n    formState: { errors }\n  } = useForm({\n    resolver: zodResolver(accountSchema)\n  });\n\n  return (\n    \u003Cform onSubmit={handleSubmit(onSubmit)}>\n      \u003CInput\n        {...register('accountHolder.firstName')}\n        label=\"First Name\"\n        error={errors.accountHolder?.firstName?.message}\n        required\n      \u002F>\n      \u003CInput\n        {...register('accountHolder.lastName')}\n        label=\"Last Name\"\n        error={errors.accountHolder?.lastName?.message}\n        required\n      \u002F>\n      {\u002F* Additional fields *\u002F}\n    \u003C\u002Fform>\n  );\n}\n```\n\n## REST API Client (Integration)\n\n### Client Plugin Setup\n\n```groovy\n\u002F\u002F build.gradle - REST API Client plugin\nplugins {\n    id 'com.guidewire.rest-api-client' version '3.0.0'\n}\n\nrestApiClient {\n    clients {\n        externalRating {\n            specFile = file('specs\u002Frating-service.yaml')\n            packageName = 'gw.integration.rating'\n            generateSync = true\n            faultTolerance {\n                retryAttempts = 3\n                retryDelay = 1000\n                circuitBreakerThreshold = 5\n            }\n        }\n    }\n}\n```\n\n### Generated Client Usage\n\n```gosu\n\u002F\u002F Using generated REST API client\npackage gw.integration.rating\n\nuses gw.integration.rating.api.RatingApi\nuses gw.integration.rating.model.RatingRequest\nuses gw.integration.rating.model.RatingResponse\nuses gw.api.util.Logger\n\nclass RatingService {\n  private static final var LOG = Logger.forCategory(\"RatingService\")\n  private static final var _api = new RatingApi()\n\n  static function getRating(policy : Policy) : RatingResponse {\n    var request = new RatingRequest()\n    request.PolicyNumber = policy.PolicyNumber\n    request.EffectiveDate = policy.EffectiveDate\n    request.CoverageType = policy.Product.Code\n    request.State = policy.PrimaryLocation.State.Code\n\n    try {\n      var response = _api.calculateRating(request)\n      LOG.info(\"Rating calculated: ${response.PremiumAmount}\")\n      return response\n    } catch (e : FaultToleranceException) {\n      LOG.error(\"Rating service unavailable\", e)\n      throw new RatingServiceException(\"Unable to calculate rating\", e)\n    }\n  }\n}\n```\n\n### Custom REST Client\n\n```gosu\n\u002F\u002F Custom REST client implementation\npackage gw.integration.external\n\nuses gw.api.rest.RestClient\nuses gw.api.rest.RestClientBuilder\nuses gw.api.rest.Response\nuses gw.api.util.Logger\n\nclass ExternalServiceClient {\n  private static final var LOG = Logger.forCategory(\"ExternalServiceClient\")\n\n  private var _client : RestClient\n\n  construct() {\n    _client = RestClientBuilder.create()\n      .withBaseUrl(ScriptParameters.ExternalServiceUrl)\n      .withTimeout(30000)\n      .withHeader(\"Authorization\", \"Bearer ${getToken()}\")\n      .withHeader(\"Content-Type\", \"application\u002Fjson\")\n      .build()\n  }\n\n  function getResource(resourceId : String) : ExternalResource {\n    var response = _client.get(\"\u002Fresources\u002F${resourceId}\")\n    validateResponse(response)\n    return parseResponse(response, ExternalResource)\n  }\n\n  function createResource(resource : ExternalResource) : ExternalResource {\n    var response = _client.post(\"\u002Fresources\", toJson(resource))\n    validateResponse(response)\n    return parseResponse(response, ExternalResource)\n  }\n\n  private function validateResponse(response : Response) {\n    if (response.StatusCode >= 400) {\n      LOG.error(\"API error: ${response.StatusCode} - ${response.Body}\")\n      throw new ExternalServiceException(\n        \"External service error: ${response.StatusCode}\"\n      )\n    }\n  }\n\n  private function getToken() : String {\n    \u002F\u002F Token retrieval logic\n    return ScriptParameters.ExternalServiceToken\n  }\n}\n```\n\n## Gosu Patterns (Server-Side)\n\n### Entity Query Patterns\n\n```gosu\n\u002F\u002F Efficient querying with Query API\npackage gw.custom.query\n\nuses gw.api.database.Query\nuses gw.api.database.Relop\nuses gw.api.path.Paths\n\nclass PolicyQueryService {\n\n  \u002F\u002F Simple query\n  static function findByPolicyNumber(policyNumber : String) : Policy {\n    return Query.make(Policy)\n      .compare(Policy#PolicyNumber, Equals, policyNumber)\n      .select()\n      .AtMostOneRow\n  }\n\n  \u002F\u002F Query with joins\n  static function findPoliciesByProducerCode(producerCode : String) : List\u003CPolicy> {\n    return Query.make(Policy)\n      .join(Policy#ProducerCodeOfRecord)\n      .compare(ProducerCode#Code, Equals, producerCode)\n      .select()\n      .toList()\n  }\n\n  \u002F\u002F Complex query with subqueries\n  static function findActiveHighValuePolicies(minPremium : java.math.BigDecimal) : List\u003CPolicy> {\n    var query = Query.make(Policy)\n    query.compare(Policy#Status, Equals, PolicyStatus.TC_INFORCE)\n    query.compare(Policy#TotalPremiumRPT, GreaterThanOrEquals, minPremium)\n    query.compare(Policy#ExpirationDate, GreaterThan, Date.Today)\n\n    \u002F\u002F Add subquery for specific coverage\n    var subquery = query.subselect(Policy#ID, CompareIn, PolicyPeriod#Policy)\n    subquery.join(PolicyPeriod#PersonalAutoLine)\n      .compare(PersonalAutoLine#PAVehicles, IsNotNull, null)\n\n    return query.select()\n      .orderBy(\\p -> p.TotalPremiumRPT)\n      .toList()\n  }\n\n  \u002F\u002F Batch processing pattern\n  static function processInBatches\u003CT>(\n    query : Query\u003CT>,\n    batchSize : int,\n    processor(batch : List\u003CT>)\n  ) {\n    var iterator = query.select().iterator()\n    var batch = new ArrayList\u003CT>()\n\n    while (iterator.hasNext()) {\n      batch.add(iterator.next())\n      if (batch.size() >= batchSize) {\n        processor(batch)\n        batch.clear()\n      }\n    }\n\n    if (!batch.Empty) {\n      processor(batch)\n    }\n  }\n}\n```\n\n### Transaction Patterns\n\n```gosu\n\u002F\u002F Transaction management patterns\npackage gw.custom.transaction\n\nuses gw.api.database.Transaction\nuses gw.transaction.Transaction as GWTransaction\n\nclass TransactionService {\n\n  \u002F\u002F Basic transaction\n  static function createAccountWithPolicy(accountData : AccountData) : Policy {\n    return GWTransaction.runWithNewBundle(\\bundle -> {\n      var account = new Account(bundle)\n      account.AccountNumber = accountData.AccountNumber\n\n      var contact = new Person(bundle)\n      contact.FirstName = accountData.FirstName\n      contact.LastName = accountData.LastName\n      account.AccountHolderContact = contact\n\n      \u002F\u002F Create submission\n      var submission = new Submission(bundle)\n      submission.Account = account\n      submission.Product = accountData.Product\n\n      return submission.Policy\n    })\n  }\n\n  \u002F\u002F Transaction with savepoint\n  static function complexOperation(policy : Policy) {\n    GWTransaction.runWithNewBundle(\\bundle -> {\n      policy = bundle.add(policy)\n\n      try {\n        \u002F\u002F Risky operation 1\n        updateCoverages(policy)\n\n        \u002F\u002F Risky operation 2\n        applyEndorsement(policy)\n\n      } catch (e : Exception) {\n        \u002F\u002F Bundle will rollback automatically on exception\n        throw e\n      }\n    })\n  }\n\n  \u002F\u002F Async transaction\n  static function queueAsyncWork(policyId : Key) {\n    gw.api.async.AsyncProcess.schedule(\n      \"ProcessPolicy\",\n      \\-> processPolicy(policyId),\n      Date.Now\n    )\n  }\n}\n```\n\n### Plugin Patterns\n\n```gosu\n\u002F\u002F Plugin implementation pattern\npackage gw.plugin.rating\n\nuses gw.plugin.rating.IRatingPlugin\nuses gw.api.util.Logger\n\nclass CustomRatingPlugin implements IRatingPlugin {\n  private static final var LOG = Logger.forCategory(\"CustomRatingPlugin\")\n\n  override function calculatePremium(period : PolicyPeriod) : Money {\n    LOG.info(\"Calculating premium for policy: ${period.PolicyNumber}\")\n\n    var basePremium = calculateBasePremium(period)\n    var discounts = applyDiscounts(period, basePremium)\n    var taxes = calculateTaxes(period, basePremium - discounts)\n\n    return basePremium - discounts + taxes\n  }\n\n  private function calculateBasePremium(period : PolicyPeriod) : Money {\n    \u002F\u002F Base premium calculation logic\n    return period.Lines\n      .map(\\line -> line.calculatePremium())\n      .sum()\n  }\n\n  private function applyDiscounts(period : PolicyPeriod, base : Money) : Money {\n    var totalDiscount = Money.ZERO\n\n    \u002F\u002F Multi-policy discount\n    if (period.Account.Policies.Count > 1) {\n      totalDiscount += base * 0.10\n    }\n\n    \u002F\u002F Good driver discount\n    if (hasGoodDriverDiscount(period)) {\n      totalDiscount += base * 0.15\n    }\n\n    return totalDiscount\n  }\n}\n```\n\n## Output\n\n- Configured Digital SDK with type-safe API calls\n- REST API Client with fault tolerance\n- Gosu patterns following Guidewire best practices\n\n## Error Handling\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| SDK generation failed | Invalid API spec | Verify OpenAPI spec URL and access |\n| Type mismatch | Schema changed | Regenerate SDK |\n| Transaction timeout | Long-running operation | Optimize or use async |\n| Client timeout | Network issues | Increase timeout, add retry |\n\n## Resources\n\n- [Digital SDK Documentation](https:\u002F\u002Fdocs.guidewire.com\u002Fjutro\u002Fdocumentation\u002F10.12\u002Fworking-with-cloud-apis\u002F)\n- [REST API Client Guide](https:\u002F\u002Fdeveloper.guidewire.com\u002Frest-api-client\u002F)\n- [Gosu Language Reference](https:\u002F\u002Fgosu-lang.github.io\u002F)\n- [Query API Documentation](https:\u002F\u002Fdocs.guidewire.com\u002Fcloud\u002Fpc\u002F202503\u002Fcloudapica\u002F)\n\n## Next Steps\n\nFor core insurance workflows, see `guidewire-core-workflow-a` and `guidewire-core-workflow-b`.\n",{"name":5,"author":56,"license":15,"version":57,"description":58,"allowed-tools":59},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Master Guidewire SDK patterns including Digital SDK, REST API Client, and Gosu best practices.\nUse when implementing integrations, building frontends with Jutro, or writing server-side Gosu code.\nTrigger with phrases like \"guidewire sdk\", \"digital sdk\", \"jutro sdk\",\n\"guidewire patterns\", \"gosu best practices\", \"rest api client\".\n","Read, Write, Edit, Bash(npm:*), Bash(gradle:*), Grep","main","90b50ed0778745a80fd5bfb13b1843d45b9e82f7","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fguidewire-pack\u002Fskills\u002Fguidewire-sdk-patterns",233,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-15 01:54:15",{"source":8,"skillName":5,"commands":70,"prompt":80,"zipAvailable":81},[71,74,77],{"tool":72,"command":73},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill guidewire-sdk-patterns",{"tool":75,"command":76},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill guidewire-sdk-patterns",{"tool":78,"command":79},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill guidewire-sdk-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fguidewire-pack\u002Fskills\u002Fguidewire-sdk-patterns\u002FSKILL.md",true,[],[84,116,151,174,200,226],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":88,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":95,"publishedAt":115},"01M6FCR7G5A005P364Z6ZWCJDP","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FSKILL.md",[92],{"categoryNo":93,"categoryName":94,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",[96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114],"theme factory","factory","theme","docs","toolkit","generate","artifacts","SET","fly","slides","landing","html","styling","artifact","pages","themes","with","you","fonts","2026-11-11 15:11:14",{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":88,"licenseFileUrl":120,"sourceHtmlUrl":121,"categories":122,"keywords":126,"publishedAt":51},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[123],{"categoryNo":124,"categoryName":125,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发",[127,128,102,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,40,107,144,145,146,147,148,149,150],"web artifacts builder","web","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","single-file","simple","ui components","multi","for","jsx","suite",{"skillNo":152,"name":153,"nameZh":6,"description":154,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":88,"licenseFileUrl":155,"sourceHtmlUrl":156,"categories":157,"keywords":162,"publishedAt":51},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[158,161],{"categoryNo":159,"categoryName":160,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":124,"categoryName":125,"taxonomyType":21,"taxonomyTypeDesc":22},[163,164,165,131,166,167,128,168,100,169,141,170,171,172,173,112,148],"testing","webapp testing","webapp","screenshots","playwright","debugging","browser","logs","applications","behavior","local",{"skillNo":175,"name":176,"nameZh":6,"description":177,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":178,"sourceHtmlUrl":179,"categories":180,"keywords":181,"publishedAt":51},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[182,183,184,185,186,187,188,189,40,190,191,192,193,194,195,196,112,197,198,199,148,32],"analysis","neuropixels analysis","spike","metrics","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":201,"name":202,"nameZh":6,"description":203,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":88,"licenseFileUrl":204,"sourceHtmlUrl":205,"categories":206,"keywords":210,"publishedAt":51},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[207],{"categoryNo":208,"categoryName":209,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[211,212,213,214,215,216,217,218,44,219,220,221,222,223,112,148,224,32,225],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":227,"name":228,"nameZh":6,"description":229,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":230,"sourceHtmlUrl":231,"categories":232,"keywords":234,"publishedAt":51},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[233],{"categoryNo":208,"categoryName":209,"taxonomyType":21,"taxonomyTypeDesc":22},[228,235,236,237,238,239,50,169,240,241,40,242,243,244,245,148,246],"google","browser automation","gemini","automation","auth","library","management","only","document","query","Citation","source"]