用途:当使用者要求盘点当前项目并建立、重建或补强完整 Harness 工程环境时使用。技能会依项目现状建立可阅读、可验证、可恢复的工程环境,不套用固定技术栈或理想架构,也不建立没有真实检查能力的空壳。仅涉及 AGENTS.md 时改用 neo-harness。
资产位置:目标项目 Harness 资产集中在根目录 .neo_harness/,唯一例外是必须留在根目录的 AGENTS.md。正式路径包括 AGENTS.md、.neo_harness/ARCHITECTURE.md、.neo_harness/PLANS.md、.neo_harness/docs/scripts.md、.neo_harness/docs/exec-plans/active/ 与 completed/。不得建立 .neo_harness/AGENTS.md。.neo_harness/ 应纳入版本控制;若被忽略规则排除,标记为 blocked,不自行修改忽略规则。
必要流程:先盘点不写入,读取项目规范、版本控制状态、根目录、套件与建置设定、测试、CI、文档、主要入口及现有 Harness 资产,命令须来自可验证设定或文档,未知信息标为未知。再依资产选择矩阵分类为 create、update、rebuild、migrate、skip 或 blocked。写入前提供预览,列出证据、精确路径、动作、事实依据、冲突、验证命令与复原方式,取得明确确认后才写入。产生时以核心模板为结构起点,依项目事实改写并移除模板标记。最后做闭环验证,检查链接、命令、路径、架构描述、模板标记、计划档名时间戳格式与 scripts.md 两栏表格格式,执行原有快速检查及新增验证入口,失败时修正根因后重跑。
旧路径搬迁:若发现 ARCHITECTURE.md、PLANS.md、docs/scripts.md、docs/exec-plans/ 等旧路径,须先提供搬迁预览并取得对精确清单的明确确认;目的地已存在、内容冲突或被忽略规则排除时标记 blocked,不得覆写、删除、建立重复副本或符号链接。
限制:不得新增使用者未要求的第三方依赖、服务、部署或外部连线;内容须保持供应商中立,不得提及特定模型供应商、产品、套件族、官方网址或供应商专属中继资料;无法在中立前提下准确记录必要事实时停止产出并回报冲突。新计划档名使用 YYYYMMDDHHmmss_<原计划档名>.md,时间戳取建立时本地时间,移至 completed 时保留。scripts.md 只含指令、用途两栏 Markdown table。没有可验证的统一验证命令时,从 AGENTS.md 移除统一验证命令与相应完成条件。