Files
reverse-skill/skills/ops/timeline-workitem.md
T
Edisonandjhuang-tw 41bd788c34
CI / routing tests (ubuntu-latest) (push) Canceled after 0s
CI / routing tests (windows-latest) (push) Canceled after 0s
CI / shell script syntax check (push) Canceled after 0s
CI / field-journal leak scan (push) Canceled after 0s
CI / case contract test (ctf-demo) (push) Canceled after 0s
CI / version consistency (push) Canceled after 0s
macOS Bash compatibility / system Bash compatibility (push) Canceled after 0s
fix(workflow): carry transition decisions by delta (#113)
Co-authored-by: jhuang-tw <alr51307@gmail.com>
2026-08-22 14:10:08 +08:00

3.5 KiB
Raw Blame History

Timeline + WorkItem / Coverage

可回放作战记录(Z3r0 timeline 思想)+ 覆盖勾选(WorkItem 思想)。
全部落在 work/<case>/(仓库 gitignore),不进 skill 包正文。

目录约定

work/<case>/
  scope.md           # 契约(ops/scope-contract.md)
  timeline.md        # 追加写,禁止改历史条目
  workitems.md       # 工作项与覆盖
  evidence/          # 原始产物(截图、pcap、日志)
  notes/
  report/            # 最终报告草稿或拷贝

初始化:

powershell -File skills\scripts\case-init.ps1 -Hint "full pentest" -CaseName "acme-2026"

timeline.md 格式

每条记录 只追加:

## {ISO-8601} | {role} | {phase}
- action:
- command_or_ref:
- result_summary:
- artifacts: []      # relative paths under this case
- evidence_ids: []   # E-xxx when promoted
- decision_delta: [] # only decisions changed since the previous transition
- carry_forward_refs: [scope.md] # unchanged authoritative state is referenced, not re-serialized
- next:

MUST NOT 删除或改写已有 ## 时间块(更正用新条目 + corrects: {timestamp})。

Decision delta boundary

scope.md、workitems.md 与现有 Evidence 是当前 authoritative state。timeline.md 记录 transition,不复制完整 snapshot。

  • 每个真实 stage/turn transition MUST 写 decision_delta;只列从上一状态到当前状态真正改变、且会影响后续动作的 decision。没有变化时写 []。
  • 未改变的 route、auth、scope、network profile、tool capability、既有 hypothesis/Evidence MUST NOT 为了交接再次展开;放在 carry_forward_refs 中引用 authoritative 文件或条目。
  • consumer MUST 先解析 carry_forward_refs,再把 decision_delta 覆盖到工作上下文;不得把 delta 当成完整状态。
  • 只有存在两个或以上 materially different、evidence-supported 分支,且用户选择会改变下一动作时才是 genuine decision boundary;确定性 transition 直接继续,不为制造菜单而重述上下文。

代表性 transition:Triage -> Static 若 auth/scope/route 未变,只记录 decision_delta: [phase=triage->static],并以 carry_forward_refs: [scope.md, evidence/E-triage.md] 继承其余状态。

workitems.md 模板

# Work Items

| ID | title | role | targets | surface | status | evidence | notes |
|----|-------|------|---------|---------|--------|----------|-------|
| WI-001 | Port scan edge | cie | {ip} | network | done | E-001 | |
| WI-002 | Auth bypass check | cpe | /api/login | web | blocked | | need creds |

status: pending | in_progress | blocked | done | cancelled

## Coverage
- [ ] Recon complete for in_scope assets
- [ ] Critical/High candidates triaged
- [ ] Validated findings have Evidence
- [ ] Path documented (attack/call/solve)
- [ ] Timeline continuous (no silent gaps >1 major phase)
- [ ] Report exported via docs-generator
- [ ] field-journal written (anonymized)

attack-chain / pentest 挂钩

Skill MUST
attack-chain/ 多阶段任务创建 case 目录;每阶段结束更新 workitems + timeline
pentest-tools/ 每次工具跑批后至少 1 条 timeline;发现 → Evidence 草稿
其它 RE skill 建议 timeline;至少在出报告前补齐 Evidence 链

特色

  • Agent 友好的纯文本,diff/review 友好
  • 与 tool-index 命令路径可交叉引用
  • 不依赖 WebSocket 直播;需要时把 timeline 贴进报告即可