// 通过 repos.json 注册和管理工作区中的项目。当用户想要接入项目、移除项目、询问项目设置规范，或消息中提到已注册项目名并需要定位 local_path 时使用。
管理工作区知识对象的检索与全生命周期操作，路径涉及 `knowledge/`，知识对象包括 issue（需求）、plan（方案 / 计划）、snippet（代码片段）和 troubleshooting（排障经验）。 当用户询问事项进展、最近做了什么、周报 / 日报 / 总结素材，或者问题依赖历史结论、过往决策时，应优先使用本 skill。 当用户要求将结论沉淀到知识对象体系，或者要求检索、创建、修改、归档、迁移知识对象时，应使用本 skill 执行相关操作。 外部资料调研、纯代码实现 & 调试 & 测试等无需落地知识对象的行为不属于本 skill 场景。
执行代码审查、PR review、复查、处理未解决 review threads、发 review 评论、request changes 或 approve 前必须使用。适用于检查 GitHub PR diff、本地变更、相关源码、测试覆盖、项目规范和既有评论，并输出对话草稿，或在明确授权后发布 inline / conversation review 评论。
结构化编写、重构、润色和验收 Markdown / MDC 文档。 只要用户要创建、编辑、润色、改写、评审或整理任何 `.md` / `.mdc` 文件， 或需要整理规则文档、普通说明文档、PR review 评论、GitHub 评论、零散草稿，就应使用这个 skill。
同步 AI 工作区文档到 iWiki、从 iWiki 回写本地、做日常增量对齐时使用。只要用户提到“同步到 iWiki”“从 iWiki 拉取”“双向更新”“补齐映射”“重传文档”“个人空间目录对齐”，都应立即使用本 Skill。
处理通用代码风格与实现约束。用于源码读取、编辑、评审和规则迁移。
准备和修复 Go、Node.js、Python 本地开发环境。用于版本切换、工具链缺失、依赖环境异常、虚拟环境问题，以及编译、测试、检查命令中的环境类失败。
| name | project-mgr |
| title | project-mgr — 项目管理 |
| description | 通过 repos.json 注册和管理工作区中的项目。当用户想要接入项目、移除项目、询问项目设置规范，或消息中提到已注册项目名并需要定位 local_path 时使用。 |
管理工作区中项目的添加、删除和定位，默认 visibility 为 public。
项目通过 repos.json / private/repos.json 注册，local_path 记录本地仓库绝对路径，模型可通过该路径 cd 到项目目录进行开发。
| 参数 | 必填 | 说明 |
|---|---|---|
| local_path | 是 | 本地路径（仓库根目录或大仓子目录均可） |
| visibility | 否 | public（默认） / private |
| name | 否 | 项目名称覆盖（默认从 local_path 的 basename 推断） |
| language | 否 | 项目语言偏好：zh（默认） / en，影响 PR review 评论、commit message 等交互语言 |
先 cd 到 local_path，再逐条执行以下 Git 命令采集信息（Git 在子目录中会自动向上查找 .git）：
| 信息 | 命令 | 说明 |
|---|---|---|
| 远程仓库地址 | git remote -v | 优先取 upstream（fetch），其次 origin（fetch） |
| 默认分支 | git symbolic-ref refs/remotes/<remote>/HEAD 2>/dev/null | 失败则回退检测 master / main 分支是否存在 |
| 仓库描述 | gh repo view <owner>/<repo> --json description -q .description（可用时） | GH 描述优先，不可用时回退本地 README.md 首段摘要 |
推断规则：
local_path 的 basename（如 /path/bk-monitor/bkmonitor → bkmonitor），用户可通过 name 参数覆盖https://github.com/<owner>/<repo>.git 记录gh repo view 或 API）。<local_path>/README.md：取首个 # 标题后第一段非空正文作为摘要。<name> 项目仓库，并在回复中标注“建议后续人工完善”。将自动发现的信息汇总后向用户确认，格式示例：
即将添加项目：
- 名称：bkmonitor
- 本地路径：/Users/xxx/bk-monitor/bkmonitor
- 远程仓库：https://github.com/TencentBlueKing/bk-monitor.git
- 默认分支：master
- 可见性：public
- 语言偏好：zh
是否确认？
用户确认后再执行写入操作。
repos.json（或 private/repos.json）：{
"name": "<name>",
"description": "<description>",
"git_url": "<git_url>",
"branch": "<branch>",
"local_path": "<local_path>",
"language": "<language>"
}
当执行“项目巡检/配置治理”时，允许对现有 registry 做 description 补齐（仅更新空描述字段，不改动其他字段）。
knowledge/<name>/INDEX.md（或 private/knowledge/<name>/INDEX.md）knowledge/INDEX.md| 参数 | 必填 | 说明 |
|---|---|---|
| name | 是 | 项目名称 |
| visibility | 否 | public（默认） / private |
repos.json 或 private/repos.json 中移除对应条目knowledge/<name>/（默认保留）knowledge/INDEX.md模型在处理项目相关任务时：
1）从 repos.json / private/repos.json 读取 local_path、language。
local_path 使模型能直接访问项目源码，knowledge/<name>/ 提供项目级知识，两者结合即可完成项目任务。language：
language 字段为准，默认中文。2）通过 cd <local_path> 切换到项目目录，阅读项目级别规范（如 CONTRIBUTING.md、README.md、AGENTS.md 等）。
3）加载 knowledge/<name>/ 下的项目知识库作为上下文，按需进行检索和写入。