init-harness
创建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
TDD Mode (Default: Recommended)
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
ARCHITECTURE.mdexists → use it (fast)- Source code exists → AI scan + auto-save ARCHITECTURE.md
- Empty project → generate from goal
Pre-Init (Recommended)
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