Codex 怎么用进长期项目：从项目规则到可复用 Skills

README.md
本项目只把 data/week.json 转为 output/week.md。
从项目根目录运行 node scripts/report.mjs。
输入状态仅允许 done、in_progress；不把进行中写成完成。

AGENTS.md
# 项目规则
- 读取 README.md 与 data/week.json，未经本次明确要求不修改输入。
- 只允许脚本写 output/week.md，不安装依赖、不访问外部服务。
- 运行后核对完成与进行中项的 ID，报告未验证内容。
- 规则是任务约束；文件权限仍由客户端和操作系统控制。

data/week.json
[
  {"id":"W1","task":"修正登录空密码提示","status":"done"},
  {"id":"W2","task":"移动端回归","status":"in_progress"},
  {"id":"W3","task":"整理字段说明","status":"done"}
]

report-template.md
# 本周进展
## 已完成
（仅 done 项，保留 ID）
## 进行中
（仅 in_progress 项，保留 ID）

scripts/report.mjs
import fs from 'node:fs';
const rows = JSON.parse(fs.readFileSync('data/week.json', 'utf8'));
if (!Array.isArray(rows) || rows.some(r => !r.id || !r.task || !['done','in_progress'].includes(r.status))) {
  throw new Error('输入缺字段或状态无效');
}
if (new Set(rows.map(r => r.id)).size !== rows.length) throw new Error('ID重复');
const section = status => rows.filter(r => r.status === status).map(r => '- ' + r.id + '：' + r.task).join('\n') || '- 无';
const text = '# 本周进展\n\n## 已完成\n' + section('done') + '\n\n## 进行中\n' + section('in_progress') + '\n';
fs.mkdirSync('output', { recursive: true });
fs.writeFileSync('output/week.md', text);
console.log('done=' + rows.filter(r=>r.status==='done').length + ', in_progress=' + rows.filter(r=>r.status==='in_progress').length);

第一轮提示
只读这个练习目录，解释输入、规则、写入位置与统计方法；不修改文件，不执行脚本。
预期回答应指出 W1/W3 完成，W2 进行中，以及 output/week.md 是唯一写入目标。

第二轮提示
允许运行 node scripts/report.mjs。完成后读取 output/week.md，逐项与输入对账，确认 data/week.json 未变；列实际命令与结果。

预期终端
done=2, in_progress=1

预期 output/week.md
# 本周进展
## 已完成
- W1：修正登录空密码提示
- W3：整理字段说明
## 进行中
- W2：移动端回归

复跑
在这个练习副本中把 W2 改为 done，再运行相同命令。
预期 done=3, in_progress=0；报告“进行中”为“无”。
若脚本失败，保留错误，不改写输入凑出成功结果。

将稳定流程封装为本地 Skill
在项目根目录创建 .agents/skills/weekly-summary/SKILL.md：
---
name: weekly-summary
description: 根据本项目 data/week.json 生成已完成与进行中周报；用于重复周报，不用于推测缺失工作记录。
---
先读根目录 AGENTS.md、README.md 和 report-template.md。
检查 data/week.json 的必填字段、唯一 ID 与状态；异常时说明具体行，不猜。
在项目根运行 node scripts/report.mjs，仅写 output/week.md。
读取输出，逐项核对 ID 与状态，报告实际命令、结果和未验证项。

在 Codex CLI 输入 /skills 查是否发现，再明确说：
使用 $weekly-summary 处理本练习目录，保持输入不变。
若未出现，先核对目录与 SKILL.md，再按当前官方文档刷新或重启客户端。