FATASS 是一个把软件项目当作「编译器输入」来管理的 Python 命令行工具:项目被建模为一张节点图,每个节点由 Claude Code CLI 作为自主智能体合成与维护,而不是由人手写文件。我独立完成了节点与变换模型、事务式的命令接口(每次变更可整体提交或回滚),以及一个用 TypeScript 写的 VS Code 扩展,用于可视化浏览项目拓扑。项目目标是让 LLM 编码智能体承担「主编译器」角色,把需求变更收敛为一次可审查、可回退的图变换。适合希望用智能体自动化维护多模块代码库、又要求过程可审计的团队参考。项目仍在持续开发中。
1. 整体架构与设计思路:把软件项目抽象成有向图,节点是最小可独立合成的产物(模块、配置、文档),边表示依赖。设计目标是图可描述、单次变换原子化、全过程可审计。系统分四层:图模型层(节点与变换的数据结构)、执行层(调度 Claude Code CLI 智能体按拓扑序合成节点)、事务层(变换前落快照,成功提交、失败整体回滚)、交互层(命令行与拓扑可视化)。
2. 我负责的模块与结果:独立完成全部设计与实现。技术栈按模块划分——命令行用 Python 3.10+ 与 prompt_toolkit,图模型与事务逻辑用 pytest 覆盖,扩展用 TypeScript 编写;产出为可运行的 CLI 加 VS Code 扩展,已跑通"定义图 → 逐节点合成 → 提交或回滚"闭环。
3. 难点与解决:
1) 智能体输出不可预测——把不确定性关进节点内部,节点只承诺产出一个文件集合,由事务层快照与回滚,失败时整图不变。
2) 节点依赖容易失控——依赖显式写进图,执行前拓扑排序,只喂该节点相关上下文,减少无效调用与上下文长度。
3) CLI 与扩展状态易冲突——以磁盘图定义为唯一事实源,扩展只读,改图必须走 CLI 事务命令。
4) 排错困难——每次变换留存输入与产出,可按节点重放,把定位缩小到单个节点。