综合项目章程:问题、用户与有界范围
Agent 辅助工程检查
前置要求
第 82-84 天的科学化 Agent 评测;projects/agent_learning 中的有界 Agent 学习项目及其四语言指南。
学习目标
撰写一页综合项目章程,把具体问题、具名用户、明确的范围边界和非目标绑定在一起,复用此前已验证的有界 Agent,而不是在综合项目内部偷藏一个新的无界系统。
操作指引
1. 重读 projects/agent_learning/README.md 与 agent.py,列出已注册的有界工具(list_notes、read_note、write_report)和夹具任务 summarize-notes。
2. 撰写问题陈述:综合项目在已验证的“笔记到报告”Agent 基础上,恰好新增一个有界工具(例如 count_words 或 list_deadlines)和一个额外的固定任务,仍由现有的独立评分器评分。
3. 具名用户(把学习笔记整理成报告的学习者)与使用场景(本地、离线优先的一次性夹具工作区)。
4. 划出范围界线。范围内:确定性适配器、已注册的有界工具、固定夹具、步数/重试预算。范围外:开放网页浏览、任意 shell 执行、无界重试、生产环境自主运行。
5. 声明非目标:在工单 23 授权门获批之前不作任何真机模型声明;不新建 Agent 框架;不做隐藏的网络调用。
6. 将草案保存为 capstone_charter.md。
自主演练与记录
起草包含 Problem、User、In-Scope、Out-of-Scope、Non-Goals 各节的 capstone_charter.md,然后把三个功能请求分类为范围内或范围外:(a)“读取夹具中的第三个笔记”;(b)“允许 Agent 随意 pip-install 任何包”;(c)“新增一个有界的字数统计工具”。
追问该功能是否越过 agent.py 已强制的资源或权限边界:(a) 与 (c) 留在夹具内部,而 (b) 授予了无界执行能力。
参考判定:(a) 范围内(仅夹具变更);(b) 范围外(任意安装包等于无界执行);(c) 范围内(一个有界的确定性工具)。只有当每个范围内事项都能映射到既有约束(已注册工具、夹具或预算),且非目标至少列明三项被排除能力时,章程才可接受。
产出的章程中每个范围内事项都能映射到已声明的约束,且非目标明确排除至少三项能力(如网页浏览、任意代码执行、无界重试)。
权威源资源与权利证明
ReAct: Synergizing Reasoning and Acting in Language Models
对应章节 / 时间戳: Sections 2-4: interleaved reasoning/action protocol; Figure 1 trace format
验证版本与日期: ICLR 2023 / arXiv:2210.03629v3 (Verified: 2026-10-30)
Primary literature for interleaving explicit reasoning steps with bounded tool actions; anchors the capstone's requirement that every step produces an inspectable observation inside a budgeted loop.
Language-model prompting, tool-call loops, and basic action/observation traces.
The curriculum restates the action/observation loop and reimplements a deterministic three-tool agent locally; no paper text is imported.
对比候选资源与选型分析 (2)
Pure reasoning traces without tool actions; ReAct adds the observable action/observation protocol that the capstone harness enforces.
Embodied closed-loop planning for robotics; ReAct's text-domain tool protocol maps directly onto the capstone's bounded tools.
Model Cards for Model Reporting
对应章节 / 时间戳: Section 4 Model Card Sections (4.1-4.9)
验证版本与日期: FAT* 2019 / arXiv:1810.03993v3 (Verified: 2026-10-30)
Standard framework for disclosing a model's intended use, evaluation conditions, and limitations; supplies the capstone's model-choice and provenance documentation pattern.
Basic model evaluation vocabulary: dataset, metric, intended use.
The curriculum provides a local model-decision table template covering intended use, evaluation data, and caveats.
对比候选资源与选型分析 (2)
Dataset-side documentation rather than model-side; used alongside Model Cards in the provenance table rather than as a replacement.
Vendor-specific safety disclosure; Model Cards provide the general reusable schema.