AgentSkillsCN

document-service

为 IntexuraOS 服务生成专业级文档。每项服务可产出 5 份文档文件，并同步更新聚合站点内容。支持交互式模式（主动提问）与自主式模式（依据代码自动推断）。当您需要为服务撰写文档、生成文档，或更新服务文档时，可调用此技能。

SKILL.md
--- frontmatter
name: document-service
description: Generate professional documentation for IntexuraOS services. Produces 5 doc files per service plus updates aggregated site content. Supports interactive mode (asks questions) and autonomous mode (infers from code). Use when documenting services, generating docs, or updating service documentation.
argument-hint: '[service-name]'

Document Service

Generate comprehensive documentation for IntexuraOS services.

Usage

code
/document-service                   # List available services (discovery mode)
/document-service <service-name>    # Document service interactively

Autonomous mode: Use Task tool with subagent_type: service-scribe for batch documentation without user interaction.

Core Mandates

  1. •Code-First Analysis: Always analyze actual code before generating docs
  2. •Preserve User Insights: Never lose user-provided context from previous runs
  3. •Incremental Updates: Website content updates are additive, not full regenerations
  4. •Quality Assurance: Self-critique before writing files to disk
  5. •Debt Tracking: Archive resolved items, never delete history

Output Files

Each service produces 5 documentation files:

FilePurposeAudience
features.mdValue propositions, capabilities, use casesUsers, marketing
technical.mdArchitecture, APIs, patterns, gotchasDevelopers, AI agents
tutorial.mdGetting-started tutorial with exercisesNew developers
technical-debt.mdKnown issues, debt items, future plansMaintainers
agent.mdMachine-readable interface (autonomous only)AI agents

Plus website content updates:

FilePurpose
services/index.mdService catalog
site-marketing.mdMarketing pages source
site-developer.mdDeveloper docs source
site-index.jsonStructured metadata
overview.mdProject narrative

Mode Selection

ModeWhen to UseInvocation
DiscoveryList services, check doc status/document-service (no args)
InteractiveDocument one service with user input/document-service <service-name>
AutonomousBatch document all/multiple servicesTask tool → service-scribe

Invocation Detection

Input PatternWorkflow
/document-servicediscovery.md
/document-service <service>interactive.md
Task tool service-scribe subagentautonomous.md

References