ai-factory.feature 是一个面向功能开发全流程的 AI 技能，来自 lee-to/ai-factory 项目，旨在把「建分支、做计划、执行」串成一条可重复的工作流。
【用途】 用于开始一个新功能、增强、修复或重构任务：自动创建 Git 分支、规划实现方案，并在需要时继续执行实现，从而完成一次端到端的功能开发循环。
【工作流程】
- 加载项目上下文：优先读取 .ai-factory/DESCRIPTION.md（若存在），获取技术栈（语言、框架、数据库）、项目架构与既有约定，用于影响分支命名、任务规划与实现。
- 确保 Git 仓库：通过下列命令检测并在必要时初始化： git rev-parse --is-inside-work-tree 2>/dev/null || git init
- 解析参数：从 $ARGUMENTS 中提取 --parallel（并行 worktree 模式）、--list（列出所有活动 worktree 及功能状态）、--cleanup <branch>（移除 worktree 并可选删除分支）。解析时会把这几个标记从 $ARGUMENTS 中剥离，剩余文本作为功能描述。--list 与 --cleanup 为独立子命令，执行后立即停止，不再继续后续步骤。
- 解析功能描述：提取要新增的核心功能、关键领域术语以及类型（feature、enhancement、fix、refactor）。
- 生成分支名：格式为 <type>/<short-description>，示例包括 feature/user-authentication、feature/stripe-checkout、feature/product-search、fix/cart-total-calculation、refactor/api-error-handling。规则为小写加连字符、最长 50 字符、除连字符外不含特殊字符、描述性强且简洁。
- 询问测试与日志偏好：会显式询问是否编写测试、日志级别（Verbose 推荐 / Standard / Minimal，默认 verbose，可用 LOG_LEVEL 环境变量配置并要求日志轮转）、是否在实现后更新文档（/ai-factory.docs），以及是否有特定需求或约束。这些偏好会传递给 /ai-factory.task 与 /ai-factory.implement。
- 创建分支或 worktree：普通模式会 git checkout main、git pull origin main 后创建并切换到新分支；若分支已存在则询问是切换还是换名。并行模式（--parallel）则执行 git branch <branch-name> main 与 git worktree add ../${DIRNAME}-<branch-name-with-hyphens> <branch-name>，并把上下文文件（.ai-factory/DESCRIPTION.md、.ai-factory/patches/、.claude/，以及未被 git 跟踪的 CLAUDE.md）复制到 worktree，同时创建 .ai-factory/features 目录。
- 调用任务规划：以 /ai-factory.task 生成计划文件，文件名由分支名转换而来（把 / 替换为 -，加 .md），例如分支 feature/user-authentication 对应 .ai-factory/features/feature-user-authentication.md（而非 .ai-factory/PLAN.md）。这样可基于当前 git 分支恢复工作。
- 下一步动作：普通模式在规划后停止，用户审阅计划后自行执行 /ai-factory.implement；并行模式会自动调用 /ai-factory.implement，实现隔离 worktree 内的自主端到端执行。规划后上下文较重，技能会建议通过 /clear、/compact 或继续三种方式之一释放空间。
【子命令】 --list：执行 git worktree list，并检查各 worktree 的 .ai-factory/features/ 是否包含计划文件、计划是否完成，按格式列出后停止。 --cleanup <branch>：计算 worktree 路径后执行 git worktree remove，并执行 git branch -d（非 -D，未合并会失败以保证安全）；若分支未合并会提示强制删除或先合并的命令；若路径不存在则提示查看 git worktree list。
【适用场景】 适合在已有 Git 仓库的项目中以规范流程推进单个功能：串行开发一个功能并先审阅计划，或用 --parallel 并行开发多个功能，每个功能有独立工作目录与独立的 Claude Code 会话。
【限制与注意事项】 技能文档强调：创建计划前必须询问测试偏好，不得假设；测试与日志偏好需传递给下游技能；git 操作失败要明确报告且不要继续；不要在同一目的的分支已存在时直接创建。
【暂未提供的信息】 关于收费、价格、所支持的平台范围、实际效果评测等，资料中未提供。