项目 Harness 初始化

解决什么问题

当 Agent 面对一个陌生目录时，常见失败不是模型能力不足，而是项目缺少可被理解的入口：无法判断目录是否为空、技术栈与任务工具是什么、哪些文件不能动、哪些命令可以验证结果。直接让 Agent 生成代码往往会覆盖已有结构、写入凭据、把文档树建得过重，最后又缺少可执行的验证证据。这个技能把目标目录初始化成“可被 Agent 理解、执行、验证和交接”的项目，而不是套一层固定模板。

核心能力与关键步骤

技能首先锁定用户给出的目标根目录，解析绝对路径、父目录、符号链接和写权限，并运行 node scripts/inspect-target.mjs 做现状探测。随后按结果选择模式：空目录进入 greenfield，已有代码或文档进入 adopt，已有 AGENTS 或 Harness Manifest 但命令失效、文档漂移时进入 repair。已有项目不会重排目录，只补充入口、命令、计划和 Harness。

在画像阶段，技能会记录目标用户、核心结果、首个平台、主要交付物、非目标、运行环境和维护期限，并沿用现有技术栈、目录、任务工具和文档系统。只有显著改变产品、平台、架构或运维成本的选型才要求用户决定。随后形成写入计划，明确将创建的文件、调用的官方生成器、复用的已有文件、需要授权的下载或安装动作，以及验证命令和回滚方式。

按复杂度选择 minimal、standard 或 hardened 等级后，技能建立最小 Harness：根 AGENTS.md、可验证的 bootstrap、run、quick、story、milestone 命令、README 状态说明、计划来源、凭据边界与忽略规则。文档只覆盖项目真实需要的部分，不机械生成完整文档树。

验证与边界

完成写入不代表初始化结束。技能会运行 node scripts/validate-bootstrap.mjs，再执行获授权的安装、最小启动、质量门和文档链接检查，确认没有凭据、未替换占位符和意外生成物进入仓库。初始化结束后会停止，不会擅自推进首个产品工作项。

需要注意：技能不覆盖、移动或重命名来源不明的文件，不默认创建远端仓库、推送、部署或连接生产系统，下载依赖和高风险命令必须遵守环境审批与用户授权。