documentation

Decide Fit First

• Core job: </applicability> 文档在docs目录下，根据文档类型进行分类存放，如docs/tasks等。 <!-- tomevault:4.0:skill_md:2026-05-22 --> 编写markdown文档 创建任务分配有追踪文档 编写开发指…
• 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 source has limited section structure, so treat it as an invocation rule: trigger, execution boundary, then validation.
• 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 documentation 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 “documentation” 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; 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.