Agent skill

Feature Guide

by ArtisanCloud in ArtisanCloud/PowerX

生成 PowerX 功能使用指导文档(人性化、可执行、与实现对齐)。强制包含业务背景、模块关系、流程图、泳道图、页面/接口/命令步骤、验收、排障、回滚与代码映射。

Apache-2.0Auto-check: notesBackend & APIs

Install Feature Guide

skills CLI
$ npx skills add ArtisanCloud/PowerX --skill feature-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ArtisanCloud/PowerX feature-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ArtisanCloud/PowerX.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/docs/feature-guide .claude/skills/feature-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
feature-guide
GitHub stars
379
Token cost
~791 tokens
SKILL.md length
231 words
Files
3
Skills in repo
21
Repo updated
First seen
Licence
Apache-2.0

At a glance

生成 PowerX 功能使用指导文档(人性化、可执行、与实现对齐)。强制包含业务背景、模块关系、流程图、泳道图、页面/接口/命令步骤、验收、排障、回滚与代码映射。

  • Works in 2 steps: 流程图(必须) → 泳道图(必须)
  • Backend & APIs work in your project
  • SKILL.md covers 适用场景, 目标, 必须遵守的文档结构(强制) and 图示规范(强制), plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Feature Guide is an agent skill from ArtisanCloud/PowerX. 生成 PowerX 功能使用指导文档(人性化、可执行、与实现对齐)。强制包含业务背景、模块关系、流程图、泳道图、页面/接口/命令步骤、验收、排障、回滚与代码映射。

Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `readme.md` and `templates/feature-guide-template.md`).

It sits in Backend & APIs. The repository describes itself as: PowerX是一款以企业微信为基础的微信私域运营开放平台,帮助企业实现引流获客、精细运营。 The licence is Apache-2.0.

When your agent uses it

  • Backend & APIs work in your project

Example prompts

  • “/feature-guide”

Requirements

  • Docker

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. 流程图(必须)
  2. 泳道图(必须)

What it can do on your machine

Read from SKILL.md and the folder at commit 3f7619d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Feature Guide loads about 791 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 231 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~791

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:74
    - [ ] 配置项名称、默认值与优先级说明一致(`.env`/配置文件/运行时覆盖)。

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ArtisanCloud/PowerX at commit 3f7619d, republished under its Apache-2.0 licence (© ArtisanCloud). 231 words, ~791 tokens.

Download SKILL.mdSave it as .claude/skills/feature-guide/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
feature-guide
description
生成 PowerX 功能使用指导文档(人性化、可执行、与实现对齐)。强制包含业务背景、模块关系、流程图、泳道图、页面/接口/命令步骤、验收、排障、回滚与代码映射。

PowerX 功能使用指导文档技能(Feature Guide)

适用场景

当你需要为 PowerX 平台能力编写“可直接执行、跨角色可协作”的功能文档时使用本技能。典型场景:

  • 新功能上线,需要给研发/QA/运维/项目负责人一份可照着操作的手册。
  • 功能已经实现,但现有文档偏实现细节,缺少端到端操作链路。
  • 需要把“Web Admin 页面 + Admin/Tenant API + 后端实现 + 观测指标”串成闭环。

目标

输出一份可执行 + 可验收 + 可追溯的 PowerX 文档,满足:

  1. 先讲清“为什么做”(业务背景/痛点/目标)。
  2. 再讲清“谁在什么环境下怎么用”(角色、范围、限制)。
  3. 给出“从 0 到跑通”的操作步骤(页面、接口、命令、预期结果、失败处理)。
  4. 关键行为可追溯到代码实现(路由/handler/service/config/test)。
  5. 包含流程图与泳道图,帮助跨角色理解协作与边界。

必须遵守的文档结构(强制)

最终文档必须按以下顺序组织章节:

  1. 功能背景与目标
  2. 角色与适用范围(谁看、在哪个环境用)
  3. 整体架构与模块关系(含模块关系图)
  4. 核心流程(含流程图)
  5. 跨角色协作流程(含泳道图)
  6. 前置条件与依赖(配置、权限、数据、Feature Flag)
  7. 操作步骤(按场景拆分)
    • 页面操作步骤(Web Admin)
    • 接口调用步骤(Admin/Tenant API)
    • 本地联调步骤(backend/web-admin/脚本)
  8. 预期结果与验收标准
  9. 代码实现映射(路由/服务/配置/测试)
  10. 常见问题与排障
  11. 回滚与风险控制
  12. 变更记录(版本、日期、责任人)

