用途:该框架为任意项目提供一套 AI 开发团队契约,定义工作如何运行,包含专业角色智能体与一个强制的、按变更规模调整的工作流。默认免费、开源、厂商中立、编辑器中立,安装为插件后不再依赖全局 CLAUDE.md,会话所需的工作规则都写在该技能中。
主要原则与能力:比例化流程,按变更大小匹配工作流,改错别字与做功能不应同量级;TDD,流程为行为→失败测试→最小代码→通过→重构→提交,目标为单测大于80%、集成测试大于60%;仅行为工单,故事只描述做什么(WHAT)而非怎么做(HOW),不含文件路径或行号;开源优先、不锁定,默认无需付费账户,其他为可选适配器;可复用技能,通用知识放技能,项目专属事实放项目自己的 .claude/skills/。
使用方式:开始开发前及每次交接前,先查阅 workflow-engine 技能,由它分类变更、决定适用的审批门,并可能拒绝通过未满足的闸门。审批门是账本中的标签,如 ARCH_APPROVED、SECOPS_APPROVED、DESIGN_APPROVED、APPROVAL_GATE、CODE_REVIEWED、PERF_OK、VERIFIED、RELIABILITY_OK;安全门是安全覆盖,不因“改动小”而跳过。默认预设为 solo(单人轻量路径),small-team 增加代码审查,regulated 走完整流程。另有 fid-lifecycle、verify-landed、review-tier、model-selection、research-method、answer-audit 等跨切面流程技能。角色命令为标准命令,人设别名调用同一智能体,运行 /agents 查看完整名册。
工单与文档:默认基于文件,用 markdown 工单(Backlog.md)加 markdown 知识库;Jira、Confluence 等后端是可选叠加,仅在 workflow.yaml 中启用。同一件事不要同时用两个追踪器。
Git 约定:分支 feature/<KEY>-desc,提交 <KEY>: message,PR 标题 <KEY>: title,提交前运行测试。公开产物只写事实,不含内部计划、路径、程序名、人设或智能体名称等。
限制:资料未提供具体安装命令、价格与平台信息;部分内容为框架约定描述,落地细节暂未提供。