feature-lifecycle

stars-end 的头像作者 stars-end

A suite of skills to manage the full development lifecycle from start to finish.- `start-feature`: Initializes a new feature branch, docs, and story.- `sync-feature`: Saves work with CI checks.- `finish-feature`: Verifies and creates a pull request.

📖 中文导读:A suite of skills to manage the full development lifecycle from start to finish.- `start-feature`: Initializes a new feature branch, docs, and story.- `sync-feature`: Saves work with CI checks.- `finish-feature`: Verifies and creates a pull request. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: feature-lifecycle description: | A suite of skills to manage the full development lifecycle from start to finish. - start-feature: Initializes a new feature branch, docs, and story. - sync-feature: Saves work with CI checks. - finish-feature: Verifies and creates a pull request. tags: [workflow, git, feature, beads, dx]

Feature Lifecycle Skills

This file defines the three core skills for agent-driven development.


start-feature <issue-id>

Purpose: Initializes a new feature branch with all required scaffolding. Forces a "Test-First" mindset by creating the story skeleton.

Usage:

# From any product repo (affordabot, prime-radiant-ai)
feature-lifecycle/start.sh bd-123

BDD Spec:

  • Given I am in a product repo
  • And I provide a Beads issue ID bd-123
  • When I run start-feature bd-123
  • Then a new branch feature-bd-123 is created
  • And a doc file docs/bd-123.md is created
  • And a story file docs/testing/stories/story-bd-123.yml is created

sync-feature [options] <message>

Purpose: The "Save Button" for agents. Ensures all commits are clean by running ci-lite before saving. Prevents pushing broken code.

Usage:

# From a feature branch, commit valid work
feature-lifecycle/sync.sh "feat: add new login button"

# Force save broken work (e.g., to switch branches)
feature-lifecycle/sync.sh --wip "refactor: halfway through API change"

BDD Spec:

  • Given I have syntax errors in my code
  • When I run sync-feature 'my commit'
  • Then the commit is BLOCKED and I receive an error to fix.
  • But when I run sync-feature --wip 'my commit'
  • Then the commit is created with a [WIP] prefix.

finish-feature

Purpose: The "Handoff" to the QA/Merge phase. Runs the full PR verification suite before a PR is created, preventing review spam with broken code.

Usage:

# When a feature is complete and ready for review
feature-lifecycle/finish.sh

BDD Spec:

  • Given I am on a feature branch
  • And the make verify-pr target fails
  • When I run finish-feature
  • Then the PR creation is BLOCKED and I am instructed to check the verification artifacts.