用途:该技能为常驻(always-on)型,适用于每一次提出实现计划或编辑代码的对话,也可在功能上线后记录实现方式、新增抽象前检查复用、做重构与架构评审时使用;当用户提出“别过度设计”“记录系统”“工程笔记”等诉求时同样适用。
主要能力与原则执行:KISS 对超大文件告警、极端情况报错,倾向扁平模块;YAGNI 标记缺乏明确复用价值的抽象命名,计划门禁对新增 Factory/Manager 且未引用复用来源的情况报错;DRY 维护 reuse-catalog.md,UI 侧可串联 @no-duplicate-ui;SOLID 对臃肿路由告警,要求视图薄、服务厚;可测试性会提示缺少冒烟测试的视图。子代理默认通过 Task shell 委派 audit_engineering.py、check_engineering_plan.py 与文档初始化,主对话负责解读结果并更新活文档。
使用方式:每个对话编码前执行计划门禁 python scripts/check_engineering_plan.py --project-root <root> --check(有书面计划时加 --plan-file);项目首次执行 python scripts/init_engineering_docs.py --project-root <root>;编码中在新建组件、composable 或服务前先读 reuse-catalog.md;有实质改动后更新 architecture.md 模块图并补复用行;遇到不易判断的取舍时用 append_decision.py --title … --context … --decision … 记录 ADR;每次编辑后跑审计 audit_engineering.py --check(error 失败、warn 提示,仅当用户要求阻断 warn 时才用 --strict)。所有产物必须放在 .heyeddi/docs/ 下,不要放仓库根目录:architecture.md 记录系统图、数据流与边界,reuse-catalog.md 记录已有内容避免重建,decisions.md 存工程 ADR,审计报告为 engineering-audit-<date>.md;设计决策仍留在 .heyeddi/design.md,两者不要混放。
适用场景与限制:适合需要长期保持架构整洁、控制抽象膨胀和文档沉淀的代码库;任务完成时可用 python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill engineering-excellence --project-root . 获取下一步建议,审计刚结束可加 --mode audit。资料中未提供支持的编程语言、具体平台限制、收费方式或价格信息,暂未提供。