AGENTS.md · git:20261019.79d197a · 2026-10-19 · sha256 6cf647ae9a1ee7ac
AGENTS.md git:20261019.79d197aA
Immutable. This exact content never changes and is served at /api/v1/blob/6cf647ae9a1ee7ac.
# 老胡造梦技能 本文件是老胡造梦技能仓库的顶层说明,约定本仓库目标、规则与资产归属、维护验收责任。跨 Skill 的运行约定、任务状态、意图判断、权限、路由、交接和通知唯一归 [docs/runtime.md](docs/runtime.md);本文件不复制这些执行细则。各能力的专业流程与方法由负责的 Skill 和按需读取的 Reference 维护。 ## 项目目标 让人主动决定创作目标、阶段和关键取舍,让 Agent 在清楚的边界内完成创作、诊断、整理、进化和发布准备。创作作者职责下的目标标准与核验边界,统一按[能力运行约定](docs/runtime.md#作者表达意图与成品保真)执行。目录、文件数量和规则长度都不是成果;能否改变下一步判断和最终作品才是成果。 ## 共同运行规则 处理本项目任务时先读取 [能力运行约定](docs/runtime.md),沿用其中的任务状态、意图判断、授权、路由、交接和通知要求。它也是各 Skill 在项目外调用时的共同入口,相关判断只在那里维护;本文件保留仓库目标、维护验收和资产职责。官方更新与能力改进的入口分工按 runtime 执行;更新操作见 [项目检查与版本维护](docs/maintenance.md) 和 [laohu-update](.agents/skills/laohu-update/SKILL.md)。 ## 验证 维护 Skill、Reference、`AGENTS.md`、`docs/` 共同规则、项目工具、引用、目录、版本或其他受版本管理的项目维护文件时,实施负责人必须读取 [项目检查与版本维护](docs/maintenance.md) 的对应要求,并在交付前执行适用检查;准备版本时读取该文档的发布流程。普通 `works/` 作品内容的创作或润色按相应 Skill 验收,不触发全仓结构检查。具体命令与版本操作只在维护文档及负责的 Skill 中说明,不因完成本地修改自动提交、推送或发布;用户直接输入 `/laohu-update` 时,该命令按其 Skill 定义已同时给出本轮版本准备、提交和对外推送授权。 对每项结论分别注明检查范围和状态: - `PASS`:在所声明的范围和条件内,证据满足判据; - `OBSERVE`:有观察或检查结果,但证据不足以判断是否满足判据; - `FAIL`:已观察到所声明范围内存在目标差距或违反判据; - `UNKNOWN`:相关范围未检查或所需证据缺失。 质量目标与质量结论分开:顶尖人类完成度是本项目作者职责下的目标,不是由规则写得详细、作品像某种体裁、采用知名方法或一次 AI 自评自动证实的成绩。若报告达到、接近或超过人类标尺,必须按 [analysis 验证协议](.agents/skills/laohu-analysis/references/validation.md)提供相称作品与接收证据;协议未完成的范围维持 `OBSERVE` 或 `UNKNOWN`,已观察到的目标差距仍记 `FAIL`。 若已观察到目标差距,必须记录 `FAIL`;其他部分缺少验证不能把已知失败改记为 `UNKNOWN`。同一修改者的主观自评最多记为 `OBSERVE`,不能据此将 `BEHAVIOR` 或 `QUALITY` 记为 `PASS`;独立可复现的结构检查可按判据记为 `STRUCTURE: PASS`,任何来源确认不符合目标都必须记为 `FAIL`。 按四类证据记录: - `STRUCTURE`:frontmatter、路径、引用、格式和目录正确; - `ROUTE`:真实请求能找到正确入口和必要 Reference; - `BEHAVIOR`:代表请求实际改变了判断、动作、中间产物或停止点; - `QUALITY`:最终接收者、真实媒介、专家或使用结果证明质量变化。 静态检查只能证明 `STRUCTURE`,不能据此宣称路由、行为或质量通过。没有真实媒介、接收者或结果反馈时,`QUALITY` 记为 `UNKNOWN`;若已有证据显示质量未达目标,则记 `FAIL`。 ## 资产与权限 - `.agents/skills/` 是 Skill 真源,`works/` 保存作品与生成结果,`knowledge/` 保存可复用事实、案例、偏好和已验证经验;同一判断只维护一处:仓库维护约束归本文件,跨入口运行约定归 `docs/runtime.md`,专业流程与细则归负责 Skill 及其按需引用;脚本、评测和界面配置随能力维护。发现重复先核对实际消费者,再合并到真源。 - 写入 `knowledge/` 时只沉淀可复用的事实、案例、偏好和已确认经验;运行时需要的结论须编译成规则,并保留决定其使用的适用条件、例外和停止条件。来源、更新时间及仅供维护追踪的资料状态、范围说明留在台账,不原样复制进 Skill 或 Reference;其中会改变执行选择的信息,须转写为相应条件和动作。待验证内容不能单独决定全局路由或硬性规则。 - 当前结果不好,不自动等于项目规则失效;先复现失败并找到最早断点。一次性修订留在当前作品,明确要求长期沉淀时才写入规则、Reference 或知识库。 - 修改前保留当前实际文件及可恢复位置,不能只以 Git 的 HEAD 代替未提交资产的备份。 - 能在现有文件中完成就不新建,不创建 `_v1`、`_最终版` 等平行版本;新文件必须有独立职责、复用价值或明确权限边界。 - 操作权限与用户资产保护沿用 `docs/runtime.md`,不因维护仓库扩大授权。 - 不把密钥、个人隐私材料、个人环境绝对路径或未授权外部内容写入仓库,也不把个人环境绝对路径设为共享规则或运行依赖;可用不含隐私的通用示例路径。仓库 Markdown 链接使用相对路径,Agent 路径表达遵循 [docs/runtime.md](docs/runtime.md)。 ## 仓库维护交付 仅仓库规则、能力定义、项目工具或版本等维护任务,交付时说明改动与写回位置、依据、适用检查及证据状态、尚未验证的效果和恢复位置。普通 `works/` 作品任务按相应 Skill 交付,不套用仓库维护报告。