AI 开发助手项目接入技能

技能版本：v1.0.2 整理日期：2026-09-13 适配工具：Trae / CodeBuddy / Claude Code / opencode

定位

本技能解决"如何在项目中快速接入 AI 辅助开发流程"的问题。核心产出是一套标准化的参考资料包，包含项目级 AI 助手配置、需求/设计/测试/审查模板和快捷指令 Workflow，帮助团队在不改变既有研发流程的前提下降低 AI 开发助手的上下文准备成本。

1. 部署流程

1.1 一键部署（推荐）

技能包内置部署脚本，一次操作即可完成"把技能包全部文件复制到目标项目根目录 + 规则文件落地到 .trae/.codebuddy 点目录"。包根目录的 deploy.cmd / deploy.sh 是最短入口，它只做"定位技能包 + 调用 scripts/ 下脚本"，参数完全一致。

按"傻瓜程度"从高到低排列，任选一种即可。

方式 A：跟 AI 说一句话（最省事，强烈推荐）

在目标项目里对 AI 说 "把 assist-skills 部署到当前项目"（或"接入 AI 开发流程"），AI 会读取本说明并执行部署脚本。全程不需要记路径、不需要敲命令、不需要配别名。

前提：本机已安装过技能包一次（clawhub install assist-skills，全局生效），或目标项目里已内嵌技能包（见方式 D）。

方式 B：Windows 双击（零输入）

• 技能包已内嵌在项目里（如 tools\assist-skills\）：双击 deploy.cmd 即可，脚本自动识别项目根目录并部署，不需要输入任何内容。
• 技能包在全局安装位置：双击 deploy.cmd，按提示输入目标项目目录（直接回车 = 当前目录）。

脚本自动优先使用 PowerShell 7（pwsh），未安装时回退 Windows PowerShell。

方式 C：右键「发送到」（配一次，长期一键）

先执行一次：

"%USERPROFILE%\.openclaw\workspace\skills\assist-skills\deploy.cmd" -Shortcuts

它会在 Windows 的**「发送到」菜单和桌面**创建"部署AI开发助手(assist-skills)"。之后：

在资源管理器中右键任意项目文件夹 → 发送到 → 部署AI开发助手(assist-skills) → 完成。

对完全不想碰命令的同事，这是最友好的一种。

方式 D：团队分发——把技能包内嵌进项目（队友零依赖）

项目负责人执行一次：

:: 部署 + 把技能包内嵌到 <项目>\tools\assist-skills
"%USERPROFILE%\.openclaw\workspace\skills\assist-skills\deploy.cmd" -Target "D:\your-project" -Vendor

提交后，项目自带部署入口。队友克隆仓库后只需双击 tools\assist-skills\deploy.cmd 即可零输入完成接入，完全不需要安装 ClawHub、不需要技能包、不需要任何命令。

内嵌位置可用 -VendorDir 调整（默认 tools\assist-skills）；内嵌时会自动排除 _meta.json、.clawhubignore、.clawhub 等安装元数据。

方式 E：命令行一行

:: Windows：包根目录的 deploy.cmd，自动定位 scripts\deploy.ps1
"%USERPROFILE%\.openclaw\workspace\skills\assist-skills\deploy.cmd" D:\your-project

# macOS / Linux
bash ~/.openclaw/workspace/skills/assist-skills/deploy.sh --target ~/my-project

也支持配别名（function ai-deploy { & "$HOME\.openclaw\workspace\skills\assist-skills\deploy.cmd" @args }）或直接调用 scripts/deploy.ps1 / scripts/deploy.sh，两者参数与新入口完全一致。

给 AI 助手（重要）：当用户说"部署 AI 开发助手""把 assist-skills 拷到项目里""接入 AI 开发流程""初始化 AI 开发流程"时，不要逐个文件手工复制，也不要让用户自己敲命令，按下面顺序自行完成：

1. 定位技能包目录：优先本机内嵌副本（项目下 tools\assist-skills\）；否则 ClawHub 安装位置 ~/.openclaw/workspace/skills/assist-skills；再否则本地仓库中的 assist-skills/（以本 SKILL.md 所在目录为准）。
2. 执行部署：deploy.cmd -Target <项目根>（Windows）/ bash deploy.sh --target <项目根>（macOS、Linux）。当前目录就是项目根时可省略 -Target。
3. 用户提到"给团队/让队友也能用"时，追加 -Vendor 把技能包内嵌到项目。
4. 部署完成后提示用户在对话里输入"初始化项目"，以便预填 AGENTS.md 第 1-4 节。

已有的交付物不要重复覆盖：脚本默认跳过同名文件，只有用户明确要求覆盖时才加 -Force。

