# CodeWorkEnv **Repository Path**: helpking/code-work-env ## Basic Information - **Project Name**: CodeWorkEnv - **Description**: 个人常用的Codex的工作环境 * Astra+Sol+Luna vs Jev - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: wd-soc - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 个人 Codex 配置 本仓库以 Codex 标准项目结构保存用户级规则与可迁移配置。根 `AGENTS.md` 是项目指令;`.codex/` 保存项目配置、角色和仅用于用户级部署的提示词;`.agents/skills/` 保存项目技能。 ## 项目结构 - `AGENTS.md`:通用协作、验证、交付及工作模式调整保护要求。 - `.codex/config.toml`:可迁移的通用用户设置;不包含登录或连接凭据。 - `.codex/agents/`:项目范围的五个独立角色定义。 - `.agents/skills/`:项目可发现的 Redmine 子任务技能。 - `.codex/prompts/red-create.md`:Codex 用户级提示词部署载荷;项目内不作为自动发现的提示词目录。 - `scripts/final_task_summary.py`:规则依赖的只读汇总脚本。 - `scripts/merge_config.py`:安装时合并用户级通用配置的内部工具。 ## 验证当前项目 在仓库根目录运行 `install.bat` 的隔离目标模式,必须同时传入 Codex home 和技能目录: ```bat install.bat ".validation\codex-home" ".validation\agents-skills" ``` 该模式只写入这两个显式目标。仅传一个目标会在写入前退出;隔离安装验证时选择 no/n,避免触发 CLI 安装。 ## 部署到用户级目录 在 Windows 上无参数运行 `install.bat`:配置和规则写入 `%CODEX_HOME%`(未设置时 `%USERPROFILE%\.codex`),技能写入 `%USERPROFILE%\.agents\skills`。脚本复制配置、规则、角色、提示词载荷、技能和统计脚本;会合并 `config.toml` 中的通用白名单设置,保留目标配置的其他内容和 `auth.json`。同路径规则、角色、提示词、技能及统计脚本会被仓库版本覆盖,不会删除目标中的其他文件;首次部署前请备份同路径自定义文件。 运行时会询问是否安装 Redmine CLI。输入 `y`/`yes` 安装,输入 `n`/`no` 跳过 CLI 并继续部署 Codex 配置;其他输入会在部署前退出。如果 `red-cli` 已在 `PATH` 中,脚本显示版本并复用,不覆盖它。否则从 [官方 v0.1.10 Windows release](https://github.com/MrJeffLarry/redmine-cli/releases/tag/v0.1.10) 下载适配当前架构的压缩包,按[官方 Scoop manifest](https://raw.githubusercontent.com/MrJeffLarry/redmine-cli/master/red-cli.json) 校验 SHA-256,再安装到 `%LOCALAPPDATA%\Programs\red-cli` 并追加用户级 `PATH`。当前安装进程立即使用该路径;之后打开的新终端也可直接运行 `red-cli`。 选择安装或复用 CLI 后,脚本只检查用户全局配置中的 `server`、`api-key` 字段和官方支持的 `RED_CONFIG_REDMINE_URL`、`RED_CONFIG_REDMINE_API_KEY` 环境变量是否能提供非空字符串;这只确认字段存在,不验证服务器认证。字段齐全时原样保留配置,不调用登录。字段缺少或不完整时可选择现在运行 `red-cli auth login`,或稍后手动运行;无效或无法读取的 JSON 会提示人工检查,脚本不会调用登录覆盖它。 官方 v0.1.10 不提供本仓库 Redmine 子任务技能调用的 `red-cli subtask create --input ... --json` 扩展。新安装的官方 CLI 可用于其自身支持的 Redmine 命令;该批量子任务技能仍需兼容的定制版扩展。已在 `PATH` 中的定制 CLI 会被保留并复用。 `red-cli auth login` 会交互询问 Redmine 地址,并以掩码方式读取 API Key。CLI 将用户级全局配置保存为 `%USERPROFILE%\.red\config.json` JSON 文件,其中字段名为 `server` 和 `api-key`。安装脚本从用户主目录启动登录,避免把仓库中的项目级 `.red/config.json` 用作登录配置;脚本不接收、输出或写入 API Key/Redmine 地址。该 JSON 文件保存凭据明文,请不要把它放入仓库或提交到 Git。可在 Redmine 的“我的账户 → API 访问密钥”页面获取 API Key;若页面未显示,需要管理员启用 REST API。 应用 Codex 配置需要 Windows Python Launcher(`py`)和 Python 3.11 或更新版本。无法安全合并已有 TOML 时,脚本报错并保留原配置。仓库不包含 API key、登录凭据、provider/MCP 连接、机器专属路径或用户运行数据。部署只证明文件已写入;需要重新启动 Codex 才能确认新进程加载了这些规则。