# 老胡造梦技能

本文件是老胡造梦技能仓库的顶层说明，约定本仓库目标、规则与资产归属、维护验收责任。跨 Skill 的运行约定、任务状态、意图判断、权限、路由、交接和通知唯一归 [docs/runtime.md](docs/runtime.md)；本文件不复制这些执行细则。各能力的专业流程与方法由负责的 Skill 和按需读取的 Reference 维护。

## 项目目标

让人主动决定创作目标、阶段和关键取舍，让 Agent 在清楚的边界内完成创作、诊断、整理、进化和发布准备。用户明确追求顶尖完成度时，该水平始终作为目标，不因当前规则或样本只做到合格、通顺或像某一体裁而降级。目录、文件数量和规则长度都不是成果；能否改变下一步判断和最终作品才是成果。

## 共同运行规则

处理本项目任务时先读取 [能力运行约定](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 中说明，不因完成本地修改自动提交、推送或发布。

对每项结论分别注明检查范围和状态：

- `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 交付，不套用仓库维护报告。