图示规范(强制)

1) 流程图(必须)
  • 使用 Mermaid flowchart LR 或 flowchart TD
  • 必须包含“输入/处理/输出/失败分支”
  • 至少体现 1 条失败分支与回退路径
2) 泳道图(必须)
  • 使用 Mermaid flowchart LR + subgraph 模拟泳道
  • 至少 3 条泳道(示例:Web Admin、PowerX Backend、External System)
  • 必须标明跨泳道调用方向与返回结果

写作风格规范(强制)

  • 先结论后细节。
  • 每个步骤必须包含:
    • 动作(做什么)
    • 入口/命令(在哪做)
    • 预期结果(看到什么算成功)
    • 失败处理(失败后看哪里)
  • 面向使用者写作,不假设读者了解全部实现细节。
  • 禁止脱离实现:文档关键行为都必须能在代码中定位。

PowerX 代码对齐检查清单(发布前必过)

  • 文档中的路由前缀与实际一致(如 /api/v1/admin、/api/v1/tenant)。
  • 配置项名称、默认值与优先级说明一致(.env/配置文件/运行时覆盖)。
  • 页面入口与按钮文案与当前 Web Admin UI 一致。
  • 接口请求/响应示例与 DTO/handler 行为一致。
  • 文档提到的 feature flag / 权限 / 开关在当前分支真实存在。
  • 至少 1 条测试或脚本命令可验证主链路。
  • 观测项(日志字段、指标名、trace_id)可在运行环境检索。

执行步骤(建议流程)

  1. 收集上下文

    • 读取 specs/<feature-id>/spec.md|plan.md|tasks.md|quickstart.md(如存在)
    • 读取后端路由注册、关键 handler/service、配置结构、测试用例
    • 读取 Web Admin 页面入口与交互流程(如涉及前端)
  2. 梳理功能地图

    • 功能入口:页面/API/命令
    • 核心链路:handler -> service -> repository/integration
    • 输出与观测:日志、指标、事件、trace
  3. 先画图再写步骤

    • 先产出模块关系图、主流程图、泳道图
    • 再填操作步骤,确保步骤连续可执行
  4. 补齐验收与排障

    • 每个场景定义“成功判定”
    • 列出常见失败场景与定位命令
  5. 做代码映射表

    • 每个关键文档步骤至少映射一个代码路径

输出模板

  • 使用模板:templates/feature-guide-template.md
  • 允许按具体功能微调章节名,但不得删除“流程图、泳道图、代码映射、验收、排障”章节。

默认输出路径规范(强制)

未被用户显式指定输出路径时,使用以下规则:

  1. 输入为 specs/<feature-id>/... 时:
    • 若 <feature-id> 或 spec 主题属于“部署/运维”(如 deploy、docker、systemd、ops、backup、migration):
      • 默认输出目录:docs/guides/deploy/<feature-id>/
    • 其他功能:
      • 默认输出目录:docs/guides/features/<feature-id>/
    • 默认主文档:guide.md
  2. 目录不存在时,先创建目录再写入。
  3. 目标文件已存在时,默认执行“覆盖更新”(保留结构,按当前实现刷新)。
  4. 仅在用户明确要求时,才写入 specs/ 下临时文档。

Use Case 拆分规则(强制)

必须根据实际场景自动判断是否拆分多文档:

  1. 仅 1 条独立主链路:输出 guide.md 单文档。
  2. 多条可独立验收链路:输出
    • guide.md(总览:背景、模块、依赖、验收总则、索引)
    • usecase-<slug>.md(每条链路一份)
  3. <slug> 规则:
    • 优先稳定标识(us1、scenario-a)+ 语义短名
    • 仅使用小写字母、数字、连字符
  4. guide.md 必须包含 Use Case 索引表(文件名 + 适用角色 + 验收口径)。

示例要求(最少)

