** Навыки агента с функциональной дисциплиной программирования.

中 Readme

Функциональный навык - это инженерная методология, разработанная для комплексного обслуживания и итерации навыков. В сочетании с регистрацией следов и единичным тестированием он делает навыки модульными, отслеживаемыми и тестируемыми:

Относитесь к каждому Step как Function с явным Input/Output (чистая функция сначала). [Т3] только организует трубопровод [Т4], потребляя только [Т5] и [Т6]. [[Т]] [[Т[8]]] [[Т]]] [[Т[7]]] [[Т]]]] [[Т[8]]]] Детерминистская логика, называемая Function, становится scripts/.

• Добавить отслеживание для каждого Function, работающего локально, запись ввода/вывода/потребления токенов/продолжительность Оборудовать каждый Function единичными тестами и тестами E2E, не обеспечивая ни отдельных функций, ни полного регресса трубопровода.

Быстрый старт

###Установить

Установка через skills.sh. Добавьте -a к целевому агенту; добавьте -g, только если он поддерживает глобальную установку.

Использование

Создать — новый функциональный навык из резюме рабочего процесса:

Миграция — преобразовать существующий каталог навыков в функциональный навык:

На миграционной полосе читается весь набор навыков — «УБИЙТЕ».

Functional Skill Creator

Maintain Agent Skills with functional programming discipline.

中文版 README

Functional Skill is an engineering methodology, designed for complex Skill maintenance and iteration. Combined with trace logging and unit testing, it makes Skills modular, traceable, and testable:

• Treat each Step as a Function with explicit Input/Output (pure function first)
• SKILL.md only orchestrates the pipeline of Functions, consuming only external inputs and reference dependencies
• Shared rules across Functions go into references/
• Deterministic logic called by Functions becomes scripts/
• Add trace logging for every Function, running locally, recording input/output/token consumption/duration
• Equip every Function with unit tests and E2E tests, ensuring neither individual Functions nor the full pipeline regress

Quick Start

Install

npx skills add AGI-comming/functional-skill-creator --skill fskill-creator -y

Install via skills.sh. Add -a to target one agent; add -g only if it supports global install.

---

Usage

Create — new functional skill from a workflow brief:

/fskill-creator create a functional skill for 

Migrate — convert an existing legacy skill directory into a functional skill:

/fskill-creator migrate 

The migrate lane reads the whole skill package — SKILL.md, references/, scripts/, and other companion files — not a single markdown file in isolation.

Optional: include_report, include_unittest, include_viewers (on by default; set to false to skip).

Why

Your Skill is getting bloated.

As your Skill’s capabilities iterate, your SKILL.md and references/*.md grow longer, rules pile up, edge cases get patched ever more finely — slowly turning into an unmaintainable wall of prose.

A typical example is when everything keeps getting stuffed into a handful of markdown files:

Before: monolithic prose wall

flowchart TB
  subgraph mono["Monolithic Skill — tangled dependencies"]
    SKILL["SKILL.mdGoal · Workflow · Rules · Output · Known issues"]
    W["Workflow + Step 1.5 patch"]
    RL["Rules · edge cases · stop rules"]
    OUT["Output handler · validation"]

    RULES["references/rules.mdTerms · policies · snippets"]
    EX["references/examples.mdSuccess · failures · workarounds"]

    S1["parse_input.js"]
    S2["parse_input_new.js"]
    S3["fix_edge_case_once.sh"]
    S4["migrate_old_do_not_delete.js"]
  end

  SKILL  W
  SKILL  RL
  W  RL
  RL  OUT
  SKILL  RULES
  RULES  EX
  EX  W
  OUT  EX
  W --> S1
  RL --> S2
  S1  S2
  S2 --> S3
  S3  EX
  OUT --> S4
  S4  SKILL
  S3  RL
  S1 --> OUT

  style mono fill:#fff5f5,stroke:#c53030
  style SKILL fill:#fde8e8,stroke:#c53030
  style W fill:#fde8e8,stroke:#c53030