Method
方法
实现规划驱动的 AI 辅助编程。AI 编码迅捷,而易偏移、易失上下文。这套 AI 原生的工程方法约束 AI,使每步可验收、可交付。纪律本身亦由 AI 执行,是一条技能链。
观察收敛(RC)
工程纪律与产品技能,都从观察收敛(RC)长出。核心动作是观察锁定:逐节生长根因链,每一节先验证再采信。三条红线与保真度机制因此是原理性的,不是拍脑袋。
工程链(14)
一条可审的主干,加两个入口、两条逆向入口、两个支撑。描述你要什么,链条无人值守跑完。
入口:engineer-job(全自建)、engineer-next(续跑)。逆向入口:engineer-cloner、engineer-legacy-recon。支撑:engineer-coach、engineer-advisor。
蓝图轨迹
每一步都留下持久化产物。蓝图是唯一真源。上下文膨胀时,重开会话并指向蓝图,而非硬撑。
- REQUIREMENTS.md 有界上下文、业务事件、依赖、状态机
- CONTEXT.md 系统全景、数据模型、API 契约、里程碑依赖树
- FRONTEND-DESIGN.md 页面树、组件树、状态管理、UI 状态机、设计 token
- POC-MANIFEST.md mock 到真实的演进映射(可选)
- .agents/ job.state.json / progress.json / qa-latest.md,跨会话进度持久
三条红线
不可妥协。每条配它的违反后果。
无蓝图不开工
需求、架构、前端设计出文档前不写代码。否则从第一步就偏移。
未验收不固化
验收前不提交、不固化。否则偏移累积。
乱了就重建
会话缠成一团时,重置上下文、从持久蓝图重建。否则上下文腐烂、状态幻觉。
保真度机制
凭什么信 AI 的产出。每个逆向与 POC 都交一张诚实账,三级标注。不谎称后端源码,不裸抄资源,不把 mock 当真实。
- CLONE-FIDELITY.md engineer-cloner / 可观察精确 / 推断 / 不可观察
- RECON-FIDELITY.md engineer-legacy-recon / 明示 / 推断 / 缺口
- POC-FIDELITY.md engineer-poc / 真实交互 / mock 数据 / 占位未实现
测试门禁
engineer-qa 是测试门禁的唯一真源,功能开发后自动触发。单元、集成、E2E 三层。变更代码分支覆盖不低于 90%,配全局不回退棘轮。无 UI 项目降级为黑盒验收。裁决落 .agents/qa-latest.md:通过、需修、或重建。
22 个技能
方法的全部可安装件。工程 14 是主干,产品与 RC 是同源生态。
同源生态
仓库与安装
方法是 22 个开源可安装技能。可复制,坐实为可安装。
git clone https://github.com/iannil/skills && cd skills
./install.sh 或 npx iannil/skills install all。标准安装器:npx skills add iannil/skills --skill '*'。