技能介绍

要解决什么问题

团队在 TAPD 管需求、在 CNB 做构建与 PR 时，常见断层是：commit 与故事对不上号、main 被直推、推送后 TAPD 故事页看不到代码、以及 PR 里没有自动 AI 评审。OpenAI Harness Engineering 里，意图层（从故事开分支）、约束层（commit 格式与分支保护）、反馈层（CI + AI review + TAPD 回写）往往散落在文档里，零态仓库（无 TAPD API、无 CNB PAT、无组织）更难一次性装齐。

本技能把上述三层落到真实 git 仓库：用脚本与模板装配连接元数据、流水线与钩子，并用决策树区分「完整接入」「只加 commit 约束」「从故事拉分支」等路径。

技能如何工作

完整装配：交互式向导或手工三步，引导获取 workspace_id、TAPD API 账号、CNB PAT 与 group；生成 .codebuddy/connections.yml、.cnb.yml（含 main: push 构建与 pull_request 上的 cnbcool/ai-review:latest）、.tapd.yml、.gitmessage，并安装 commit-msg / pre-push（protect-main、可选 push 时推 TAPD）。
日常工作流：scripts/start-feature.sh 按 TAPD 故事建 feature/* 分支；commit 需带 --story= / --bug= / --task=（或 TAPD 官方完整格式）；PR 合入后依赖 CNB↔TAPD 云原生构建集成，或用 --with-auto-push / push-commit-to-tapd.sh 补推。
最小装配：仅 commit-msg hook，不接 CNB、不改 .cnb.yml，适合已有 CI、只加强约束的团队。
排障：references/troubleshooting.md 覆盖 API 403、CNB API 路径、AI review 未触发等实测问题。

适用边界与注意点

技能不能代你创建 TAPD API 账号与 CNB 令牌；API 账号必须在开放平台勾选目标 workspace 授权。CNB 使用 groups 而非 GitHub 式 orgs，建库路径与字段与 GitHub 不同。直推 main 被拦截是预期行为；临时绕过需 HARNESS_ALLOW_MAIN_PUSH=1，应慎用。深度剧本与集成细节在 references/workflow.md、references/tapd-cnb-integration.md，按需加载而非全部塞进主文档。

截图预览

使用场景

新建或零配置仓库，需要按向导补齐 TAPD workspace、API 账号与 CNB PAT，并生成 .cnb.yml 与 git hooks。
团队已有 Jenkins 等 CI，只想安装 commit-msg，强制每条提交带 --story= / --bug= / --task=，不改远端流水线。
拿到 TAPD 故事 ID 后要开 feature 分支，并自动 slug 化标题、尽量复制官方源码提交关键字。
代码已 push 到 CNB，但 TAPD 故事详情「代码」Tab 无记录，需按文档查集成或运行 push-commit-to-tapd.sh 补推。

适合人员

负责把团队 Git 仓库接入 TAPD 与 CNB、并配置云原生构建源码集成的平台或 DevOps 工程师
按 TAPD 故事迭代功能、需要分支命名与 commit 格式长期符合规范的业务/backend 开发
在 CNB 维护 PR 门禁、希望 pull_request 阶段自动跑 cnbcool/ai-review 并留评的仓库 Maintainer
刚接手仓库、尚无 TAPD/CNB 凭据，需要交互式向导逐步完成 connect 与装配的技术负责人

腾讯云 Harness 最佳实践