# zingAgent **Repository Path**: harry_zing/zingAgent ## Basic Information - **Project Name**: zingAgent - **Description**: 个人AI中枢仓库 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-25 - **Last Updated**: 2026-11-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # zingAgent `zingAgent` 是一个面向多种 CLI 与模型的个人处理仓库。它保存可移植的规则、任务上下文、可观察的运行记录和低敏感内容,使 Codex、Claude Code、Gemini CLI 以及其他能读取 Markdown 的工具可以接续同一项工作。 本仓库不是所有私人资料的总盘。安全边界按内容敏感度划分为三个 Git 仓库: | 逻辑仓库 | 作用 | 允许的内容 | | --- | --- | --- | | `hub`(本仓库) | 公共规则与个人中枢 | `open` 内容、脱敏摘要、模板、技能和索引 | | `personal-private` | 个人隐私仓库 | 简历原件、健康、财务、家庭、日记等 `private` 内容 | | `work-private` | 工作敏感仓库 | 公司代码、工单、日志、客户或内部资料等 `restricted` 内容 | 三个仓库都应使用私有远端。分仓只能隔离同步与 Git 历史,不能代替本机权限控制。可以从中枢启动获准处理相应敏感等级的 CLI 并跨仓检索;需要强访问隔离时仍应使用操作系统权限、沙箱或目录允许列表。 三个目录必须是独立 Git 根并使用不同的 Git common directory。两个私仓嵌套在中枢目录中,由父仓库的 `.gitignore` 排除;它们不能互相嵌套、配置成中枢的 worktree,或提交为父仓库的 Git link/submodule。 需要保留原有 Git 历史的业务项目也可以作为所属逻辑仓库中的独立子仓库保存。父仓库忽略子仓库工作树,只提交分类索引;检索工具仍可通过明确指定路径读取它们。 ## 数据等级 | 等级 | 写入位置 | 处理规则 | | --- | --- | --- | | `open` | `hub` | 可交给任意已配置的 CLI 或模型 | | `private` | `personal-private` | 只交给你认可其隐私政策的模型 | | `restricted` | `work-private` | 只交给公司明确允许的模型与 CLI | | `secret` | 不写入任何仓库 | 凭据、令牌、私钥和密码不得进入 Git 或模型上下文 | 目标私仓不存在或不可访问时,任务创建必须失败,不能把内容降级写入中枢仓库。 ## 目录 ```text . ├─ AGENTS.md # 所有 CLI 的公共规则源 ├─ CLAUDE.md # Claude Code 的薄入口 ├─ GEMINI.md # Gemini CLI 的薄入口 ├─ SECURITY.md # 数据边界与安全响应 ├─ workspace.yaml # 可移植的逻辑仓库与路由配置 ├─ areas/ │ ├─ work/ │ ├─ study/ │ ├─ life/ │ └─ entertainment/ ├─ inbox/ # 仅接收 open 内容或脱敏摘要 ├─ personal-private/ # 被父仓库忽略的独立 private Git 仓库 ├─ work-private/ # 被父仓库忽略的独立 restricted Git 仓库 ├─ docs/ # 使用与格式说明 ├─ templates/ # 任务及运行记录模板 ├─ .agents/skills/ # 共享技能源 ├─ .claude/skills/ # 自动生成的 Claude 薄适配器 ├─ .githooks/ # 调用统一校验器的提交前门禁 ├─ scripts/ # 创建、记录、同步与校验工具 └─ .local/ # 本机路径、缓存和临时文件;不提交 ``` 四个领域目录都使用 `projects/`、`tasks/`、`knowledge/`、`archive/`。旧分类 `game` 已映射到 `areas/entertainment/games/`,`abilityEnhancement` 已映射到 `areas/study/skill-development/`。 ## 开始使用 1. 阅读 [AGENTS.md](AGENTS.md) 和 [SECURITY.md](SECURITY.md)。 2. 已有全部远程权限时运行 `python scripts/sync-repositories.py`,自动克隆或更新独立仓库并生成 `.local/repos.yaml`;没有远程仓库时按 [本机配置](docs/local-setup.md) 初始化。 3. 创建任务前指定 `area` 和 `sensitivity`;使用 `new-task` 技能或 `scripts/new-task.py` 完成路由。 4. 每次工作结束时使用 `capture-run` 技能记录可观察的输入、输出、工具结果、验证和下一步。 5. 运行 `git config core.hooksPath .githooks` 启用提交前门禁;也可随时手动运行 `python scripts/validate-repo.py`。初始化脚本会自动为新建私仓启用门禁。 任务目录和记录格式见 [任务格式](docs/task-format.md),不同 CLI 的接入方式见 [多 CLI 使用](docs/multi-cli.md)。