代理指示 (@ damphuquy/ agent-init) (中文(简体) )
Spec-Anchored Conceptive Harness (SACH-2026) v4.4.1 (英语)
安装
在仓库中启动软件工程工作空间 :
npx @damphuquy/agent-init . --role swe --lang en
其他支持的切入点:
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 将取出文件分开,但不孤立证书,进程,或服务. 见 能力矩阵 详细情况.
技能和特征路径
SWE模板将这些责任分开:
- Root AGENTS.md拥有任务大小,执行指导,核查预期,以及明确的文件路径.
- 利用技术拥有技能编写、触发评估以及利用合同设计.
- 进化后的技能拥有基于证据的回溯和对指令,技能路线,或协议的拟议修改.
- 技能清单申报了技能捆绑。 技能检查验证本地元数据和文件存在;两个动作都无法证明本地主机激活.
- 第三方技能库,例如: 马特孔克/技能 是咨询和选择的。 SWE模板不捆绑或激活它们;SACH仍然是其任务路线和生命周期的拥有者.
- CLI的路线是明确的研究,辩论,QA,图索引,任务,和出门命令. 列表命令不会自动从自然语言中选择它们.
目前的研究命令产生一个带有占地源和主张的档案脚手架;它不浏览. 辩论建立一个决定性的挑战分类账;其审查镜头不是独立的审查者。 可选的子代理标记格式工人提示但不发送代理. QA命令默认为L1,L2,L3和L6. 图索引为综合导航数据. 每个产出都需要对照来源和命令证据进行审查.
关于外部技能政策、触发评价和路线证据水平,见 高级工作流程 财务报告和审定财务报表 建筑和例行证据。现场激活必须在指定的主机中检查.
任务规模的工作流程
对于小的改动,在谈话或简洁的任务说明中说明结果,范围和相关检查. 对于多步骤的工作,使用.代理/TASK.md或创建任务文物. 重现已报告的错误, 在执行前定义特性接受度, 并使用相关检查 docs/ config 更改 .
对于使用闸门问题的任务,在验证前显示问题并记录一个真正的工程师选择的答案:
npx @damphuquy/agent-init gate questions <slug> --gate G1
npx @damphuquy/agent-init gate answer <slug> --gate G1 --question-id <id> --option "<chosen option>"
npx @damphuquy/agent-init verify-gate G1
在交互式 TTY 中,校验出门 G1 -- -- 交互式可以促进未决问题。 在 CI 和非 TTY 环境中跳过提示 。 所收录的签名器是一个标签,而不是认证的身份. 目前的闸门询问命令在未提供选项时自动记录第一个选项;它不是人类的快取,不得被作为明确批准的证据.
CLI 命令
# 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 <slug> [--title <text>] [--require-signoff]
npx @damphuquy/agent-init task status <slug>
npx @damphuquy/agent-init task sandbox <slug>
npx @damphuquy/agent-init task approve <slug> --gate <G0|G1|G2|G3> [--signed-by <name>]
npx @damphuquy/agent-init task complete <slug>
# Explicit feature commands
npx @damphuquy/agent-init research --topic "<question>" [--depth <n>] [--subagents]
npx @damphuquy/agent-init graph-index [--src <dir>] [--output <file>] [--fallback]
npx @damphuquy/agent-init debate [--task <file>] [--tier <0|1|2>] [--subagents]
npx @damphuquy/agent-init qa [--layers L1,L2,L3,L6] [--task <file>] [--output <file>]
npx @damphuquy/agent-init run-test -- npm test
# Gate question and verification flow
npx @damphuquy/agent-init gate questions <slug> [--gate <G0|G1|G2|G3>]
npx @damphuquy/agent-init gate answer <slug> --gate <G0|G1|G2|G3> --question-id <id> --option <text>
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 帮助者可以验证本地的文物,而无需模型调用或现场网络访问:
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
文档
版本和升级
启动的项目包括一个指令-版本.json explain. 在更新项目前审查本地变化;任务文件,自定义技能和项目命令可能是用户拥有的. 使用软件包更新流或以已审查的覆盖计划重运行初始化器.
npx @damphuquy/agent-init update --check
npx @damphuquy/agent-init update
许可证
凭 MIT 许可证。 。 。 .