文档至少包含:

  • 1 个页面操作示例(路径、按钮、成功提示)
  • 1 个接口调用示例(curl + 响应片段)
  • 1 个本地联调示例(启动命令 + 日志/指标检查)

完成定义(DoD)

满足以下条件才算文档完成:

  • 新同学不看代码,也可按文档独立跑通主流程。
  • QA 可按文档复现至少 1 条成功路径与 1 条失败路径。
  • 文档中路径、参数、接口在当前分支可定位到实现。
  • 流程图与泳道图覆盖主链路且不与实现冲突。

© ArtisanCloud, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in .codex/skills/docs/feature-guide of ArtisanCloud/PowerX.

  • SKILL.md
  • readme.md
  • templates/feature-guide-template.md

Open the folder on GitHubat commit 3f7619d

Compare with similar skills

Feature Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Feature Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Feature Guide this skillArtisanCloud/PowerX379—~791Automated safety check: NotesApache-2.0
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api43k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    43k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed

More from ArtisanCloud/PowerX

All 21 skills in this repo
  • API Naming

    ArtisanCloud/PowerX

    PowerX API 命名与访问规范(/api/v1、/admin、/internal 边界). An agent skill from ArtisanCloud/PowerX.

    379 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Capability Governance

    ArtisanCloud/PowerX

    PowerX 底座 Capability 治理与发布准入规则。用于审计 REST/OpenAPI/gRPC/Gin 生成的能力候选、正式 platformcapabilities 目录、Capability Registry 登记、agentusable/permissioncode/risklevel 元数据、ignore…

    379 GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Crud Di

    ArtisanCloud/PowerX

    PowerX CRUD 依赖注入规则(Deps 单入口、构造注入、跨传输复用). An agent skill from ArtisanCloud/PowerX.

    379 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Crud Grpc

    ArtisanCloud/PowerX

    PowerX CRUD gRPC 开发规范(proto、server、拦截器、错误映射). An agent skill from ArtisanCloud/PowerX.

    379 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Crud Handler HTTP

    ArtisanCloud/PowerX

    PowerX HTTP Handler 规则(绑定校验、统一回包、无 DB IO). An agent skill from ArtisanCloud/PowerX.

    379 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Crud HTTP

    ArtisanCloud/PowerX

    PowerX CRUD HTTP 开发规范(管理端路由、绑定、错误桥接、多租户). An agent skill from ArtisanCloud/PowerX.

    379 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Feature Guide

What does Feature Guide do?

生成 PowerX 功能使用指导文档(人性化、可执行、与实现对齐)。强制包含业务背景、模块关系、流程图、泳道图、页面/接口/命令步骤、验收、排障、回滚与代码映射。. Feature Guide is an agent skill from ArtisanCloud/PowerX.

When should I use Feature Guide?

Feature Guide fits situations like: backend & APIs work in your project.

How do I install Feature Guide in Claude Code?

Run `npx skills add ArtisanCloud/PowerX --skill feature-guide -a claude-code`. Or copy the skill folder (.codex/skills/docs/feature-guide in ArtisanCloud/PowerX) into .claude/skills/feature-guide in your project. Claude Code loads it when a task matches its description.

How do I install Feature Guide in Codex?

Run `npx skills add ArtisanCloud/PowerX --skill feature-guide -a codex`. Or copy the skill folder (.codex/skills/docs/feature-guide in ArtisanCloud/PowerX) into .agents/skills/feature-guide in your project. Codex loads it when a task matches its description.

Can I use Feature Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ArtisanCloud/PowerX --skill feature-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/feature-guide, .gemini/skills/feature-guide, .github/skills/feature-guide and .opencode/skills/feature-guide in your project.

What does Feature Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Feature Guide is instructions for the agent only. Our summary lists: Docker.

Does Feature Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Feature Guide safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Feature Guide use?

Feature Guide is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Feature Guide use?

About 791 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Feature Guide?

Skills that share tags, products or a category with Feature Guide: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 43k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Feature Guide?

ArtisanCloud (a GitHub organization) maintains it in ArtisanCloud/PowerX, which has 379 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 8, 2026.

Source: ArtisanCloud/PowerX on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.