4.2 KiB
name, description
| name | description |
|---|---|
| cook-it-through | 当用户要在一个目标项目里推进实质性工程任务、需要先确定执行深度和验证强度时使用；也用于该项目 .scratch 本地 ticket 队列的规划、领取、交付与集成。触发说法包括「按流程做这个」「这个需求怎么落地」「继续这个 ticket」「集成这个 feature」「.scratch 里还有什么可做」「谁在跑这个队列」。不用于纯 TSL 语法/API 查询、只写 commit message、诊断远端 Gitea CI。 |
Cook It Through
先确定项目与边界
<COOK_IT_THROUGH_ROOT>是本 skill 的绝对目录，只用于定位随 skill 安装的执行引擎； 它不是目标项目、状态目录或工作区。<PROJECT_ROOT>只能来自用户或任务明确指定的 checkout，并由git rev-parse --show-toplevel验证。无法确定时保留占位符并暂停；不得把 skill source、 snapshot 或偶然 cwd 当项目根。- 先读取目标项目的
AGENT_RULES.md、AGENT_RULES.local.md、.agents/index.md；不存在则跳过。 入口 1 只保留这些最小边界，不加载按需文件。 - 主循环只使用共享 local Markdown tracker、同一文件系统和 Git common directory； 不得接入远程 tracker、独立 clone 或跨机器状态。
- 只从
<COOK_IT_THROUGH_ROOT>/scripts/main_loop.py调用机器入口。构造任何命令前先运行python <COOK_IT_THROUGH_ROOT>/scripts/main_loop.py <command> --help；帮助输出独占参数、 状态字段与 evidence schema 的权威。
任务路由
按成本从低到高选择第一个满足条件的入口；升级时把已有改动当作事实输入，不视为已批准方案。
路由前阅读 AGENT_RULES.local.md 声明的高爆炸半径路径：清单内文件即使改动看似机械，
也不得走入口 1。未声明时，触及构建、CI 或分发配置的改动最低入口 2。
入口 1：直接执行
只读分析、定位、审查和不改变可观察行为的机械修改；不生成 spec/tickets，不建 branch。 入口 1 不加载按需文件。
升级条件：出现可观察行为变化，或路径地板要求更高入口时转入口 2。
入口 2：单切片改动
单模块/既有接口、既有测试 seam、无新公开接口、配置、数据格式、依赖、迁移、兼容或并发，
且一个 session 可完成；不属于入口 3 时适用。详情读
workflows/single-session.md。
升级条件：需要新 seam、越过边界或出现未确认取舍时转入口 4。
入口 3：已明确预期行为的 bug
预期行为和失败反馈已明确；与入口 2 一起读
workflows/single-session.md，由该文件决定诊断循环和升级。
入口 4：新 feature 或设计变更
产品/架构决策、新 seam/公开接口/配置/数据格式、跨模块、迁移/兼容、跨 session/并发，
或单 session 无法完成的工作。边界不清时先按入口 2 起步；确认后读
workflows/feature-planning.md。
enqueue 完成、恢复已入队工作或调用 status/claim 后读
workflows/ticket-execution.md；stdout 出现
INTEGRATION_REQUIRED=<feature>@integrated 后读
workflows/feature-integration.md。到阶段边界或上下文有压力时读
rules/session-boundary.md。
常驻红线
- 禁止手工修改 ticket
Status、main-loop:ticket-state、queue block 或 feature state。 - 禁止伪造或复用证据 artifact；integration dependency 不可见时禁止继续。
- 禁止 stash、reset 或覆盖其他 session 改动；禁止绕过 integration frontier 或运行
git add .scratch。 - 只允许 local Markdown tracker；禁止把远程 tracker、独立 clone 或跨机器状态接入主循环。
恢复与完成
clear、compact、handoff、上下文压缩或新 session 恢复时，必须重新加载本文件与当前路由文件；
不得只依据 status 输出继续。保持活动 claim 的 heartbeat；结束前做 fresh verification，
并报告完成、未完成、证据与风险。