Decide Fit First

• Core job: node scripts/doc_generator.js <模块路径> 自动生成的 README.md 包含： 自动生成的 DESIGN.md 包含：; runs on Node.js. 自动生成的 README.md 包含： 模块名称 — 从目录名提取…
• Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
• Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

• Structure: The skill is organized around “核心原则”, “自动生成”, “生成内容”, “README.md 骨架”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
• Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
• Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

• Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
• Invocation: Name gen-docs directly; if the source includes slash commands, start with the command and then add task context.
• Validation: Start small and check whether the result follows “核心原则 / 自动生成 / 生成内容” before expanding.

Boundaries And Review

• Dependencies: It usually needs no extra API key, so start with a small validation task.
• Permissions: Declared permissions include read / write; ask the agent to state file, command, and rollback boundaries before acting.
• Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.