AI 编程流水线边界升级

本仓库用于实验和沉淀「AI 编程流水线 / Orchestrator + Subagent + Shim」相关实践，当前主要聚焦：

• 使用 gxd-subagent-shim 将 Codex / Claude 这类代码模型接入本地工程；
• 通过 .artifacts/agent_runs/ 记录可追溯的执行日志；
• 梳理在「自动化程度」与「安全边界」之间的折中方案。

仓库结构

• gxd-subagent-shim-0.2.2/：shim 本体源码（可作为 Python 包安装），包含 CLI 与审计落盘逻辑。
• doc/：本仓库的设计与使用文档，例如：
  • 使用指南.md：如何安装与使用 gxd-subagent-shim；
  • 在新项目中使用Orchestrator与Shim.md：在其他工程中集成该方案的步骤；
  • 进阶配置与运行记录.md：环境变量、运行记录与故障排查。
• .artifacts/：shim 自动生成的运行审计目录（已在 .gitignore 中忽略）。
• 其他根目录文档：
  • AGENTS.md：为 Orchestrator / Subagent 约定的角色与流程说明；
  • prompt演化.md：提示词演化记录；
  • 讲义.md：课程/分享型讲义笔记。

开发者指引

1. 安装 shim（可选但推荐）

   cd gxd-subagent-shim-0.2.2
   python -m pip install -e .

2. 运行最小示例（以 Codex 为例）

   $prompt = '{"task_id": "hello_world", "step_id": "S1", "instruction": "输出一段问候语"}'
   gxd-subagent-shim create $prompt --backend=codex

   运行后可在 .artifacts/agent_runs/<RUN_ID>/ 下查看 meta.json、events.jsonl 与各 step 的输出。

Git 与忽略规则

本仓库已添加基础的 .gitignore，主要忽略：

• .artifacts/agent_runs/ 等运行审计产物；
• subagent.log 等本地日志；
• .DS_Store、__pycache__/、*.pyc、虚拟环境目录、打包产物等。

如在本地新增 IDE 配置、临时脚本或大体量数据目录，建议一并追加到 .gitignore 中，避免误提交。