云原生CI/CDDevOps后端【免费下载链接】pipelineA cloud-native Pipeline resource.项目地址https://gitcode.com/gh_mirrors/pipelin/pipeline点击查看免费下载导读本指南围绕 skills/tekton-pipeline-discovery/SKILL.md 这一仓库内置的 Agent 技能展开它定义了在 Tekton Pipelines云原生 Pipeline 资源中快速定位源码、理解仓库结构、遵守贡献规范并高效提交变更的标准工作流。读完本文你将掌握一套「先读地图、再读领域文档、后改代码、最后按规范提交」的实战路径同时获得go test、代码生成校验、Agent 就绪检查等关键命令的用法与底层原理能够像维护者一样在数分钟内找到正确的文件并评估改动的影响面。技能定位第一次进入仓库时该做什么SKILL.md的 frontmatter 中声明了该技能的名称tekton-pipeline-discovery与用途在编辑、评审或调试 Tekton Pipelines 代码之前用它完成对仓库的第一遍熟悉。技能的核心原则是帮你快速找到正确的文件而不是成为一套重复的项目规则It should help you find the right files quickly without turning into a second set of project rules.。它之所以存在是因为 Tekton Pipelines 是一个大型的 Kubernetes 控制器项目——包含Task、TaskRun、Pipeline、PipelineRun、CustomRun以及各类 resolver 对象配套的二进制有 controller、webhook、entrypoint、events 与远程 resolver见 docs/agents/agent-context.md 的 What this repo does。面对这样规模的仓库Agent 或新贡献者最容易迷失方向而该技能提供的就是一条经过维护者验证的「快速上手路径」。技能在仓库中的落地方式值得注意skills/tekton-pipeline-discovery/SKILL.md是唯一的内容源而.agents/skills/、.claude/skills/、.codex/skills/、.cursor/skills/四个目录下分别存在指向它的符号链接。这一点由 hack/verify-agent-readiness.sh 严格校验脚本要求.agents、.claude、.codex三个链接必须指向../../skills/tekton-pipeline-discovery且必须是可解析的目录链接否则检查直接失败。这意味着同一个技能文件可被 GitHub 官方 Agent、Claude、Codex、Cursor 等多种 Agent 生态统一发现与加载是仓库面向 Agent 协作的标准化基础设施。上手路径Start here技能给出的起点是一个三层递进结构先读AGENTS.md——它是面向 Agent 的全仓库速览告诉你仓库形状repo shape、改代码前要读什么、有哪些实用检查命令AGENTS.md。文件本身被脚本限制在 60 行以内见verify-agent-readiness.sh中的max_agents_lines60刻意保持轻量只做方向性引导。用 docs/agents/agent-context.md 作为仓库地图——该文档以表格形式给出「路径 → 用途」映射例如cmd/controllerController 二进制与 reconciler 装配cmd/webhook默认值、校验与转换 webhookcmd/entrypoint注入到 step 容器中的进程包装器pkg/apis/pipelineAPI 类型、默认值、校验与转换pkg/reconciler/taskrun与pkg/reconciler/pipelinerunTaskRun/PipelineRun 的协调逻辑pkg/podPod 与 entrypoint 构造辅助internal私有辅助包新增非 API 代码优先放这里config安装清单与 CRDteste2e/一致性测试hack代码生成、校验与发布脚本。它还给出了运行时路径runtime path用户创建资源 → webhook 默认/校验/转换 → reconciler 通过生成的 informer 监听 → TaskRun 构建 Pod 与 entrypoint → PipelineRun 解析依赖图并创建子运行 → resolver 拉取远程定义 → 事件/通知控制器发布状态变化。这条链路是理解任何具体模块在整个系统中的位置的骨架。再读你要改动的领域对应的文档——技能明确列出的常用文档为 CONTRIBUTING.md、DEVELOPMENT.md、api_compatibility_policy.md、test/README.md 以及 docs/developers/ 下的开发者文档如 controller-logic.md、taskruns.md、results-lifecycle.md、tracing.md 等。这套路径的设计逻辑是AGENTS.md给出全貌agent-context.md给出精确的坐标领域文档给出该目录的细节三者组合后Agent 就能在动手前建立「这个改动落在系统哪个环节、影响哪些 API 与控制器」的完整认知。工作准则Working notes技能的「Working notes」部分浓缩了维护者对变更的基本期望每条都值得展开理解让改动小到维护者无需猜测意图即可评审。这与 CONTRIBUTING.md 强调的贡献标准一脉相承也是大型 K8s 控制器项目 review 效率的关键。先测试你改动的包再跑宽泛的测试套件。Tekton Pipelines 的测试分为单测与 e2e单测默认被go test ./...覆盖而 e2e 必须显式加-tagse2e见 test/README.md。单测与业务代码同目录存放controller 的单测大量使用 client-go 的 fake client 与生成的 fake PipelineClientpkg/client/clientset/versioned/fake例如用fakepipelineclientset.NewSimpleClientset()初始化无对象客户端再通过 informer 的 indexer 注入测试对象。这意味着「改哪个包就先测哪个包」在技术上完全可行且反馈最快。优先在internal/下新增私有辅助函数除非代码本身就是公开 API。这与AGENTS.md和agent-context.md的建议一致——当前仓库的 internal/ 下就承载了 artifactref、sidecarlogresults 等内部实现包。不要手改生成代码或vendor/。仓库中pkg/clientclientset/informers/listers、pkg/apis下的zz_generated.deepcopy.go、config/下的 CRD 清单、docs/pipeline-api.md等都属于生成产物。需要更新时应运行对应的hack/update-*脚本如 hack/update-codegen.sh而不是手工编辑。CRD/API 行为改动前必须先检查兼容性字段、默认值、status、标签或生成客户端的变化都会影响用户既有实例。这正是 api_compatibility_policy.md 约束的范围——它把 CRD 的spec/status结构、status 中 step 的排序与命名、从 PipelineRun 传播到 TaskRun 再到 Pod 的标签、执行容器内目录结构、cmd/下镜像接口都定义为「API 的一部分」并明确了 v1 稳定 CRDTask/TaskRun/Pipeline/PipelineRun与 beta CRDCustomRun、ResolutionRequest各自的变更策略以及 v1beta1 旧 CRD 的弃用状态。e2e 变更遵循 test/README.md 中的分类与注解e2e 测试通过test:executionparallel|serial注解声明执行模式TestMaintest/init_test.go用 Go AST 解析这些注解并编排执行顺序serial 先跑、parallel 并行、未标注的最后修改共享集群状态如system.Namespace()下的 ConfigMap、feature-flags的测试必须标记为serial。常用命令Common commands技能给出的三条命令是「改动前自检」的核心这里结合仓库源码说明其作用与原理go test ./pkg/... # 覆盖 pkg 下所有包的单元测试 ./hack/verify-codegen.sh # 校验生成代码与源码一致 ./hack/verify-agent-readiness.sh # 校验 AGENTS.md 与技能发现配置go test ./pkg/...运行pkg/下所有包的单元测试。技能刻意不推荐一上来就跑go test ./...因为test/目录下的 e2e 测试带有 build tag需要-tagse2e才会执行聚焦pkg/...可以快速覆盖 API 类型、reconciler、pod 构造、substitution 等核心逻辑且这些包都有大量与源码并置的测试文件如pkg/reconciler/taskrun/taskrun_test.go、pkg/pod/pod_test.go。./hack/verify-codegen.sh该脚本hack/verify-codegen.sh会把当前的pkg/、vendor/、docs/、config/复制到临时目录然后执行hack/update-codegen.sh重新生成全部代码再与工作区做diff。任何不一致都会导致失败并提示「Please run hack/update-codegen.sh」。也就是说它验证的是「提交的生成产物是否与源码定义完全同步」——这正是上一节「不要手改生成代码」规则的自动化兜底。./hack/verify-agent-readiness.sh面向 Agent 生态的就绪检查hack/verify-agent-readiness.sh。它校验三件事AGENTS.md存在且不超过 60 行skills/tekton-pipeline-discovery/SKILL.md存在.agents/、.claude/、.codex/三个 skill 链接必须指向../../skills/tekton-pipeline-discovery且能解析为目录。脚本成功时输出agent readiness checks passed。对于只改动agent-context.md这类 Agent 文档的 PR它就是最合适的定向检查。提交 PRPR notes技能的 PR 部分把提交流程收敛为四条可执行规则遵循 .github/pull_request_template.md。模板包含 Changes 描述、Submitter Checklist文档、测试、pre-commit、提交信息规范、kind 标签等和 Release Notes 三块。保持release-note块准确仅在无任何用户可见影响时使用NONE。模板中默认填入NONE但技能强调它是「默认占位」而非「偷懒选项」——凡是涉及 API 变更、bug 修复、升级提示或弃用警告的 PR都必须如实填写 release notes。仅当 PR 完全解决某个 issue 时才使用Fixes #...。这是一个语义约定Fixes会触发 GitHub 自动关闭 issue部分解决或只是相关引用时不应使用。仅改动 agent 文档agent-context-only的 PR用./hack/verify-agent-readiness.sh作为定向检查。这与技能的定位完全呼应——该脚本就是为这类「元层面」改动设计的轻量验证无需触发完整单测或 e2e。此外CONTRIBUTING.md 还提到项目提供了/cherry-pick合并后自动将 PR cherry-pick 到多个目标分支如release-v0.47.x与/rebase对非 fork 分支安全重基使用--force-with-lease两个 slash 命令可用于协作场景中的分支管理。技能背后的工程实践为什么这套路径有效将整个技能拆开看它实际上是把 Tekton Pipelines 多年沉淀的工程规范压缩成了 Agent 可执行的清单三层文档结构AGENTS.md方向→agent-context.md地图→ 领域文档细节每一层都刻意保持精简避免「规则文件膨胀」。生成代码与手写代码的边界凡是pkg/client、zz_generated.*、CRD 清单、docs/pipeline-api.md等生成产物一律通过 hack/update-codegen.sh内部调用generate-groups.sh生成 deepcopy/client/informer/lister覆盖pipeline:v1alpha1,v1beta1,v1、resolution、resource:v1alpha1等 API 组统一再生成再用verify-codegen.sh做 diff 校验。测试的分层与标注单测无 tag、e2e-tagse2e、一致性测试-tagsconformance、feature-flags 测试-tagsfeatureflags相互隔离e2e 内部再用注解区分 parallel/serial配合-category标志go test -tagse2e -categoryserial ./test实现安全的并发编排。API 兼容性红线任何对 CRD 字段、默认值、状态或生成客户端的改动都要先对照 api_compatibility_policy.md 判断是否构成破坏性变更并运行对应更新脚本。对于 Agent 而言这套技能的最终价值在于它把「在 Tekton Pipelines 中第一次动手」的成本从「通读数万行代码」降为「按三层地图精确着陆」。任何编辑、评审或调试任务都可以从AGENTS.md→docs/agents/agent-context.md→ 对应领域文档这条路径开始再用go test ./pkg/...与hack/verify-*脚本闭环验证——这正是仓库为 AI 协作时代准备的标准化入场券。赞分享云原生CI/CDDevOps后端【免费下载链接】pipelineA cloud-native Pipeline resource.项目地址https://gitcode.com/gh_mirrors/pipelin/pipeline点击查看免费下载相关推荐Cesium 中的 glTF 属性纹理实战以 SimplePropertyTexture 测试资产解析 EXT_structural_metadata 扩展Cesium 中的 glTF 属性纹理实战以 SimplePropertyTexture 测试资产解析 EXT_structural_metadata 扩展云原生CI/CDDevOps后端Lepton 仓库开发指南面向 AI 编码 Agent 与开发者的 Electron React 代码库导航与实践Lepton 仓库开发指南面向 AI 编码 Agent 与开发者的 Electron React 代码库导航与实践 导读 Lepton 是一个基于 Git桌面应用开发工具Sandboxie 仓库开发者协作指南解读面向 AI Agent 与贡献者的仓库导航、构建入口与安全边界Sandboxie 仓库开发者协作指南解读面向 AI Agent 与贡献者的仓库导航、构建入口与安全边界 本文以 Sandboxie 仓库根目录的 AGENT应用安全虚拟化桌面应用上一篇freeCodeCamp 每日编程挑战解析Challenge 119 词级字符串压缩String Compression下一篇ViMax终极指南如何用一句话生成专业级AI视频的10个技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Tekton Pipelines 仓库发现指南：面向 AI Agent 与开发者的代码导航与贡献技能
云原生CI/CDDevOps后端【免费下载链接】pipelineA cloud-native Pipeline resource.项目地址https://gitcode.com/gh_mirrors/pipelin/pipeline点击查看免费下载导读本指南围绕 skills/tekton-pipeline-discovery/SKILL.md 这一仓库内置的 Agent 技能展开它定义了在 Tekton Pipelines云原生 Pipeline 资源中快速定位源码、理解仓库结构、遵守贡献规范并高效提交变更的标准工作流。读完本文你将掌握一套「先读地图、再读领域文档、后改代码、最后按规范提交」的实战路径同时获得go test、代码生成校验、Agent 就绪检查等关键命令的用法与底层原理能够像维护者一样在数分钟内找到正确的文件并评估改动的影响面。技能定位第一次进入仓库时该做什么SKILL.md的 frontmatter 中声明了该技能的名称tekton-pipeline-discovery与用途在编辑、评审或调试 Tekton Pipelines 代码之前用它完成对仓库的第一遍熟悉。技能的核心原则是帮你快速找到正确的文件而不是成为一套重复的项目规则It should help you find the right files quickly without turning into a second set of project rules.。它之所以存在是因为 Tekton Pipelines 是一个大型的 Kubernetes 控制器项目——包含Task、TaskRun、Pipeline、PipelineRun、CustomRun以及各类 resolver 对象配套的二进制有 controller、webhook、entrypoint、events 与远程 resolver见 docs/agents/agent-context.md 的 What this repo does。面对这样规模的仓库Agent 或新贡献者最容易迷失方向而该技能提供的就是一条经过维护者验证的「快速上手路径」。技能在仓库中的落地方式值得注意skills/tekton-pipeline-discovery/SKILL.md是唯一的内容源而.agents/skills/、.claude/skills/、.codex/skills/、.cursor/skills/四个目录下分别存在指向它的符号链接。这一点由 hack/verify-agent-readiness.sh 严格校验脚本要求.agents、.claude、.codex三个链接必须指向../../skills/tekton-pipeline-discovery且必须是可解析的目录链接否则检查直接失败。这意味着同一个技能文件可被 GitHub 官方 Agent、Claude、Codex、Cursor 等多种 Agent 生态统一发现与加载是仓库面向 Agent 协作的标准化基础设施。上手路径Start here技能给出的起点是一个三层递进结构先读AGENTS.md——它是面向 Agent 的全仓库速览告诉你仓库形状repo shape、改代码前要读什么、有哪些实用检查命令AGENTS.md。文件本身被脚本限制在 60 行以内见verify-agent-readiness.sh中的max_agents_lines60刻意保持轻量只做方向性引导。用 docs/agents/agent-context.md 作为仓库地图——该文档以表格形式给出「路径 → 用途」映射例如cmd/controllerController 二进制与 reconciler 装配cmd/webhook默认值、校验与转换 webhookcmd/entrypoint注入到 step 容器中的进程包装器pkg/apis/pipelineAPI 类型、默认值、校验与转换pkg/reconciler/taskrun与pkg/reconciler/pipelinerunTaskRun/PipelineRun 的协调逻辑pkg/podPod 与 entrypoint 构造辅助internal私有辅助包新增非 API 代码优先放这里config安装清单与 CRDteste2e/一致性测试hack代码生成、校验与发布脚本。它还给出了运行时路径runtime path用户创建资源 → webhook 默认/校验/转换 → reconciler 通过生成的 informer 监听 → TaskRun 构建 Pod 与 entrypoint → PipelineRun 解析依赖图并创建子运行 → resolver 拉取远程定义 → 事件/通知控制器发布状态变化。这条链路是理解任何具体模块在整个系统中的位置的骨架。再读你要改动的领域对应的文档——技能明确列出的常用文档为 CONTRIBUTING.md、DEVELOPMENT.md、api_compatibility_policy.md、test/README.md 以及 docs/developers/ 下的开发者文档如 controller-logic.md、taskruns.md、results-lifecycle.md、tracing.md 等。这套路径的设计逻辑是AGENTS.md给出全貌agent-context.md给出精确的坐标领域文档给出该目录的细节三者组合后Agent 就能在动手前建立「这个改动落在系统哪个环节、影响哪些 API 与控制器」的完整认知。工作准则Working notes技能的「Working notes」部分浓缩了维护者对变更的基本期望每条都值得展开理解让改动小到维护者无需猜测意图即可评审。这与 CONTRIBUTING.md 强调的贡献标准一脉相承也是大型 K8s 控制器项目 review 效率的关键。先测试你改动的包再跑宽泛的测试套件。Tekton Pipelines 的测试分为单测与 e2e单测默认被go test ./...覆盖而 e2e 必须显式加-tagse2e见 test/README.md。单测与业务代码同目录存放controller 的单测大量使用 client-go 的 fake client 与生成的 fake PipelineClientpkg/client/clientset/versioned/fake例如用fakepipelineclientset.NewSimpleClientset()初始化无对象客户端再通过 informer 的 indexer 注入测试对象。这意味着「改哪个包就先测哪个包」在技术上完全可行且反馈最快。优先在internal/下新增私有辅助函数除非代码本身就是公开 API。这与AGENTS.md和agent-context.md的建议一致——当前仓库的 internal/ 下就承载了 artifactref、sidecarlogresults 等内部实现包。不要手改生成代码或vendor/。仓库中pkg/clientclientset/informers/listers、pkg/apis下的zz_generated.deepcopy.go、config/下的 CRD 清单、docs/pipeline-api.md等都属于生成产物。需要更新时应运行对应的hack/update-*脚本如 hack/update-codegen.sh而不是手工编辑。CRD/API 行为改动前必须先检查兼容性字段、默认值、status、标签或生成客户端的变化都会影响用户既有实例。这正是 api_compatibility_policy.md 约束的范围——它把 CRD 的spec/status结构、status 中 step 的排序与命名、从 PipelineRun 传播到 TaskRun 再到 Pod 的标签、执行容器内目录结构、cmd/下镜像接口都定义为「API 的一部分」并明确了 v1 稳定 CRDTask/TaskRun/Pipeline/PipelineRun与 beta CRDCustomRun、ResolutionRequest各自的变更策略以及 v1beta1 旧 CRD 的弃用状态。e2e 变更遵循 test/README.md 中的分类与注解e2e 测试通过test:executionparallel|serial注解声明执行模式TestMaintest/init_test.go用 Go AST 解析这些注解并编排执行顺序serial 先跑、parallel 并行、未标注的最后修改共享集群状态如system.Namespace()下的 ConfigMap、feature-flags的测试必须标记为serial。常用命令Common commands技能给出的三条命令是「改动前自检」的核心这里结合仓库源码说明其作用与原理go test ./pkg/... # 覆盖 pkg 下所有包的单元测试 ./hack/verify-codegen.sh # 校验生成代码与源码一致 ./hack/verify-agent-readiness.sh # 校验 AGENTS.md 与技能发现配置go test ./pkg/...运行pkg/下所有包的单元测试。技能刻意不推荐一上来就跑go test ./...因为test/目录下的 e2e 测试带有 build tag需要-tagse2e才会执行聚焦pkg/...可以快速覆盖 API 类型、reconciler、pod 构造、substitution 等核心逻辑且这些包都有大量与源码并置的测试文件如pkg/reconciler/taskrun/taskrun_test.go、pkg/pod/pod_test.go。./hack/verify-codegen.sh该脚本hack/verify-codegen.sh会把当前的pkg/、vendor/、docs/、config/复制到临时目录然后执行hack/update-codegen.sh重新生成全部代码再与工作区做diff。任何不一致都会导致失败并提示「Please run hack/update-codegen.sh」。也就是说它验证的是「提交的生成产物是否与源码定义完全同步」——这正是上一节「不要手改生成代码」规则的自动化兜底。./hack/verify-agent-readiness.sh面向 Agent 生态的就绪检查hack/verify-agent-readiness.sh。它校验三件事AGENTS.md存在且不超过 60 行skills/tekton-pipeline-discovery/SKILL.md存在.agents/、.claude/、.codex/三个 skill 链接必须指向../../skills/tekton-pipeline-discovery且能解析为目录。脚本成功时输出agent readiness checks passed。对于只改动agent-context.md这类 Agent 文档的 PR它就是最合适的定向检查。提交 PRPR notes技能的 PR 部分把提交流程收敛为四条可执行规则遵循 .github/pull_request_template.md。模板包含 Changes 描述、Submitter Checklist文档、测试、pre-commit、提交信息规范、kind 标签等和 Release Notes 三块。保持release-note块准确仅在无任何用户可见影响时使用NONE。模板中默认填入NONE但技能强调它是「默认占位」而非「偷懒选项」——凡是涉及 API 变更、bug 修复、升级提示或弃用警告的 PR都必须如实填写 release notes。仅当 PR 完全解决某个 issue 时才使用Fixes #...。这是一个语义约定Fixes会触发 GitHub 自动关闭 issue部分解决或只是相关引用时不应使用。仅改动 agent 文档agent-context-only的 PR用./hack/verify-agent-readiness.sh作为定向检查。这与技能的定位完全呼应——该脚本就是为这类「元层面」改动设计的轻量验证无需触发完整单测或 e2e。此外CONTRIBUTING.md 还提到项目提供了/cherry-pick合并后自动将 PR cherry-pick 到多个目标分支如release-v0.47.x与/rebase对非 fork 分支安全重基使用--force-with-lease两个 slash 命令可用于协作场景中的分支管理。技能背后的工程实践为什么这套路径有效将整个技能拆开看它实际上是把 Tekton Pipelines 多年沉淀的工程规范压缩成了 Agent 可执行的清单三层文档结构AGENTS.md方向→agent-context.md地图→ 领域文档细节每一层都刻意保持精简避免「规则文件膨胀」。生成代码与手写代码的边界凡是pkg/client、zz_generated.*、CRD 清单、docs/pipeline-api.md等生成产物一律通过 hack/update-codegen.sh内部调用generate-groups.sh生成 deepcopy/client/informer/lister覆盖pipeline:v1alpha1,v1beta1,v1、resolution、resource:v1alpha1等 API 组统一再生成再用verify-codegen.sh做 diff 校验。测试的分层与标注单测无 tag、e2e-tagse2e、一致性测试-tagsconformance、feature-flags 测试-tagsfeatureflags相互隔离e2e 内部再用注解区分 parallel/serial配合-category标志go test -tagse2e -categoryserial ./test实现安全的并发编排。API 兼容性红线任何对 CRD 字段、默认值、状态或生成客户端的改动都要先对照 api_compatibility_policy.md 判断是否构成破坏性变更并运行对应更新脚本。对于 Agent 而言这套技能的最终价值在于它把「在 Tekton Pipelines 中第一次动手」的成本从「通读数万行代码」降为「按三层地图精确着陆」。任何编辑、评审或调试任务都可以从AGENTS.md→docs/agents/agent-context.md→ 对应领域文档这条路径开始再用go test ./pkg/...与hack/verify-*脚本闭环验证——这正是仓库为 AI 协作时代准备的标准化入场券。赞分享云原生CI/CDDevOps后端【免费下载链接】pipelineA cloud-native Pipeline resource.项目地址https://gitcode.com/gh_mirrors/pipelin/pipeline点击查看免费下载相关推荐Cesium 中的 glTF 属性纹理实战以 SimplePropertyTexture 测试资产解析 EXT_structural_metadata 扩展Cesium 中的 glTF 属性纹理实战以 SimplePropertyTexture 测试资产解析 EXT_structural_metadata 扩展云原生CI/CDDevOps后端Lepton 仓库开发指南面向 AI 编码 Agent 与开发者的 Electron React 代码库导航与实践Lepton 仓库开发指南面向 AI 编码 Agent 与开发者的 Electron React 代码库导航与实践 导读 Lepton 是一个基于 Git桌面应用开发工具Sandboxie 仓库开发者协作指南解读面向 AI Agent 与贡献者的仓库导航、构建入口与安全边界Sandboxie 仓库开发者协作指南解读面向 AI Agent 与贡献者的仓库导航、构建入口与安全边界 本文以 Sandboxie 仓库根目录的 AGENT应用安全虚拟化桌面应用上一篇freeCodeCamp 每日编程挑战解析Challenge 119 词级字符串压缩String Compression下一篇ViMax终极指南如何用一句话生成专业级AI视频的10个技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考