One-click install
npx skills add https://github.com/liqunx/wikiflow --skill wf-plan-liqunx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wf-plan
Source: https://github.com/liqunx/wikiflow/tree/main/skills/wf-plan
Command: npx skills add https://github.com/liqunx/wikiflow --skill wf-plan-liqunx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

wf-plan prevents code and implementation from drifting away from the documentation by forcing a document-first planning step, including Wiki discovery and the generation of spec.md and tasks.md for traceable execution.

Core Features & Use Cases

  • Wiki-first planning: Automatically matches relevant Wiki pages (or uses --wiki when provided) and blocks planning when no related Wiki can be found.
  • Spec + task generation: Produces a spec.md and a tasks.md in the active changes folder, based on user input and a structured question flow.
  • Guardrails for correctness: Enforces execution in the documentation repository (checks .wikiflow/config.json and docs/wiki/) and prevents duplicate active changes by slug uniqueness.

Quick Start

Ask your AI assistant to generate a document-first plan for your change by running: /wf-plan "添加注册功能".

Frequently Asked Questions about wf-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a documentation-first development plan with spec and task files?

To generate a documentation-first development plan, you use a workflow that produces a spec.md and tasks.md file. This process matches relevant Wiki pages first, ensuring your implementation stays traceable to current documentation before coding begins.

Why do I need to match Wiki pages before writing code for a new feature?

Matching Wiki pages before writing code prevents implementation drift by forcing a document-first planning step. It discovers existing context and blocks planning when no related Wiki can be found, ensuring traceability for new features and bug fixes.

Can I write a development plan if my repository has no Wiki documentation?

You cannot write a development plan without Wiki documentation because the workflow enforces Wiki-first planning. It checks for a valid documentation repository configuration and blocks the generation of spec.md and tasks.md if no related Wiki is found.

What is the best way to prevent duplicate active changes in a documentation repository?

The best way to prevent duplicate active changes is to enforce slug uniqueness during the document-first planning step. The workflow validates repository types and blocks planning if an active change with the same slug already exists.

How does automatic Wiki search work when planning a bug fix?

Automatic Wiki search works by scanning your documentation repository and matching relevant pages using confidence thresholds. When planning a bug fix, it automatically retrieves context or uses a manually provided Wiki reference to generate traceable output files.

Does documentation-first planning support generating tasks in different languages?

Documentation-first planning supports generating tasks in different languages by writing the plan outputs into the active changes path using the configured language. This ensures the generated spec.md and tasks.md match your project's language settings.