跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

feature

Create, list, or manage feature specs and GitHub issues

yicheng47 · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add yicheng47/runner --skill feature

技能说明


name: feature description: Create, list, or manage feature specs and GitHub issues

Feature Management

Manage Runners' feature pipeline: specs live in docs/features/, tracking lives in GitHub Issues with the feature label.

Usage

/feature <action> [args]

Actions

new <name>

Create a new feature from scratch.

  1. Ask the user to describe the feature (motivation, scope, key decisions).
  2. Assign the next available number by checking existing files in docs/features/.
  3. Create docs/features/{number}-{slug}.md with sections: Motivation, Scope, Implementation Phases, Verification.
  4. Pick a priority (see Priority below). If the user didn't state one, propose one and confirm before filing. Don't file unlabeled.
  5. Create a GitHub Issue with labels feature and the chosen P0/P1/P2/P3:
    • Title: feat: <short description>
    • Body: Motivation, Scope summary, Implementation Phases, and a reference back to the spec file.
    • Command shape: gh issue create --label feature --label P1 --title "…" --body "…"
  6. Update docs/features/README.md to include the new spec.
  7. Report the spec path, issue URL, and assigned priority.

list

Show all features, sorted by priority.

  1. Fetch open features with priority + metadata as JSON so they can be sorted: gh issue list --label feature --state open --limit 50 --json number,title,labels,createdAt,assignees
  2. List all spec files in docs/features/ (excluding README).
  3. Sort the rows by priority (P0 first, then P1, P2, P3, then unlabeled-by-priority last). Within a priority bucket, sort by spec number ascending.
  4. Present a combined view: Priority, feature name, # (issue), spec file (if exists), Created. Issues without a P-label show — in priority and a callout asking the user to triage them.
  5. If the user asks for closed/shipped features too, repeat with --state all and add a State column.

close <issue-number>

Mark a feature as shipped.

  1. Close the GitHub Issue: gh issue close <number>
  2. If a matching spec file exists in docs/features/, move it to docs/features/archive/ with git mv. Shipped code is the source of truth, but the spec stays around as the "what we were going for" record (mirrors docs/impls/archive/).
  3. Update docs/features/README.md to drop the archived entry from the index.

prioritize <issue-number> <P0|P1|P2|P3>

Set or change the priority of an existing feature.

  1. Remove any existing P-label on the issue, then add the new one: gh issue edit <number> --remove-label P0 --remove-label P1 --remove-label P2 --remove-label P3 --add-label <priority> (Removing all four is safe — gh ignores remove-label for labels not present.)
  2. Confirm the new priority.

spec <issue-number-or-name>

Open or create a spec for an existing feature issue.

  1. If a spec file already exists, show its path.
  2. If not, create one following the same format as new, pre-populated from the issue body.

Labels

  • feature — all feature issues use this label.
  • bug — for bug reports (not managed by this skill).
  • P0 / P1 / P2 / P3 — priority, exactly one per issue.

Priority

Every feature gets exactly one priority label. Rubric:

  • P0 — Required for the next ship; nothing else moves until this lands. Rare for features.
  • P1 — Wanted this cycle; blocks an active user workflow or has a stakeholder commitment.
  • P2 — Real product win, but no urgency. Pick up when the P1 queue is clear.
  • P3 — Idea / nice-to-have / "if we ever revisit X." OK to sit indefinitely; closing as wontfix later is fine.

When in doubt between two levels, pick the lower-urgency one and say why; over-labeling P0/P1 dilutes the signal.

Conventions

  • Spec files are numbered sequentially: 01-product-spec.md, 02-ai-quick-explain.md, etc.
  • Slugs are lowercase kebab-case derived from the feature name.
  • Specs for shipped features move to docs/features/archive/ — the implementation is the source of truth, but the spec stays as the "what we were going for" record (mirrors docs/impls/archive/).
  • The docs/features/README.md index only lists in-progress/planned specs.

Notes

  • Do not commit or push unless the user explicitly asks.
  • When creating issues, always include a reference to the spec file path in the issue body.
  • When creating specs, always include a reference to the GitHub issue URL.