Agent Skills › SisyphusSQ/harness-template › project-plan-archive

project-plan-archive

GitHub

用于归档已完成的项目计划文件。先查证Issue完成状态，再执行dry-run或移动至ISO周目录并修复旧引用。仅处理根目录日期计划，严禁误动模板或未完成任务。

template/.agents/skills/project-plan-archive/SKILL.md SisyphusSQ/harness-template

触发场景

需要归档已完成的日期计划文件修复项目内旧的计划文件路径引用

安装

npx skills add SisyphusSQ/harness-template --skill project-plan-archive -g -y

更多选项

非标准路径

npx skills add https://github.com/SisyphusSQ/harness-template/tree/main/template/.agents/skills/project-plan-archive -g -y

不安装直接使用

npx skills use SisyphusSQ/harness-template@project-plan-archive

指定 Agent (Claude Code)

npx skills add SisyphusSQ/harness-template --skill project-plan-archive -a claude-code -g -y

安装 repo 全部 skill

npx skills add SisyphusSQ/harness-template --all -g -y

预览 repo 内 skill

npx skills add SisyphusSQ/harness-template --list

SKILL.md

Frontmatter

{
    "name": "project-plan-archive",
    "description": "当需要归档 `.agents\/plans\/` 根目录下已完成的日期计划文件时使用；先由 agent 按当前 issue provider 查证完成态，再用本 skill 做 dry-run 归档、ISO 周目录移动和旧 plan 路径精确改写。"
}

Project Plan Archive

用于项目内 .agents/plans/ 计划文件的归档与旧路径修复。

核心规则：先查 Issue Tracker，再归档；默认只做 dry-run，只有显式 --write 才允许移动文件和改写引用。

第一步

先读取根级 AGENTS.md 和 .agents/PLANS.md。
确认当前 issue-provider 和需要查证的 issue key。
先做只读检查：

python3 .agents/skills/project-plan-archive/scripts/project_plan_archive.py inspect \
  --repo "$PWD" --json

固定执行链

先运行 inspect，只看 .agents/plans/*.md 根级日期计划文件。
从每个候选计划按顺序提取 execution_issue、master_issue，不使用 issue_targets 做归档判定。
agent 按当前 issue-provider 查证 issue 完成态；脚本不直接连接 Linear、GitHub、GitLab 或其他外部系统。
把已完成 issue 列表传给 archive 做 dry-run；只有确认后才加 --write。
写入后运行 git diff --check 和项目要求的 harness / test gate。

快速命令

python3 .agents/skills/project-plan-archive/scripts/project_plan_archive.py inspect \
  --repo "$PWD" --json

python3 .agents/skills/project-plan-archive/scripts/project_plan_archive.py archive \
  --repo "$PWD" \
  --done-issue ISSUE-123 \
  --json

python3 .agents/skills/project-plan-archive/scripts/project_plan_archive.py archive \
  --repo "$PWD" \
  --done-issue ISSUE-123 \
  --write --json

归档规则

项目	固定规则
候选范围	只看 `.agents/plans/` 根目录下带 `YYYY-MM-DD-` 前缀的 `.md` 文件
永不移动	`TEMPLATE.md`、`EXAMPLE-implementation.md`、已经在 `completed/` 下的文件
目标路径	`.agents/plans/completed/<ISO周>/<原文件名>`
周目录格式	`YYYY-Www`，例如 `2026-W18`
issue 字段	优先 `execution_issue`，缺失时再看 `master_issue`
引用修复	只做旧 plan 路径到新路径的精确字符串替换
扫描面	所有 git-tracked 文本文件，外加 `.agents/runs/*/.md`、`.agents/state/*/.md`
禁止行为	不做标题模糊修复，不碰二进制、日志、构建产物，不直接查询或修改 Issue Tracker