安全规则

• - 永不删除：SOUL.md, IDENTITY.md, USER.md, MEMORY.md, AGENTS.md, TOOLS.md, TASKS.md, .harness/
• 所有删除操作记录到 .harness/gc.log
• 删除前文件归档到 .harness/.trash/

目录结构

.harness/ # Harness状态根目录（由init创建）
├── .initialized # 初始化标记（版本+时间戳）
├── config.json # 配置：maxcheckpoints, maxage_days等
├── gc.log # 删除审计日志
├── checkpoints// # 检查点快照
│ ├── manifest.json # 快照清单
│ └── files/ # 快照副本
├── reports/ # 验证报告
├── tasks/ # 任务元数据
├── tmp/ # 临时文件（GC目标）
└── .agent-progress.json # 跨会话进度状态

高级用法

自定义验证规则：
bash
harness verify --rule [{name:构建正常,type:command,path:npm run build}]

检查点管理：
bash
harness checkpoint create 标签 --tag v1 --tag stable
harness checkpoint show

带限制的GC：
bash
harness gc --max-cp 5 # 每个任务最多5个检查点
harness gc --max-age 7 # 删除超过7天的检查点
harness gc --aggressive # 同时清理tmp/目录

进度追踪：
bash
harness progress show
harness progress set-phase 阶段2
harness progress add-blocker 等待API密钥

检查与修复：
bash
harness linter --strict # 警告也视为失败
harness linter --fix # 自动修复问题（创建.orig备份）
harness fix all --dry-run # 预览所有自动修复

详细参考

完整文档请加载相关参考：

• - 架构与设计：参见 references/architecture.md
• 需求与验收标准：参见 references/requirement.md
• 技术知识包：参见 references/knowledge-package.md
• 维护指南：参见 references/maintenance.md

脚本

本技能包含供技能开发者使用的辅助脚本：

• - scripts/initskill.py — 从模板初始化新技能
• scripts/packageskill.py — 将技能打包并验证为.skill文件

bash

创建新技能

打包技能