bigmoon-dev/agent-cooking-cli

# agent-cooking-cli [](https://github.com/bigmoon-dev/agent-cooking-cli/actions/workflows/ci.yml) [](docs/testing.md) [](LICENSE) 面向 Agent 的证据优先工作流。生成一个工作区，然后通过可审计的制品执行步骤。 [中文版 README](README.zh-CN.md) ## 它能做什么 `agent-cooking-cli` 为你的 Agent 提供一个“配方”（profile）和一个持久化工作区，使其能够在不依赖聊天记忆的情况下工作。 该工作区位于 `TRIAGEFLOW_ROOT/triage/` 下，包含： - `triage/case.yaml`：输入和上下文（事实，而非猜测） - `triage/evidence/` + `triage/evidence/index.md`：带有 EID（E001, E002, ...）的证据片段 - `triage/facts.md`：仅包含事实（每条都引用 EID） - `triage/hypotheses.md`：假设（必须引用 EID） - `triage/directions.md`：首要方向（必须引用 EID） 铁律：无证据 -> 无假设/方向。 ## 安装 ### pipx（推荐） ``` pipx install git+https://github.com/bigmoon-dev/agent-cooking-cli.git python -m triageflow --help ``` ### 可编辑安装（开发） ``` python -m pip install -e . python -m triageflow --help ``` 控制台入口点是 `kitchen`，但 `python -m triageflow ...` 是最可靠的运行方式。 ## 快速开始（嵌入式） 选择一个工作区根目录（位于你的代码仓库之外）并运行： ``` export TRIAGEFLOW_ROOT=/path/to/workspace python -m triageflow start --profile embedded_system_v1 # 保持运行此程序；它会告诉你下一条命令。 python -m triageflow next ``` 如果你想要一个最小化的可复现演示，请创建一个小的 UART 日志： ``` cat > "$TRIAGEFLOW_ROOT/uart.log" <<'EOF' boot panic: watchdog stack: ... reboot EOF ``` 然后按照 `next` 执行。 ### MVP 脚本（复制/粘贴） 此脚本以非交互方式运行最小的端到端流程： ``` export TRIAGEFLOW_ROOT=/path/to/workspace rm -rf "$TRIAGEFLOW_ROOT/triage" mkdir -p "$TRIAGEFLOW_ROOT" cat > "$TRIAGEFLOW_ROOT/uart.log" <<'EOF' boot panic: watchdog stack: ... reboot EOF python -m triageflow init --profile embedded_system_v1 printf "mvp reboot\naffects all\nfw-mvp\nhw-mvp\nopen lid, pair, wait\nnow\n" | \ python -m triageflow round run 0 --no-editor printf "mixed\nn\nunknown\nunknown\nunknown\nunknown\n\n" | \ python -m triageflow round run 1 --no-editor python -m triageflow evidence add-log \ --log-path "$TRIAGEFLOW_ROOT/uart.log" \ --pattern "panic" --before 1 --after 2 --max-matches 1 \ --note "panic window" python -m triageflow facts add --text "panic observed during flow" --evidence E001 python -m triageflow hypotheses add \ --hypothesis "watchdog reset triggers reboot" \ --evidence E001 \ --test "print reset cause / wdt reason" python -m triageflow direction-build --overwrite --top-n 1 python -m triageflow validate python -m triageflow status ``` ## Profiles（配置文件） 列出内置 profiles： ``` python -m triageflow profile list ``` 当前 profiles： - `embedded_system_v1`：稳定性/电源/蓝牙/充电（UART 优先） - `design_system_v1`：软件设计决策 - `product_definition_v1`：产品定义决策 ## 面向 Agent 参见 `AGENTS.md`。 ## 开发者 ``` python -m pip install -e ".[dev]" python -m pytest -q python -m triageflow acceptance run ```

标签：artifacts, Python, RAG替代, 审计追踪, 嵌入式系统, 工作流自动化, 文档结构分析, 无后门, 根因分析, 知识管理, 自动化运维, 证据驱动, 辅助决策, 逆向工具, 问题排查, 防御加固