agenth / Specability
以任务目标、上下文包、完成证据和验收门禁约束本地 Coding Agent。
- 本人职责
- 本地 CLI 原型与完成证据门禁
- 时间范围
- 2026-06 至 2026-07
- 技术栈
- Node.js / CommonJS / node:test / YAML
- 最后核验
- 2026/07/17
01 / Problem
问题背景
Agent 可以生成看似完成的回答，却没有任务目标、差异摘要、验证记录和风险说明来证明工作真的完成。
02 / Approach
方法与结构
- 生成项目级上下文包、任务卡和运行证据目录。
- 把 diff、通过的验证、跳过项理由和风险声明设为完成门禁。
- 通过本地 CLI 和项目钩子记录证据，不依赖全局服务。
03 / Decisions
核心决策与取舍
- agenth 包保持 private，本地原型不冒充公开 npm 分发。
- 缺少任一必需证据时，完成命令必须失败。
- 默认拒绝上传、遥测、危险 Git 和路径逃逸。
04 / Outcome
结果与当前边界
- 本地 CLI 能初始化上下文、创建任务、记录证据并给出完成判定。
- 12 项测试在 2026-07-18 重新执行并全部通过。
- Specability 已形成本地打包原型，但不宣称已发布到公共 registry。
05 / Evidence
可查看证据
只有重新执行或重新检查过的事实才进入这里；没有公开链接的项目只显示来源核验摘要。
12 项测试通过
覆盖初始化、完成门禁、篡改检测、并发记录和危险命令阻断。
打开证据private 本地 CLI
包元数据明确标记 private，当前只描述为本地分发原型。