# @damphuquy/agent-init 中文文档 规范地址：https://npmcn.com/package/%40damphuquy/agent-init/ 版本：4\.4\.1 npm 元数据更新时间：2026-11-10T03:46:45.544Z 中文译文更新时间：2026-11-11T09:46:05.083Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40damphuquy/agent-init 原文对照：https://npmcn.com/package/%40damphuquy/agent-init/?lang=original 项目主页：https://github.com/damphuquy/agent-instructions#readme 源码仓库：https://github.com/damphuquy/agent-instructions ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.2 MB，345 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=16\.0\.0 - 运行依赖：0 个 - 首次发布：2026-08-28T05:01:21.126Z - 最新版本发布：2026-11-10T03:46:45.375Z - 近 30 天下载量：2371（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：50（近 12 个月 50 个） ## 中文简介 脚手架式CLI来牵引 Spec-Anchoyed 认知机理(SACH-2026) 编码代理和操作工作空间 ## 安装 ```sh npm install @damphuquy/agent-init ``` 也可以使用：`pnpm add @damphuquy/agent-init`、`yarn add @damphuquy/agent-init`、`bun add @damphuquy/agent-init` ## README # 代理指示 (@ damphuquy/ agent-init) (中文(简体) ) > Spec-Anchored Conceptive Harness (SACH-2026) v4.4.1 (英语) [![AGENTS](https://img.shields.io/badge/AGENTS-OPERATIONAL--WORKSPACE-0a0a0a.svg?style=for-the-badge&logo=openai&labelColor=000000)](https://www.npmjs.com/package/@damphuquy/agent-init) [![npm version](https://img.shields.io/npm/v/@damphuquy/agent-init.svg?style=for-the-badge&labelColor=000000)](https://www.npmjs.com/package/@damphuquy/agent-init) [![License: MIT](https://img.shields.io/github/license/damphuquy/agent-instructions.svg?style=for-the-badge&labelColor=000000)](https://github.com/damphuquy/agent-instructions/blob/main/LICENSE) [![npm downloads](https://img.shields.io/npm/dm/@damphuquy/agent-init.svg?style=for-the-badge&labelColor=000000)](https://www.npmjs.com/package/@damphuquy/agent-init) ## 安装 在仓库中启动软件工程工作空间 : ```bash npx @damphuquy/agent-init . --role swe --lang en ``` 其他支持的切入点: ```bash npx @damphuquy/agent-init . --role ba --lang en npx @damphuquy/agent-init sync . npx @damphuquy/agent-init . --force ``` ## 软件包提供了什么 软件包复制了项目指令,schemas,可选主机钩子,离线验证器,以及工作流程模板. Root AGENTS.md提供任务指导并明确途径进入技能和协议. CLI 发出命令时会使用它们的旗帜。 该包不包括自然语言指令路由器,模型服务,或通用代理调度器. 使用与任务风险成比例的校验 。 机器验证器检查申报的结构和条件;它们不能证明程序正确,不能运行每个项目测试,也不能认证一个人. 可选回路护需要兼容的主机适配器. Git worktree 将取出文件分开,但不孤立证书,进程,或服务. 见 [能力矩阵](https://npmcn.com/package/%40damphuquy/agent-init/docs/en/reference/capabilities.md) 详细情况. ## 技能和特征路径 SWE模板将这些责任分开: - Root AGENTS.md拥有任务大小,执行指导,核查预期,以及明确的文件路径. - 利用技术拥有技能编写、触发评估以及利用合同设计. - 进化后的技能拥有基于证据的回溯和对指令,技能路线,或协议的拟议修改. - 技能清单申报了技能捆绑。 技能检查验证本地元数据和文件存在;两个动作都无法证明本地主机激活. - 第三方技能库,例如: [马特孔克/技能](https://github.com/mattpocock/skills) 是咨询和选择的。 SWE模板不捆绑或激活它们;SACH仍然是其任务路线和生命周期的拥有者. - CLI的路线是明确的研究,辩论,QA,图索引,任务,和出门命令. 列表命令不会自动从自然语言中选择它们. 目前的研究命令产生一个带有占地源和主张的档案脚手架;它不浏览. 辩论建立一个决定性的挑战分类账;其审查镜头不是独立的审查者。 可选的子代理标记格式工人提示但不发送代理. QA命令默认为L1,L2,L3和L6. 图索引为综合导航数据. 每个产出都需要对照来源和命令证据进行审查. 关于外部技能政策、触发评价和路线证据水平,见 [高级工作流程](https://npmcn.com/package/%40damphuquy/agent-init/docs/en/03-advanced-workflows.md) 财务报告和审定财务报表 [建筑和例行证据](https://npmcn.com/package/%40damphuquy/agent-init/docs/en/reference/architecture.md)。现场激活必须在指定的主机中检查. ## 任务规模的工作流程 对于小的改动,在谈话或简洁的任务说明中说明结果,范围和相关检查. 对于多步骤的工作,使用.代理/TASK.md或创建任务文物. 重现已报告的错误, 在执行前定义特性接受度, 并使用相关检查 docs/ config 更改 . 对于使用闸门问题的任务,在验证前显示问题并记录一个真正的工程师选择的答案: ```bash npx @damphuquy/agent-init gate questions --gate G1 npx @damphuquy/agent-init gate answer --gate G1 --question-id --option "" npx @damphuquy/agent-init verify-gate G1 ``` 在交互式 TTY 中,校验出门 G1 -- -- 交互式可以促进未决问题。 在 CI 和非 TTY 环境中跳过提示 。 所收录的签名器是一个标签,而不是认证的身份. 目前的闸门询问命令在未提供选项时自动记录第一个选项;它不是人类的快取,不得被作为明确批准的证据. ## CLI 命令 ```bash # Initialize or synchronize workspace instructions npx @damphuquy/agent-init . --role swe --lang en npx @damphuquy/agent-init sync . # Task lifecycle and local worktree npx @damphuquy/agent-init task create [--title ] [--require-signoff] npx @damphuquy/agent-init task status npx @damphuquy/agent-init task sandbox npx @damphuquy/agent-init task approve --gate [--signed-by ] npx @damphuquy/agent-init task complete # Explicit feature commands npx @damphuquy/agent-init research --topic "" [--depth ] [--subagents] npx @damphuquy/agent-init graph-index [--src ] [--output ] [--fallback] npx @damphuquy/agent-init debate [--task ] [--tier <0|1|2>] [--subagents] npx @damphuquy/agent-init qa [--layers L1,L2,L3,L6] [--task ] [--output ] npx @damphuquy/agent-init run-test -- npm test # Gate question and verification flow npx @damphuquy/agent-init gate questions [--gate ] npx @damphuquy/agent-init gate answer --gate --question-id --option npx @damphuquy/agent-init verify-gate G0 npx @damphuquy/agent-init verify-gate G1 --interactive npx @damphuquy/agent-init verify-gate G2 npx @damphuquy/agent-init verify-gate G3 ``` 离线 Python 帮助者可以验证本地的文物,而无需模型调用或现场网络访问: ```bash python3 .agents/harness.py validate --spec spec.json --task task.json python3 .agents/harness.py handoff-check --input handoff.json --strict python3 .agents/harness.py qa-verdict-check --input qa-verdict.json --strict python3 .agents/harness.py skills-check --input .agents/skills-manifest.json --root . --strict python3 .agents/harness.py research-dossier --input research-dossier.json --strict python3 .agents/harness.py debate-eval --input debate-ledger.json --strict ``` ## 文档 - [亲手走过](https://npmcn.com/package/%40damphuquy/agent-init/docs/en/01-getting-started.md) - [每日欺骗表](https://npmcn.com/package/%40damphuquy/agent-init/docs/en/02-cheat-sheet.md) - [高级工作流程](https://npmcn.com/package/%40damphuquy/agent-init/docs/en/03-advanced-workflows.md) - [建筑和例行证据](https://npmcn.com/package/%40damphuquy/agent-init/docs/en/reference/architecture.md) - [能力矩阵](https://npmcn.com/package/%40damphuquy/agent-init/docs/en/reference/capabilities.md) - [教学版本说明](https://npmcn.com/package/%40damphuquy/agent-init/docs/tutorial-version.json) - [已核实的研究和执行报告](https://npmcn.com/package/%40damphuquy/agent-init/docs/research/swe-harness-research-and-implementation-2026.md) - [DevOps 和释放自动化](https://npmcn.com/package/%40damphuquy/agent-init/docs/en/reference/devops-release.md) ## 版本和升级 启动的项目包括一个指令-版本.json explain. 在更新项目前审查本地变化;任务文件,自定义技能和项目命令可能是用户拥有的. 使用软件包更新流或以已审查的覆盖计划重运行初始化器. ```bash npx @damphuquy/agent-init update --check npx @damphuquy/agent-init update ``` ## 许可证 凭 [MIT 许可证](https://github.com/damphuquy/agent-instructions/blob/main/LICENSE)。 。 。 . ## 常见问题 ### @damphuquy/agent-init 是什么？ 脚手架式CLI来牵引 Spec-Anchoyed 认知机理\(SACH-2026\) 编码代理和操作工作空间 ### 如何安装 @damphuquy/agent-init？ 在项目目录运行 npm install @damphuquy/agent-init，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-init，可以用 npx agent-init 直接运行。 ### @damphuquy/agent-init 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @damphuquy/agent-init 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @damphuquy/agent-init 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=16\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @damphuquy/agent-init 可以商用吗？ @damphuquy/agent-init 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @damphuquy/agent-init 的下载量有多少？ 根据 npm 官方下载统计，@damphuquy/agent-init 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,371 次，日均约 79 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @damphuquy/agent-init 还在维护吗？ 最新版本 4\.4\.1 发布于 2026/11/10（1 天前）；至今共发布 50 个版本，其中过去 12 个月发布了 50 个；首次发布于 2026/08/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。