pflow-agents

用途：为当前项目生成或重写一份精简的 AGENTS.md，并将其同步为 CLAUDE.md，供 AI 编码代理读取项目规则。\n\n主要能力：\n1. 审计仓库。运行 .agents/skills/pflow-agents/scripts/agents-context.sh，获取 agents_md、claude_md、other_rule_files、nested_agent_files、docs、manifests、package_manager、task_runner、runner_targets、npm_scripts、composer_scripts、tooling、ci、monorepo、top_dirs、installed_skills、gitignored 等信息。\n2. 学习规则。阅读 .agents/skills/pflow-agents/references/agents-md-guide.md，并用其三项测试（可删除性、可推导性、重复性）检查每一行。\n3. 读取现有输入（现有 AGENTS.md、CLAUDE.md、其他规则文件、README、CONTRIBUTING、任务运行器与 CI 配置），目的不是照抄，而是了解已记录内容与真实命令名；不读整个代码库。\n\n使用方式：\n- 通过一次 AskUserQuestion 收集只有用户知道的事实，例如代理常犯错误、禁止编辑的目录、提交前必须通过的检查、无工具强制的约定、monorepo 是否需要每个包的 AGENTS.md（本技能只写根文件）；提供“nothing / skip”选项。\n- 按指南结构起草，不超过 60 行，每条为祈使句、具体、单一指令，含确切命令或路径。\n- 通过一次非交互 Bash 调用写入：\n.agents/skills/pflow-agents/scripts/agents-finalize.sh --overwrite <<'PFLOW_AGENTS_EOF'\n<完整 AGENTS.md Markdown>\n__PFLOW_AGENTS_EOF__\n默认 --claude copy 将 AGENTS.md 复制为 CLAUDE.md；用户偏好单行 @AGENTS.md 导入时用 --claude import；不修改 CLAUDE.md 用 --claude none。仅在已读取现有文件时加 --overwrite。\n\n限制与注意事项：若 agents-context.sh 或 agents-finalize.sh 失败（非零退出或 JSON 中 status":"error"），打印 ⚠️ <error.message> 并停止；finalize 的 lint 错误例外，可删行重试最多 2 次。其他失败命令视为发现项，报告后继续。claude_md.kind 为 symlink 或 import 时，保持该模式（symlink 用 --claude none，import 用 --claude import），除非用户要求复制。gitignored 中若包含 AGENTS.md/CLAUDE.md 需告知用户，共享文件应提交。不要写项目概览、技术栈列表或目录树。其他规则文件保持不动，若重复可建议改为指向 AGENTS.md。最终报告行数、CLAUDE.md 结果、删除的行与剩余警告，但不回显文件内容。