init-harness

mylukin 的头像作者 mylukin

创建AI代理任务管理结构,包含功能待办事项列表(ai/feature_list.json)、TDD强制执行和进度跟踪。在设置agent-foreman、初始化功能驱动开发、创建功能待办事项列表或启用TDD模式时使用。触发词包括'init harness'(初始化工具)、'setup feature tracking'(设置功能跟踪)、'create feature backlog'(创建功能待办事项列表)、'enable strict TDD'(启用严格TDD)、'initialize agent-foreman'(初始化agent-foreman)。

📖 中文导读:创建AI代理任务管理结构,包含功能待办事项列表(ai/feature_list.json)、TDD强制执行和进度跟踪。在设置agent-foreman、初始化功能驱动开发、创建功能待办事项列表或启用TDD模式时使用。触发词包括'init harness'(初始化工具)、'setup feature tracking'(设置功能跟踪)、'create feature backlog'(创建功能待办事项列表)、'enable strict TDD'(启用严格TDD)、'initialize agent-foreman'(初始化agent-foreman)。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: init-harness description: Creates AI agent task management structure with feature backlog (ai/tasks/), TDD enforcement, and progress tracking. Use when setting up agent-foreman, initializing feature-driven development, creating task backlog, or enabling TDD mode. Triggers on 'init harness', 'setup feature tracking', 'create feature backlog', 'enable strict TDD', 'initialize agent-foreman'. allowed-tools: [Bash, Read, Glob, Grep, Write, Edit] user-invocable: true

⚡ Init Harness

One command: agent-foreman init

Quick Start

agent-foreman init

Creates: ai/tasks/, ai/progress.log, ai/init.sh, CLAUDE.md

During init, you'll be prompted for TDD mode. Recommended is the default (tests suggested but not required).

User Says TDD Mode Effect
"strict TDD" / "require tests" strict Tests REQUIRED - check/done fail without tests
"recommended" / "optional tests" / (default) recommended Tests suggested but not enforced
"disable TDD" / "no TDD" disabled No TDD guidance

The prompt auto-skips after 10 seconds with recommended mode.

Modes

Mode Command Effect
Merge (default) agent-foreman init Keep existing + add new features
Fresh agent-foreman init --mode new Replace all features
Preview agent-foreman init --mode scan Show without changes

Task Types

Type Command Use Case
Code (default) agent-foreman init Software development
Ops agent-foreman init --task-type ops Operational tasks, runbooks
Data agent-foreman init --task-type data ETL, data pipelines
Infra agent-foreman init --task-type infra Infrastructure provisioning
Manual agent-foreman init --task-type manual Manual-only verification

Auto-Detection

  1. ARCHITECTURE.md exists → use it (fast)
  2. Source code exists → AI scan + auto-save ARCHITECTURE.md
  3. Empty project → generate from goal

For existing projects:

agent-foreman init --analyze    # First: understand project
agent-foreman init              # Then: create harness

Created Files

ai/
├── tasks/              # Task backlog (modular markdown)
│   ├── index.json      # Task index
│   └── {module}/       # Module directories
│       └── {id}.md     # Individual tasks
├── progress.log        # Session audit log
├── init.sh             # Bootstrap script
└── capabilities.json   # Detected test/lint/build
CLAUDE.md               # AI agent instructions
docs/ARCHITECTURE.md    # Auto-generated architecture doc