type: team
name: updateDocumentDetail
description: Update and optimize document content based on user feedback using diff patches
task_render_mode: collapse
skills:
  - url: ../utils/analyze-document-feedback-intent.yaml
  - type: ai
    instructions:
      - role: system
        url: ../../prompts/detail/update/system-prompt.md
      - role: user
        url: ../../prompts/detail/update/user-prompt.md
    auto_reorder_system_messages: true
    auto_merge_system_messages: true
    input_schema:
      type: object
      properties:
        originalContent:
          type: string
          description: Original markdown content to be updated
        feedback:
          type: string
          description: User feedback for content improvements
        rules:
          type: string
          description: User configuration rules
        locale:
          type: string
          description: User language, e.g. zh, en
        detailDataSource:
          type: string
          description: Context for document content
        glossary:
          type: string
          description: Glossary of terms
        userPreferences:
          type: string
          description: User's saved preferences for content and documentation style
        targetAudience:
          type: string
          description: Target audience for the documentation
        title:
          type: string
          description: Document title
        description:
          type: string
          description: Document description
        needDataSources:
          type: boolean
          description: Whether data sources are needed for content modifications
        path:
          type: string
          description: Document path
      required:
        - originalContent
        - feedback
        - path
    output_key: message
    afs:
      modules:
        - module: system-fs
          options:
            name: sources
            localPath: .
            description: |
              Codebase of the project to be documented used as context for document generation,
              should search and read as needed while generating document content
    keep_text_in_tool_uses: false
    skills:
      - ./document-tools/update-document-content.mjs
      # - ./generate-diagram.yaml