SuperAPI AI 工具集

geekx-engineering

编程与开发

查看项目

更新于 11-12 10:20

技能介绍

geekx-engineering 是一个工程类技能,目标是把实质性软件变更推进到可运行、经过验证的结果,适用于用户希望构建功能、修复重大缺陷、重构或调整代码结构、完成迁移,或将规格说明或 Issue 落实为可用实现的场景。

用途与定位 该技能用于在“真实代码库”中实现和演进软件,而不是从零演示。它要求在进行影响重大的变更前充分理解现有系统,以便作出可靠决策。

主要能力与工作方式

  • 理解系统:重点关注与目标行为有关的内容,包括行为由哪个模块负责、接口与契约、权威信息源、依赖关系与数据流、重要不变量、相关测试与既有决策。提倡渐进探索,当不确定性影响决策时再深入阅读,不默认梳理整个仓库。
  • 遵循约定:当仓库约定以及相关语言、框架和领域的成熟实践能切实改善正确性、可维护性、安全性或互操作性时,遵循这些约定;明确的项目约束优先于通用最佳实践。设计上优先简单、可组合、接口清晰且特殊情况少,保持接口精简,但不为缩小接口而拆散内聚行为。
  • 隔离实质性工作:将实质性变更与仓库主要工作状态隔离,优先使用专用分支,除非当前工作区已适当隔离或仓库、Harness 另有工作流规定;已有隔离时不重复创建。
  • 维护计划:在开始实质性实现前创建或更新持久化计划,若已有 Issue、规格说明或项目文档提供等效任务状态则复用。默认位置为 docs/dev/YYYY-MM-DD-<topic>-plan.md。计划围绕结果组织,可包含目标、约束、系统、计划(已完成与下一个结果)、决策、当前状态、证据、待解决/阻塞、下一步等章节,只使用有帮助的章节,避免写成机械的文件编辑或命令清单。计划是暂定的,当前状态才是依据;只记录遗忘后会导致后续工作变慢、不一致或出错的决策,并作为工作记忆而非对话记录。
  • 降低决策成本:自主作出常规工程决策;当重大决策确实取决于用户偏好、授权或风险接受程度时,提供最少但足够有用的选项,并给出推荐及取舍说明。若可视化能帮助理解,可生成自包含的 HTML 决策页面,但仅用于澄清决策。没有需要用户作出的重大决策时,不引入审批关卡。
  • 多 Agent 协调(可选):仅在并行处理、专业分工、独立探索或独立审查能创造实际价值时使用额外 Agent,不为模拟团队角色而创建。多 Agent 参与时以持久化计划作为共享上下文,优先由一个协调 Agent 更新共享状态,执行 Agent 返回发现、变更或证据;不让过期上下文覆盖更新的代码、决策或证据。
  • 以现实为准:仓库状态、运行时行为、测试结果和已观察到的约束优先于假设和早先计划;证据与当前方法矛盾时,相应更新理解、计划和实现。
  • 验证结果:重要完成声明需要与变更相适应的最新证据,验证方式可包括测试、类型检查、构建、运行时检查、集成或端到端行为验证、浏览器或 API 检查、基准测试、最终状态检查或最终 diff 审查。宣布完成前需确认请求结果已实现、重要约束仍成立、相关既有行为无回归、已知失败或未验证部分已明确说明;能直接检查时,不以信心、推理或另一个 Agent 的报告作为证明。
  • 收尾:若工作后续继续,留下足够准确的持久化计划供其他有能力的 Agent 接手;任务完成时,仅当计划仍保留有用项目知识才保留,否则删除。报告应简洁说明做了哪些变更、重要决策、执行了哪些验证、剩余风险或后续事项。

适用场景 适用于功能开发、重大缺陷修复、重构与代码结构调整、迁移、将规格说明或 Issue 落地实现等需要在既有代码库中推进实质变更的工程任务。

限制与暂未提供的信息 该技能不强制使用额外 Agent,多 Agent 为可选项;不设置不必要的审批关卡。关于具体安装方式、支持的平台或工具链、收费与价格等信息,资料中暂未提供。