用途：让长周期的实现或研究项目在多次智能体会话之间保持可靠。核心做法是维护一小组持久化项目文件，使任何兼容的智能体都能在不依赖隐藏聊天上下文的情况下恢复工作。
主要能力与原则：一次只推进一个功能，除非用户明确要求并行；每个功能都记录在 feature_list.json 中；标记完成前必须运行该功能的测试/检查命令；保留人类可读的进度日志以便恢复；在环境与用户要求时提交有意义的检查点；优先使用可移植的文件与命令，而非特定宿主的斜杠命令。
脚手架文件（放在项目根目录）：feature_list.json 记录功能、优先级、状态与测试结果；init.sh / init.ps1 / init.py 为可选的启动脚本，Windows 原生优先用 init.ps1 或 init.py；agent-progress.md 记录按时间顺序的进度、决策、阻塞与下一步；CODING_STANDARDS.md 为可选的编码/测试/评审约定。若项目已有 claude-progress.txt 等 Claude 专用命名且用户依赖，可保留，但新项目建议用可移植的 agent-progress.md。
使用方式：初始化时确定项目目标、技术栈、默认测试命令与启动命令，创建 feature_list.json，按需创建可重复的引导脚本（Unix 用 init.sh，Windows 原生用 init.ps1 或 init.py，不要在 Windows 上强制要求 Bash），创建 agent-progress.md，仅在约定已知或被要求时创建 CODING_STANDARDS.md，并在安全时运行引导或测试命令。新增功能时追加对象，包含唯一顺序 ID（如 feat-001）、类别（functional、bugfix、refactor、research 或用户认可的其他类别）、优先级（数字越小优先级越高）、清晰描述与具体步骤、证明完成的测试/检查命令，初始 status 为 pending、passes 为 false。恢复会话时依次读取 feature_list.json、最近的 git 历史、agent-progress.md 或旧进度日志，选择优先级最高且状态非 completed 的功能，按宿主系统运行相应启动命令，安全时先跑基线测试再开始。完成功能前需确认产物存在、运行 test_command 或合理等价命令、记录简洁的 test_output，仅在成功时把 test_status 设为 passed，否则设为 failed 并保持 passes 为 false，更新 agent-progress.md，并按用户或项目策略提交。
文件模式研究脚手架：大型研究任务建议用文件模式而非聊天式交接。创建 data/<domain>/ 及 depth/ 子目录，在 data/<domain>/index.json 中跟踪运行状态与收敛情况，把研究拆成独立维度并分别写入 depth/<dimension>.json；若用户明确允许并行且宿主支持，工作进程只写 JSON 文件并回复 DONE，否则按顺序执行相同维度；随后把 depth 文件合并为主 JSON 数据文件，导出所需 CSV 表，再生成交付物，并在标记完成前校验 JSON/CSV/报告文件。可再生能源市场情报可使用 $renewable-market-research，它把该模式专门用于国家加技术研究及完整/精简报告生成。
feature_list.json 结构：包含 version、project、description、test_command、created 与 features 数组；每个功能含 id、category、priority、description、steps、test_command、test_status、test_output、status、passes。status 允许 pending、in_progress、blocked、completed；test_status 允许 pending、running、passed、failed、skipped，skipped 需在 test_output 中写明原因。
进度日志格式：按“## YYYY-MM-DD — feat-001 简短标题”追加条目，列出 Status、Changed、Validation（命令与结果摘要）、Decisions、Next。
宿主可移植性：Codex 按当前指令使用常规文件编辑、终端命令、计划更新与 git 提交；OpenClaw 保持相同项目文件，把该技能放在 OpenClaw 技能目录或工作区技能目录；Windows 原生优先 PowerShell（.ps1）或 Python（.py）启动/校验脚本，避免仅限 Bash 的 make.sh、sed、awk、chmod 或 Unix 路径假设；Claude Code 若存在旧式斜杠命令可使用，但不应依赖它们以保证可移植性。
限制：资料未提供具体收费、价格、平台支持范围或效果数据；使用前需自行确认宿主环境与命令安全性。