Agent Skills
返回列表
编程基建

编程基建

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_6f8db926/coding-foundation。

技能介绍

解决多阶段编程任务的状态割裂与验证缺失

在复杂的 AI 编程工作流中，将需求设计、编码实现、Bug 修复和代码清理拆分为多个独立 Skill 往往会导致上下文割裂。这种串联方式迫使模型反复加载提示词、重复分析项目结构，不仅浪费上下文窗口，还容易在跨阶段传递时丢失关键状态。更严重的是，许多工作流将“脚本退出成功”或“代码生成完毕”等同于“项目验证通过”，跳过了真实的运行与测试环节，导致交付物无法运行。

单一上下文与内部状态路由

coding-foundation 将 leader、开发、Bug 修复和测试等阶段设计为单一 Skill 内部的轻量领域包，而非外部独立 Skill。它通过 scripts/route_task.ps1 进行内部状态路由，所有阶段共享同一份 .coding-foundation/state.json 上下文，避免重复加载和重复分析。

  • 入口纪律：第一步运行路由脚本，按需调用 collect_context.ps1 采集上下文，并输出当前领域包与门禁状态。
  • 严格分支工作流：

- 新项目：由 leader 严格定义需求与验收合同，一次仅推进一个迭代，杜绝虚构业务或交付不可运行的片段。
- Bug 与清理：修复 Bug 必须提供最小复现与回归测试；执行 /net 清理时，仅处理当前修改涉及的死代码和重复代码，严禁篡改数据库结构、接口契约或异步语义。

  • 新鲜验证证据：任何完成结论都必须附带新鲜验证证据。大文件需使用 scripts/inspect_region.py 局部读取，但验证仍须按项目声明递归执行。

失败回流与适用边界

该技能建立了统一的失败回流机制。所有失败均进入同一个 Bug 路由，但保留原始 returnStage（如测试失败回测试）。系统会记录失败签名与退出码，默认最多自动尝试 3 次，超限则暂停并报告阻塞。

使用时需注意，必须根据任务类型强制读取对应的 references/ 规则文件（如 security.md、code-guard.md）。它不改变项目原有的语言、框架和包结构，而是要求在尊重现有工程习惯的前提下实施约束，不能用来掩饰未经确认的业务逻辑。

使用场景

  • 接手一个技术栈不明确的历史项目，需要先运行项目地图与上下文采集工具，再根据当前任务加载对应规则。
  • 新建项目时需要先由 leader 完成需求、角色、页面流程与验收合同，并在当前迭代内交付可运行代码与验证证据。
  • 排查既有项目的 Bug 时需要采集复现、日志、近期改动与边界输入，先定位根因再增加回归测试并重跑原失败命令。
  • 修改涉及前后端、数据库或联调的代码时需要读取分离与联调规则，执行前后不得改变数据库结构或接口契约。

适合人员

  • 需要在多个任务阶段保持同一项目上下文的后端工程师。
  • 负责维护老项目并希望把 Bug 修复流程标准化的技术负责人。
  • 正在构建 AI 编程工作流并需要状态门禁与验证证据的工程师。
  • 需要用脚本和台账约束 Agent 按迭代交付的自动化团队。