WoJiSama/skill-based-architecture

解决的问题

编码代理经常面临项目规则分散、多个文件（如 CLAUDE.md 或 .cursorrules）中存在重复指令，以及缺乏明确的「完成定义」等问题。基于技能的架构（SBA）将这些分散的指令集中到一个单一的、可路由且可验证的项目「技能」中，确保代理在不猜测实现范围的情况下，严格遵循项目的实际业务逻辑和架构规则。

如何工作

SBA 提供一个项目级别的操作契约，代理使用该契约来导航仓库。与加载一个巨大的指令文件不同，代理会：

1. 盘点 仓库，识别现有规则。
2. 选择 基于用户请求的特定工作流。
3. 加载 当前决策所需的证据和知识。
4. 绑定 将业务含义与当前代码所有者关联。
5. 验证 根据请求的最终状态来验证结果，而不是简单地将命令或提交视为「完成」。
6. 记录 从失败中提取可复用的学习，防止问题再次发生。

适用对象

项目指令已变得过大难以导航，或在不同代理入口文件之间存在矛盾，或重复任务需要严格流程和可靠完成检查的开发者和团队。

特点

• 集中化知识：消除 AGENTS.md、CLAUDE.md 和 Cursor 规则之间的重复。
• 与代理无关：兼容 Claude Code、Cursor、Windsurf、Gemini CLI 以及其他文件感知代理。
• 基于证据的执行：采用结果导向的生命周期，若证据否定当前前提，则返回本地化或分解阶段。
• 自动化迁移：包含一个脚手架工具，可预览并应用现有规则向 SBA 结构的迁移。
• 严格的完成纪律：基于绑定的交付物和最终状态定义「完成」，而非简单的活动（如推送或提交）。