脚本参数：

脚本行为：

• 目标目录不存在时自动创建
• 默认不覆盖已有文件，冲突时打印 [跳过]（确认可覆盖后再加 -Force / --force 重跑）
• 内嵌布局自动识别：技能包位于项目子目录（如 <项目>\tools\assist-skills）且项目带 .git、pom.xml、package.json 等标记时，双击即按该项目根部署，零输入；缺少标记时只要求回车确认一次
• 安全边界：拒绝把技能包自身、技能包内部、以及"技能包恰为其直属子目录的上级目录"当作目标（防止把 40+ 个文件误铺到技能包源码仓库根目录）
• 防不可见字符：自动清洗路径首尾的 BOM / 零宽字符并忽略大小写比较，避免"看起来正确的路径"绕过上述校验
• 结束时打印"新写入 / 覆盖 / 跳过"统计

1.2 手工部署（不使用脚本时）

规则文件在技能包内放在非点号目录 rules/（ClawHub 打包会过滤点号开头的条目，直接放 .trae/、.codebuddy/ 会随包丢失），手工部署分两步：

# 第 1 步：只复制本包自身文件到项目根目录（保留项目已有业务代码与测试）
Copy-Item "assist-skills\AGENTS.md","assist-skills\CLAUDE.md","assist-skills\VERSION.md" -Destination "D:\your-project"
Copy-Item "assist-skills\ai-pilot" -Destination "D:\your-project\ai-pilot" -Recurse

# 第 2 步：使用 Trae / CodeBuddy 时，把规则文件复制改名到项目点目录（工具只在项目根读取这两个路径）
New-Item -ItemType Directory -Force "D:\your-project\.trae\rules","D:\your-project\.codebuddy\rules" | Out-Null
Copy-Item "assist-skills\rules\trae-poc-rule.md" "D:\your-project\.trae\rules\poc-rule.md"
Copy-Item "assist-skills\rules\codebuddy-poc-rule.md" "D:\your-project\.codebuddy\rules\poc-rule.md"

手工部署只新增文件，不删除项目内容。目标目录会新增：AGENTS.md、CLAUDE.md、VERSION.md、ai-pilot/、.trae/rules/poc-rule.md、.codebuddy/rules/poc-rule.md；若上述同名文件已存在，请先确认内容再决定是否覆盖。

只使用 Claude Code 或 opencode 时，第 2 步可跳过（两者只读 CLAUDE.md、AGENTS.md）。

部署后目标项目新增以下目录和文件：

your-project/
  AGENTS.md                          项目级AI助手配置（opencode原生读取）
  CLAUDE.md                          Claude Code引用桥接
  VERSION.md                         版本与分发说明
  .trae/rules/poc-rule.md            Trae项目规则（由 rules/trae-poc-rule.md 落地）
  .codebuddy/rules/poc-rule.md       CodeBuddy项目规则（由 rules/codebuddy-poc-rule.md 落地）
  ai-pilot/
    README.md                        使用说明
    standards/                       15个标准模板
    reference/
      workflows/                     10个快捷指令Workflow
      metrics-definition.md          度量口径定义
      quick-commands.md              快捷命令参考

1.3 初始化项目

在 AI 对话中输入"初始化项目"，AI 扫描项目并预填 AGENTS.md 第 1-4 节（项目概览、技术栈、目录结构、构建与测试命令）。

1.4 补充确认

人工补充业务背景、确认 AI 推断结果后，开始使用 AI 工具。

2. 标准模板体系（15个）

ai-pilot/standards/ 目录下，按研发流程排列：

3. 快捷指令 Workflow（10个）

ai-pilot/reference/workflows/ 目录下，覆盖从项目初始化到任务完成的全流程：

4. 任务复杂度分级

按任务周期选择对应的上下文模板，避免过度或不足的文档产出：

5. 工具适配

6. 检查清单

• 已按 1.1 的方式 A~E 之一完成部署（AI 一句话 / 双击 / 右键发送到 / 内嵌分发 / 命令行）
• 目标项目根目录已出现 AGENTS.md、CLAUDE.md、VERSION.md、ai-pilot/
• -SkipRules 未开启时，.trae/rules/poc-rule.md、.codebuddy/rules/poc-rule.md 已就位
• AGENTS.md 第 1-4 节已预填并确认
• 业务背景已补充
• 团队分发场景：已用 -Vendor 内嵌技能包，并确认 tools\assist-skills\deploy.cmd 可双击部署
• 团队成员已了解快捷指令用法（必要时先用 -Shortcuts 建好右键入口）
• 度量口径（metrics-definition.md）已阅读

核心文件