2.4 KiB
2.4 KiB
TODO — 可执行清单(按 P0→P2)
格式:
[ ] Px: <动作> | Verify: <验证手段> | Gate: <准入>
P0(必须先做,阻塞 CI/开发体验)
- P0: 应用补丁(落地修复) | Verify:
git apply --check assets/tasks/0001-repair-ci-lint-and-paths/patches/0001-fix-ci-lint-and-paths.patch| Gate: 输出OK - P0: 应用补丁(执行) | Verify:
git apply assets/tasks/0001-repair-ci-lint-and-paths/patches/0001-fix-ci-lint-and-paths.patch| Gate: ExitCode=0 - P0: 创建
.github/lint_config.json(最小放宽,保证可落地) | Verify:cat .github/lint_config.json| Gate: 文件存在且 JSON 可解析 - P0: 让
markdownlint --config .github/lint_config.json '**/*.md'退出 0 | Verify:markdownlint --config .github/lint_config.json '**/*.md'| Gate: ExitCode=0 - P0: 对齐本地
make lint与 CI(同 config + 同 glob) | Verify:make lint| Gate: ExitCode=0 且覆盖assets/** - P0: 修复
assets/config/.codex/README.md复制路径 | Verify:rg -n "cp -f config/\\.codex" assets/config/.codex/README.md || true| Gate: 无匹配 - P0: 修复
assets/skills/skills-skills/references/*.md旧示例路径 | Verify:rg -n "\\./skills/skills-skills" assets/skills/skills-skills/references -S || true| Gate: 无匹配
P1(清理迁移遗留,减少未来误操作)
- P1: 更新
.gitignore忽略assets/repo/backups/gz/| Verify:rg -n "^assets/repo/backups/gz/" .gitignore| Gate: 有匹配 - P1: 更新
.gitignore中旧路径skills/skills-skills/...| Verify:rg -n "skills/skills-skills/scripts/\\.venv-skill-seekers" .gitignore || true| Gate: 旧条目移除或替换为assets/skills/... - P1: 决定是否将 lint 范围排除
assets/repo/**(第三方镜像) | Verify:markdownlint --config .github/lint_config.json '**/*.md'| Gate: 无需改动第三方大量文件也能通过
P2(可选增强)
- P2: 为 lint/CI 策略写入“为什么这样配置”的注释/说明文档 | Verify:
rg -n "lint_config" -S README.md AGENTS.md .github/workflows/ci.yml| Gate: 维护者能读懂规则与边界 - P2: 增加一个最小 smoke 校验脚本(可选) | Verify:
bash -lc '<script>'| Gate: 一键复验不漏项
可并行(Parallelizable)
- P0 的“文档路径修复”与“gitignore 更新”可并行。
lint_config.json与Makefile对齐需串行(先定 config 再对齐命令)。