Code Dev

规范的 Git 开发流程：分支管理 → 开发 → PR → Review → 合并。 支持新 feature 开发和 bug 修复，强制禁止直接推送到 main。 触发于 "开发", "实现", "新功能", "修复", "提交 PR", "创建分支"。

Security Scan

该技能是纯说明性的 Git 开发流程助手，所需权限和行为与其“规范 Git 工作流、创建分支并提交 PR”的描述相符，没有发现不成比例的环境/安装要求或可疑外部接入点。

Purpose & Capability

名称和描述宣称是 Git 开发/分支/PR 流程规范；SKILL.md 只包含关于分支、开发、测试、审查和用 gh 创建 PR 的步骤，与目的相符。未请求与此无关的环境变量、二进制或外部凭证。

Instruction Scope

运行时指令只建议在本地仓库中执行 git/gh 命令、阅读代码库、运行测试/lint，并可调用平台的 subagent/sessions_spawn 与可选的 code-review 技能；这些行为都在实现工作流所需的范围内。未指示读取系统范围的配置或任意外发数据到不明端点。

Install Mechanism

无安装规范（instruction-only），不会在磁盘上下载或安装外部包，风险较低。

Credentials

声明不需要环境变量或凭证；实际使用的 gh/git 将依赖用户环境的现有认证（正常情况）。没有请求与技能目的不相关的密钥或多个外部凭证。

Persistence & Privilege

技能未要求 always:true，也不尝试修改其他技能或系统配置。允许模型调用（默认）是平台常态且在此情形下合理；技能会在可用时触发 subagent 来运行任务，这是其设计的一部分。

Assessment

这是一个以文本/模板形式提供的 Git 工作流助手——安装风险低但在使用前请注意： - 确保在正确的仓库目录运行该技能（它会执行 git push 与 gh pr create，可能改变远端仓库）。 - 该技能假定系统已有 git 和 gh（GitHub CLI）；若缺失需要自行安装并登录。gh 将使用你当前的 GitHub 凭证/token 来创建 PR，请确认该 token 的权限和作用域符合你的安全策略。 - 技能可调用平台的 subagent 来自动执行任务：如果你不希望代理自动推送或创建 PR，请在调用前手动审核生成的命令或限制该技能的自动权限。 - 虽然技能本身没有请求额外凭证或外部 URL，但在运行时会读取并修改仓库内容并与远端交互；请避免在包含敏感凭据的仓库中未经审查地自动运行。

Git Workflow Skill

安全的 Git 开发流程。

---

⚠️ 核心规则

• ❌ 禁止直接推送到 main 分支
• ❌ 禁止跳过 PR 流程
• ❌ 禁止在未理解代码库的情况下开发新功能
• ❌ 禁止在未找到 Bug 根因的情况下修复 Bug
• ✅ 必须从 develop 创建新分支
• ✅ 必须通过 PR 合并到 develop
• ✅ 使用 code-review 技能审查代码（如可用）

---

前置检查

执行前检查环境能力：

// 检查 subagent 支持
const supportsSubagent = await checkSubagentSupport();

// 检查 code-review 技能
const hasCodeReview = await checkSkillAvailable("code-review");
if (!hasCodeReview) {
  console.log("⚠️ 未安装 code-review 技能，请手动审查代码");
}

---

执行流程

1. 任务分析

• 确定类型：feature / fix / docs / refactor
• 生成分支名：feature/xxx, fix/xxx
• 确认目标分支 = develop

2. 代码库理解（Feature 必需）

检查清单：

• □ 是否已有类似 helper/util？
• □ 会影响哪些现有功能？
• □ 需要修改哪些文件？
• □ 哪些代码不必要修改？

避免：重复实现、影响当前功能、修改不必要代码

3. Bug 根因调研（Fix 必需）

调研清单：

• □ Bug 的具体表现？
• □ 触发条件？
• □ 根因位置？
• □ 修复方案及影响范围？

禁止：未找到根因就修复、只修复表面症状

4. 分支创建

git checkout develop
git pull origin develop
git checkout -b {type}/{name}

5. 开发实施

必须包含：

• ✅ 代码实现（最小修改范围）
• ✅ 单元测试
• ✅ 文档更新
• ✅ 类型检查通过
• ✅ Lint 通过

6. 代码审查

如安装了 code-review 技能：

sessions_spawn({
  runtime: "subagent",
  mode: "run",
  task: `使用 code-review 技能审查当前变更：
         - 分支: {branchName}
         - 对比: develop...HEAD`
});

如无 code-review 技能：提示用户手动审查

7. 提交 PR

git push origin {branchName}
gh pr create --base develop --head {branchName} \
  --title "{type}: {描述}" \
  --body "{PR 描述}"

---

分支命名

类型	格式	示例
Feature	feature/{name}	feature/auth
Fix	fix/{name}	fix/cors
Docs	docs/{name}	docs/api
Refactor	refactor/{name}	refactor/db

---

更多参考

• 详细工作流 - 完整开发流程
• Subagent 模板 - 任务模板
• Commit 规范 - Conventional Commits